随着 AI 编程工具从「代码补全」走向「自主执行任务」,我们正在进入 AI Agent Coding 的阶段。
在 Cursor、Claude Code 等工具逐渐封闭、商业化的背景下,OpenCode 提供了一条完全不同的路线:
开源、隐私优先、多模型、多入口、终端友好
这篇文章将从定位、核心设计、使用方式、进阶能力几个层面,系统介绍 OpenCode 这款工具。
一、OpenCode 是什么?
OpenCode 是一个开源的 AI 编程代理(AI Coding Agent),可以在以下多种形态中使用:
- 终端 TUI(Text UI)
- 桌面应用(Desktop App)
- IDE 插件(VS Code / Cursor / Windsurf / Zed 等)
- CLI / Headless / Web 模式
它的核心目标不是“写几行代码”,而是:
让 AI 理解你的代码库,并以 Agent 的方式完成真实的软件工程任务
核心定位
- 完全开源:代码托管在 GitHub,可审计、可二次开发
- 隐私优先:支持本地模型,不强制上传代码
- 多模型支持:75+ LLM 提供商(含免费模型)
- 多使用场景:终端、桌面、IDE、自动化脚本
目前 OpenCode 在 GitHub 上已拥有 50k+ Star,月活开发者规模超过 65 万,在开源 AI 编码工具中非常活跃。
官方地址:
https://opencode.ai/
二、为什么 OpenCode 值得关注?
如果只看功能列表,OpenCode 似乎和 Cursor、Claude Code 很像,但它在设计理念上有几个非常重要的差异。
1️⃣ Agent,而不是「聊天 IDE」
OpenCode 更像是一个:
可以读代码、写代码、跑命令、做决策的工程 Agent
而不是一个“对话式编辑器”。
你只需要告诉它:
- 做什么
- 在哪个项目
- 是否允许执行
至于“怎么写代码”,是 AI 的事情。
2️⃣ Plan / Build 双模式(非常关键)
这是 OpenCode 最值得学习的设计之一。
Plan 模式(规划模式)
- 只读权限
- 不能修改文件
- 不能执行危险命令
适合做:
- 理解项目结构
- 拆解复杂需求
- 生成实现方案
- Review 变更计划
Build 模式(执行模式)
- 完整权限
- 可修改文件
- 可运行 Shell / 测试 / 构建
官方推荐流程是:
Plan → 确认方案 → Build → 执行 → 验证
这极大降低了 AI 一上来乱改代码 的风险。
3️⃣ AGENTS.md:项目级上下文中枢
执行 /init 后,OpenCode 会:
- 扫描你的项目结构
- 分析配置与依赖
- 自动生成 AGENTS.md
这个文件本质上是:
给 AI Agent 用的项目说明书
你可以在里面补充:
- 技术栈
- 编码规范
- 目录职责
- 常见坑位
效果非常明显,尤其在中大型项目中。
三、使用方式全景
OpenCode 几乎覆盖了所有开发者习惯的入口。
1️⃣ 桌面应用(最友好)
适合新手或不想折腾终端的用户。
- 下载:https://opencode.ai/download
- 支持 macOS / Windows / Linux
- 内置多个免费模型
包括但不限于:
- GPT-5 Nano
- GLM-4.7
- MiniMax M2.1
- Grok Code Fast 1
桌面端的交互方式非常接近 Cursor 的 Agent 模式:
只对话,不直接编辑代码,所有变更由 AI 自动完成。
2️⃣ IDE 插件(开发者首选)
支持:
- VS Code
- Cursor
- Windsurf
- Zed
- VSCodium
安装后,在 IDE 的终端中直接运行:
opencode
即可进入 Agent 交互模式,所有操作与 TUI 一致。
3️⃣ TUI(终端图形界面)
这是 OpenCode 的“灵魂形态”。
安装方式
curl -fsSL https://opencode.ai/install | bash
或:
npm install -g opencode-ai
启动
opencode
你将进入一个完整的终端 UI,包括:
- 对话区
- 工具执行区
- 文件变更记录
- 上下文统计
四、模型与 OpenCode Zen
多模型支持
OpenCode 支持:
- OpenAI
- Anthropic
- GitHub Copilot
- 智谱 AI
- MiniMax
- 本地模型(Llama 等)
你可以随时 /connect 切换模型。
OpenCode Zen(强烈推荐)
Zen 是官方维护的一组“稳定、经过验证”的模型集合。
优点:
- 开箱即用
- 提供免费模型
- 避免模型质量不稳定的问题
适合新手和追求稳定输出的团队。
五、Slash 命令与日常效率
OpenCode 的 TUI 通过 / 命令进行控制,常用的包括:
/init:初始化项目(非常重要)/model:切换模型/review:代码审查/open:打开文件预览/undo//redo:回滚变更(依赖 Git)/compact:压缩会话,节省上下文/terminal:显示/隐藏终端
再配合:
@文件路径引用代码- 图片上传(UI 稿 / 架构图)
基本可以覆盖日常 80% 的开发协作场景。
六、CLI 与自动化能力
OpenCode 不只是交互工具,它也非常适合自动化。
例如:
opencode run "fix lint errors"
或:
opencode -p "生成项目 README"
还支持:
opencode serve:Headless 服务opencode stats:Token / 成本统计opencode web:浏览器 UI
这使得它可以进入 CI / 脚本 / DevOps 场景。
七、进阶生态:oh-my-opencode
如果你觉得一个 Agent 不够用,可以关注 oh-my-opencode。
它做了几件很激进的事:
- 多智能体协作
- 任务并行执行
- 自动模型调度
- MCP / LSP / AST 深度集成
通过关键词(如 ultrawork),即可触发完整自动化流水线。
这是典型的 “Agent on Agent” 思路,非常前沿。
八、适合谁使用?
我会推荐给以下人群:
- 全栈 / 独立开发者:需要频繁切换上下文
- 开源项目维护者:代码 Review、重构、文档生成
- DevOps / Infra 工程师:CLI + 自动化友好
- 隐私敏感团队:不接受代码强制上云
使用建议
- 新手:直接从 OpenCode Zen + 桌面端 开始
- 进阶用户:TUI + Plan/Build 工作流
- 自动化场景:CLI / serve 模式
九、总结
OpenCode 并不是“另一个 Copilot”,它更像是:
一个真正理解工程语境的 AI 合作者
在当前 AI 编程工具普遍走向封闭和订阅制的环境下,OpenCode 提供了一种开放、可控、可进化的可能性。
如果你正在寻找一个:
- 不绑定厂商
- 不限制模型
- 不牺牲工程控制权
的 AI 编程工具,OpenCode 非常值得深入尝试。
参考链接
文章评论