opencode常用命令

王致远

2026/08/07

1. 会话类

/new 开启新对话
/sessions 切换会话(项目空间内)
/undo /redo 撤销/重做
/compact 压缩上下文
/export 
/export 导出对话为markdown
/share 分享
/exit /q 退出

2. 模型类

/models 列出可用模型
/connect 链接模型提供商,添加provider和API key
/thinking 切换思考过程显示
/details 切换工具执行细节

3. 记忆类

/init 引导创建或更新 AGENTS.md

4. 外观类

/themes 切换主题

5. Skills

opencode 的 skill 是”按需加载的可复用指令”。介绍如下:

安装(本质是放文件) skill 就是一个目录里放一个 SKILL.md,放入以下位置之一:

项目级:.opencode/skills/<名字>/SKILL.md 全局:~/.config/opencode/skills/<名字>/SKILL.md 兼容位置:.claude/skills/<名字>/SKILL.md、.agents/skills/<名字>/SKILL.md SKILL.md 格式 必须带 YAML frontmatter,只有这些字段有效:

---
name: git-release
description: Create consistent releases and changelogs
license: MIT
metadata:
  audience: maintainers
---

## What I do
- 具体的操作步骤...
## When to use me
- 何时触发这个 skill...
注意事项

使用方式 agent 通过内置 skill 工具按需加载(不是自动注入),看到 name+description 列表后调用加载。

{
  "permission": {
    "skill": { "*": "allow", "pr-review": "allow", "internal-*": "deny" }
  }
}

allow 直接加载 / deny 隐藏拒绝 / ask 每次询问

加载不了时排查:检查 SKILL.md 大小写、frontmatter 是否完整、名字是否全局唯一、是否被权限 deny。

Skills会自动调用,无需刻意提出。skill 是”按需加载”机制:

opencode 启动时只扫描所有 skill 的 name + description 注入到 skill 工具的说明里(不加载全文) 你输入描述后,agent 根据上下文自主判断哪个 skill 匹配,然后通过 skill 工具调用加载全文 所以正常描述需求即可,只要 description 写得准确,agent 会自动选对。刻意点名反而可能不是最优。