OpenCode提供内置和可自定义的斜杠命令系统,使用 / 前缀触发。
内置命令
| 命令 | 功能 | 快捷键 |
|---|---|---|
/connect | 添加提供商认证 | — |
/init | 初始化项目(创建AGENTS.md) | — |
/compact | 压缩会话上下文 | ctrl+x c |
/details | 切换工具执行详情 | ctrl+x d |
/editor | 打开外部编辑器 | ctrl+x e |
/export | 导出会话为Markdown | ctrl+x x |
/models | 列出/切换模型 | ctrl+x m |
/new | 开始新会话 | ctrl+x n |
/sessions | 管理会话列表 | ctrl+x l |
/share | 分享会话链接 | ctrl+x s |
/undo | 撤销最后更改 | ctrl+x u |
/redo | 重做更改 | ctrl+x r |
/help | 显示帮助 | — |
/theme | 切换主题 | ctrl+x t |
创建自定义命令
方法一:Markdown文件
在 .opencode/commands/ 目录创建 .md 文件:
# .opencode/commands/review.md
---
description: 代码审查
agent: review
model: anthropic/claude-sonnet-4-20250514
---
请审查以下代码更改,检查:
- 代码质量和最佳实践
- 潜在的bug和安全问题
- 性能优化建议
$ARGUMENTS
方法二:JSON配置
{
"command": {
"test": {
"template": "运行项目测试并报告结果",
"description": "运行测试"
},
"commit": {
"template": "查看git diff并生成commit message: $ARGUMENTS",
"description": "生成commit"
}
}
}
命令模板变量
| 变量 | 说明 |
|---|---|
$ARGUMENTS | 命令后的所有参数 |
$1, $2, $3... | 单独的参数 |
!`command` | 注入bash命令输出 |
@filename | 包含文件内容 |
命令配置选项
| 选项 | 说明 |
|---|---|
template | 提示词模板(必需) |
description | TUI中显示的描述 |
agent | 指定执行的代理 |
model | 覆盖默认模型 |
subtask | 强制使用子代理 |
使用示例
# 使用自定义命令
/review src/main.js
# 带参数的命令
/commit "修复登录bug"
# 内置命令
/init
/share
提示
自定义命令可以覆盖同名的内置命令。
下一步
接下来了解OpenCode的快捷键系统。