4.2 斜杠命令

OpenCode提供内置和可自定义的斜杠命令系统,使用 / 前缀触发。

内置命令

命令功能快捷键
/connect添加提供商认证
/init初始化项目(创建AGENTS.md)
/compact压缩会话上下文ctrl+x c
/details切换工具执行详情ctrl+x d
/editor打开外部编辑器ctrl+x e
/export导出会话为Markdownctrl+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提示词模板(必需)
descriptionTUI中显示的描述
agent指定执行的代理
model覆盖默认模型
subtask强制使用子代理

使用示例

# 使用自定义命令
/review src/main.js

# 带参数的命令
/commit "修复登录bug"

# 内置命令
/init
/share
提示
自定义命令可以覆盖同名的内置命令。

下一步

接下来了解OpenCode的快捷键系统。