OpenCode 指令速查表

最后更新：2026-03-10 | 官方文档：https://opencode.ai/docs
提示: opencode run 运行非交互模式 | @filename 引用文件加入上下文 | !cmd 执行 shell 命令 | Leader 键默认设为 ctrl+x
键盘快捷键 (TUI)
Leader 键 (先按 ctrl+x)
ctrl+x h帮助 / 命令列表
ctrl+x n新建会话
ctrl+x l会话列表
ctrl+x m模型选择
ctrl+x aAgent 选择
ctrl+x c压缩上下文
ctrl+x s状态视图/分享会话
ctrl+x u / r撤销 / 重做
ctrl+x e打开外部编辑器
ctrl+x x导出对话
ctrl+x d切换工具详情
ctrl+x q退出
ctrl+x i初始化 AGENTS.md
消息导航
pgup / pgdn向上/向下翻页
ctrl+alt+y / e单行滚动
ctrl+g / home跳到顶部
输入与切换
enter发送消息
shift+enter输入换行
ctrl+c清空输入/中断响应
tab切换Agent(Build/Plan)
f2循环切换模型
ctrl+p打开命令面板
斜杠命令 (TUI 内部)
会话与控制
/new 或 /clear开启新会话
/sessions查看并切换会话
/compact压缩当前会话上下文
/details切换工具执行详情
/thinking切换思维链显示
/undo撤销消息及文件改动
/redo重做已撤销的消息
配置与外部交互
/connect配置 API Key/Provider
/models列出可用模型
/init创建/更新 AGENTS.md
/editor用外部编辑器写消息
/export导出会话为 Markdown
/share分享当前会话生成链接
/unshare取消分享
/themes列出可用主题
/help显示帮助
/exit 或 /q退出 OpenCode
特殊语法 (直接输入)
@filename引用文件(模糊搜索)
!ls -la执行 Shell 命令
基本启动与运行模式
启动交互式 TUI
opencode启动当前目录
opencode /path/to/project启动指定目录
opencode -c继续上次会话
opencode -s <sessionID>继续指定会话
opencode -m anthropic/claude-sonnet-4-5指定模型启动
非交互模式 (run)
opencode run "提问"单次执行
opencode run -f file.txt "附加文件"附加文件
opencode run --share "运行并分享会话"运行并分享
opencode run --format json "输出原始 JSON 事件"JSON 格式输出
服务端模式 (Client/Server)
opencode serve启动无头API服务器
opencode web启动Web版界面
附加参数: --port 4096 --hostname 0.0.0.0
opencode attach <url>附加到远程/后台
资源与扩展管理
Auth & Models (认证与模型)
opencode auth login配置 API Key
opencode auth ls列出凭证
opencode models列出所有模型
opencode models -v显示费率与元数据
Sessions & Stats (会话与统计)
opencode session ls列出所有会话
opencode export导出会话JSON
opencode import <f>从文件/链接导入
opencode stats查看 Token 及费用
MCP 服务器管理
opencode mcp add添加MCP(向导式)
opencode mcp ls列出并显状态
opencode mcp authOAuth MCP 认证
Agent & GitHub
opencode agent ls列出可用 Agent
opencode github run在 CI/CD 中运行
配置与文件层级
配置合并生效，优先级由低到高（项目级覆盖全局）：
1. .well-known/opencode组织级默认
2. ~/.config/opencode/全局用户级
3. $OPENCODE_CONFIG自定义路径
4. ./opencode.json项目级 (最高)
核心文件类型
opencode.json主配置文件
tui.json界面与快捷键配置
auth.json密钥安全存储
AGENTS.md项目级提示词规范
自定义目录结构 (.opencode/)
agents/ commands/ plugins/
skills/ tools/ themes/
环境变量
基础配置
OPENCODE_CONFIG指定配置路径
OPENCODE_AUTO_SHARE自动分享会话
OPENCODE_SERVER_PORT指定服务端口
禁用开关 (DISABLE_)
OPENCODE_DISABLE_AUTOUPDATE禁用自动更新
OPENCODE_DISABLE_AUTOCOMPACT禁用自动压缩
OPENCODE_DISABLE_CLAUDE_CODE不读取.claude
实验性功能 (EXPERIMENTAL_)
OPENCODE_EXPERIMENTAL启用所有实验功能
OPENCODE_EXPERIMENTAL_PLAN_MODE启用 Plan 模式
OPENCODE_EXPERIMENTAL_LSP_TOOL启用 LSP 增强
OPENCODE_EXPERIMENTAL_FILEWATCHER全目录文件监听
安装与工作流
安装与升级
curl -fsSL https://opencode.ai/install | bash
npm install -g opencode-ai
brew install anomalyco/tap/opencode
opencode upgrade升级至最新
opencode uninstall -f强力卸载
典型场景与工作流
场景 1: 批量非交互脚本执行
opencode serve &
opencode run --attach http://localhost:4096 "写单测"
opencode run --attach http://localhost:4096 "检查风格"
场景 2: 撤销 AI 错误改动
若生成不如意，输入 /undo (或 ctrl+x u) 即可恢复文件到生成前状态。
场景 3: 节省 Token
定期使用 /compact 压缩历史，或配置 compaction.auto = true。
全局标志 (Global Flags)
-h, --help显示帮助
-v, --version打印版本号
--print-logs日志输出到 stderr
--log-level <lv>DEBUG/INFO/WARN/ERROR

为您的灵感插上代码的翅膀 · 快捷键速查尽在掌握