OpenCode CLI 速查表

⌨️ TUI 输入与 Leader

消息里

@文件模糊引用工作区文件，内容自动加入对话

!cmd 行首 ! 执行 shell，输出作为工具结果

Leader 键

默认 CtrlX 为 leader；可在 tui.json 的 keybinds.leader 修改

CtrlT 在支持的模型上循环变体（含思考/推理开关相关）

Leader Chord（先按 Leader 再按）

C /compact 压缩会话

D /details 切换工具执行详情

E /editor 外部编辑器（$EDITOR）

H /help

I /init 生成/更新 AGENTS.md

L /sessions 列表与切换

M /models

N /new 新会话

Q /exit

R /redo（需先有 /undo）

S /share

T /themes

U /undo（Git 仓库内可回滚文件变更）

X /export 导出为 Markdown 并打开编辑器

🔌 MCP · ACP · GitHub

MCP

mcp add 交互添加本地或远程 MCP

mcp list 已配置服务器与连接状态（mcp ls）

mcp auth OAuth；mcp auth list / mcp auth ls

mcp logout [name] 清除 OAuth

mcp debug <name> 调试 OAuth

ACP

opencode acp stdin/stdout nd-JSON；--cwd --port --hostname

GitHub

github install 仓库内安装 Actions 工作流

github run Actions 内调用；--event --token

⚡ 斜杠命令（TUI）

连接与界面

/connect 添加 provider 与 API Key

/compact 别名 /summarize

/details 工具执行详情开关

/thinking 是否显示思考块（显示层，非改模型能力）

/themes 主题列表

编辑与导出

/editor 外部编辑器撰写消息

/export 当前对话导出 MD 并打开编辑器

会话

/new 别名 /clear

/sessions 别名 /resume、/continue

/share 分享当前会话

/unshare 取消分享

模型与撤销

/models 列出可用模型

/init 创建/更新 AGENTS.md

/undo 撤销末条用户消息及后续与文件改动（需 Git）

/redo 在 /undo 后重做

其它

/help 帮助面板（同 CtrlX H）

/exit 别名 /quit、/q

📁 规则与自定义命令

规则

AGENTS.md 项目规则；/init 可生成/更新

.claude 默认可读 CLAUDE.md 与 skills；可用 OPENCODE_DISABLE_CLAUDE_CODE* 关闭

自定义斜杠

.opencode/commands/ 项目内 *.md，frontmatter + 模板

~/.config/opencode/commands/ 全局命令目录

config.command opencode.json 内 JSON 定义同名命令

占位符 $ARGUMENTS、$1…；模板内 !`cmd` 注入 shell 输出

🧠 运行 · 服务 · 会话

TUI 启动（隐式 tui）

-c / --continue 接续上次会话

-s / --session 指定会话 ID

--fork 与上两项连用时分叉会话

--prompt 初始提示

-m / --model provider/model

--agent 指定 agent

--port / --hostname 监听地址（TUI 侧）

run（非交互）

opencode run … 脚本/自动化；-c -s --fork -m --agent

-f / --file 附加文件

--format 默认美化或 json 原始事件

--attach 连到已运行 serve，避免 MCP 冷启动

--share / --title 分享会话、会话标题

serve · web · attach

serve 无头 HTTP API；OPENCODE_SERVER_PASSWORD 基本认证

web 无头服务并打开浏览器 UI

attach URL TUI 挂远程后端；--dir -s

session · 导入导出 · 统计

session list -n 条数；--format table/json

export [sessionID] 导出 JSON

import 本地 JSON 或分享 URL

stats --days --tools --models --project

⚙️ 配置与环境

配置文件

opencode.json 运行时/服务器；见 config

tui.json(c) 主题、keybinds、滚动、diff_style

OPENCODE_TUI_CONFIG 自定义 TUI 配置路径

常用环境变量

OPENCODE_CONFIG 配置文件路径

OPENCODE_CONFIG_DIR 配置目录

OPENCODE_SERVER_* PASSWORD / USERNAME（默认用户 opencode）

OPENCODE_AUTO_SHARE 自动分享会话

OPENCODE_MODELS_URL 自定义模型清单 URL

auth

auth login 配置各 provider Key

auth list / ls 已登录 provider

auth logout 清除凭证

🔧 Agent · 模型

agent

agent create 交互创建自定义 agent

agent list 列出可用 agent

models

models [provider] 过滤；输出 provider/model

--refresh 从 models.dev 刷新缓存

--verbose 含成本等元数据

🖥️ CLI 其它

全局

-h / --help 帮助

-v / --version 版本

--print-logs 日志到 stderr

--log-level DEBUG / INFO / WARN / ERROR

维护

upgrade [target]；-m curl/npm/pnpm/bun/brew

uninstall --keep-config --keep-data --dry-run --force