跳至主要內容

OpenCode

LiuMangMang2026/3/6大约 3 分钟AI开发工具OpenCodeCLIAI编程

OpenCode

这篇文章基于 OpenCode 官方文档的 CLI 章节，整理出一套更偏实战的
使用方式：先跑起来，再把它接入日常开发流程。

一、先有一个可用的 OpenCode CLI

OpenCode 在不带参数运行时会进入 TUI（终端交互界面）：

opencode

如果你只想快速问一个问题，不进 TUI，直接用 run：

opencode run "解释一下 Go 的 context 使用场景"

这两个入口就够你先开始：

  • opencode：适合持续交互、改代码、看上下文。
  • opencode run ...：适合脚本、自动化、一次性问答。

二、我最常用的 CLI 命令

2.1 会话与续接

# 继续上一次会话
opencode -c

# 指定会话 ID 继续
opencode -s <session-id>

# 在继续时分叉一个新分支会话
opencode -c --fork

当你在做“同一任务的不同方案”时，--fork 非常好用。

2.2 非交互执行（脚本友好）

# 一次性执行
opencode run "为当前仓库生成提交说明"

# 继续历史会话执行
opencode run -c "继续刚才的重构任务"

# 指定模型
opencode run -m anthropic/claude-sonnet-4 "审查这次变更"

# 附件文件
opencode run -f README.md "总结这份文档"

2.3 模型与认证

# 登录模型提供商（会写入本地凭据文件）
opencode auth login

# 查看已登录提供商
opencode auth ls

# 查看可用模型
opencode models

# 刷新模型缓存
opencode models --refresh

2.4 MCP 相关

# 添加 MCP 服务
opencode mcp add

# 查看 MCP 列表和状态
opencode mcp ls

# OAuth 认证
opencode mcp auth

如果你把外部工具接到 OpenCode，MCP 是关键路径。

三、一个顺手的工作流（推荐）

我现在更常用这套顺序：

  1. opencode 进入 TUI，先理解项目结构。
  2. 用自然语言给任务边界（目标、限制、验收）。
  3. 小步执行：每次只改一类问题。
  4. 关键节点用 session list 记录上下文。
  5. 需要批处理时切到 opencode run。

相关命令：

# 查看会话
opencode session list

# 导出会话（便于复盘）
opencode export <session-id>

# 从 JSON 或分享链接导入
opencode import <file-or-url>

四、服务化与远程连接

当你希望“一个后端 + 多端连接”时：

# 启动无界面服务
opencode serve

# 启动 web 版本
opencode web --port 4096 --hostname 0.0.0.0

# 其他终端附着到服务
opencode attach http://127.0.0.1:4096

这样可以减少重复冷启动，尤其是 MCP 场景更明显。

五、几个高频实用命令

# 统计 token 和费用
opencode stats --days 7 --models 5

# 查看全局帮助
opencode -h

# 查看版本
opencode -v

# 升级
opencode upgrade

卸载前建议先 dry run：

opencode uninstall --dry-run

六、环境变量里最值得记住的几个

# 为 serve / web 打开基础认证
export OPENCODE_SERVER_PASSWORD="your-password"

# 指定配置目录
export OPENCODE_CONFIG_DIR="$HOME/.config/opencode"

# 关闭自动更新检查
export OPENCODE_DISABLE_AUTOUPDATE=true

# 启用实验特性总开关
export OPENCODE_EXPERIMENTAL=true

建议：实验变量只在测试环境开，不要直接进生产脚本。

七、踩坑提醒

  1. run 很方便，但复杂任务建议先进 TUI 再拆步骤。
  2. 多提供商混用时，模型名要写 provider/model 全名。
  3. serve / web 对外开放时，优先配 OPENCODE_SERVER_PASSWORD。
  4. MCP 连接异常先看 opencode mcp ls 和 opencode mcp debug <name>。

八、结语

如果你是第一次用 OpenCode，先记住三条就够了：

  • opencode：主入口（交互式）。
  • opencode run：自动化入口（非交互）。
  • opencode auth login + opencode models：先把模型链路打通。

后面再逐步接入 MCP、会话导入导出、以及 serve/web 的多端协作。

参考文档：
https://opencode.ai/docs/zh-cn/cli/

贡献者: mangmang