· 5 min read
OpenCode 是当前最值得认真看的一款开源 AI 编程 Agent。
- 定位:100% 开源的 AI 编程终端,跟 Claude Code、Codex CLI 同台对位
- 双主代理:内置
build(写)和plan(只读),Tab 键切换 - 子代理机制:复杂搜索 / 多步任务交给
@general子代理 - 多端入口:终端、桌面 App 、IDE 插件一套命令通吃
- 选型结论:想换模型就选 OpenCode,锁定 Claude 就用 Claude Code
OpenCode 是当前最值得认真看的一款开源 AI 编程 Agent。
build(写)和 plan(只读),Tab 键切换@general 子代理量化系统的本质是 5 个模型协同的流水线,5 个里 4 个都是"负面因素"。
OpenCode 的配置和 1M 上下文模型是两个最容易踩坑的地方——一个是 schema 字段没文档,一个是变体名写错直接走默认。
opencode.json / opencode.jsonc 主配置 + tui.json TUI 专属,schema URL 是 opencode.ai/config.json。[1m] 后缀,比如 anthropic/claude-sonnet-4-6[1m],Anthropic 官方约定。OpenCode 里两个最高频的快捷语法——@path 拉文件、!cmd 跑 shell。看着简单,踩坑的姿势不少。
@ 引用文件:@src/components/Button.tsx 自动把文件读进上下文,比手动复制路径再让 OpenCode 读快得多。! 调用 Shell:!ls -la src/ 在 OpenCode 里直接跑命令,输出回传到对话里。head / Grep -n 截取 再 @。!pnpm test 看测试输出、!git status 看状态、!ps aux | grep node 查进程。@ 是"读进来作为上下文",! 是"执行命令拿到结果"——前者进了历史,后者也是。OpenCode 命令体系 纯 markdown 驱动,工作流可沉淀成可复用命令——零代码扩展,迁过来上手成本低。
/init / /compact / /clear / /undo,覆盖会话生命周期。.opencode/command/*.md 放 markdown 即生效,业务团队也能贡献。/init → 改 AGENTS.md → 写专属命令;改 Bug 走 /undo 兜底。opencode upgrade,跨大版本前看 CHANGELOG。