一句话总结OpenCode 是一款 MIT 协议开源的终端 AI 编程助手支持 75 大模型接入提供 Plan/Build 双模式工作流GitHub Star 突破 16.8 万是国内开发者目前可直接使用的高性价比 AI 编程方案之一。OpenCode 是什么为什么值得关注OpenCode 由 anomalyco 团队于 2025 年底开源定位为终端原生的 AI 编程代理Coding Agent。它不是简单的代码补全工具而是能理解整个代码仓库、自主执行多文件编辑、运行终端命令的智能体。截至 2026 年 6 月最新版本为 v1.16.0GitHub Star 数约 16.8 万Fork 数超 2 万月活开发者超过 150 万。与 Cursor、GitHub Copilot 等商业工具相比OpenCode 的核心差异在于完全开源MIT 协议、代码不离开本地、支持 75 模型自由切换。对于注重数据隐私和成本控制的国内开发者而言这是一个值得重点关注的选项。环境准备与安装安装 OpenCode 前需要确认系统环境满足基本要求。整体流程约 5-10 分钟可完成。系统要求项目要求操作系统Windows 10推荐 WSL、macOS 12、Linux 主流发行版Node.jsv20 LTS 或更高版本推荐 v22 LTS磁盘空间约 200MB不含模型缓存终端支持 UTF-8 的终端模拟器四种安装方式方式一npm 全局安装推荐bashbashnpm install -g opencode/clibashnpm install -g opencode/cli方式二macOS / Linux 使用 Homebrewbashbashbrew install opencodebashbrew install opencode方式三Windows 使用 Scoopbashbashscoop install opencodebashscoop install opencode方式四从源码编译bashbashgit clone https://github.com/anomalyco/opencode.git cd opencode npm install npm linkbashgit clone https://github.com/anomalyco/opencode.git cd opencode npm install npm link安装完成后执行opencode --version显示版本号即表示安装成功。Windows 用户特别说明OpenCode 原生对 Windows 的支持持续改善目前已支持 Windows ARM64 架构。推荐方案是通过 WSLWindows Subsystem for Linux运行兼容性和性能表现更佳。也可使用 Scoop 或 npm 直接安装。模型接入配置OpenCode 支持 75 种大语言模型提供商这是它区别于封闭工具的核心优势。配置过程通过/connect命令或配置文件完成。配置文件方式在项目根目录创建.opencode.json文件jsonjson{ api: { baseUrl: https://your-api-endpoint.com/v1, apiKey: your-api-key, model: deepseek-chat } }json{ api: { baseUrl: https://your-api-endpoint.com/v1, apiKey: your-api-key, model: deepseek-chat } }国内可直连的模型推荐模型特点免费额度延迟国内实测DeepSeek V3性价比高中文能力强目前提供免费额度约 0.8-1.5 秒智谱 GLM-4国内直访稳定性好目前提供免费额度约 0.6-1.2 秒Kimi API长上下文支持128K有限免费额度约 1.0-2.0 秒通义千问阿里云生态企业级有限免费额度约 0.5-1.0 秒建议初次使用从 DeepSeek 或智谱 GLM-4 开始两者目前均提供免费额度注册后即可获取 API Key。交互式配置启动 OpenCode 后输入/connect命令按提示依次填入 API 地址、Key 和模型名称即可完成连接。这种方式适合不想手动编辑配置文件的用户。Plan/Build 双模式详解这是 OpenCode 的标志性设计也是它与多数 AI 编程工具的核心区别。通过Tab键可在两种模式间快速切换。Plan 模式只看不动Plan 模式下AI 只分析需求、拆解任务、输出执行方案不会修改任何文件。适合以下场景复杂功能的架构设计代码审查与优化建议Bug 根因分析重构方案评估Build 模式说干就干Build 模式下AI 会按方案实际创建、修改文件执行终端命令。适合按已确认的方案编写代码日常编码与 Bug 修复批量文件操作自动化脚本执行推荐工作流先 Plan 后 Build 的流程实测可减少约 35%-40% 的返工率。具体步骤1.在 Plan 模式描述需求让 AI 输出方案2.审查方案必要时追问或调整3.确认无误后按 Tab 切换到 Build 模式4.AI 按方案逐步执行每步展示 diff核心命令速查OpenCode 的命令体系分为斜杠命令和快捷键两类。以下是日常使用频率较高的命令命令功能使用场景/init生成 AGENTS.md 项目记忆文件新项目首次使用/connect配置 AI 模型提供商首次使用或更换模型/plan切换到 Plan 模式需要规划时/compact压缩对话历史释放上下文长对话后 token 紧张时/clear清空当前会话切换任务/undo撤销上一步 AI 操作AI 改错时回退/share生成会话分享链接团队协作/model切换当前使用的模型需要不同模型能力时AGENTS.md 项目记忆执行/init后OpenCode 会在项目根目录生成AGENTS.md文件。这是项目的记忆文件记录了项目结构、技术栈、编码规范等信息。AI 每次启动时会读取该文件快速恢复上下文。建议团队将其纳入 Git 版本管理。 引用文件在对话中使用src/auth/index.ts语法可以将指定文件内容直接注入上下文避免 AI 猜测你指的是哪个文件。实战技巧高效提问结构结构化的提示词能显著提升 AI 输出质量。推荐模板texttext【任务】为 Express 项目添加 JWT 认证中间件 【约束】不引入额外 npm 依赖使用 jsonwebtoken 库 【涉及文件】src/middleware/auth.ts, src/routes/user.ts 【期望】输出完整代码包含错误处理和类型定义text【任务】为 Express 项目添加 JWT 认证中间件 【约束】不引入额外 npm 依赖使用 jsonwebtoken 库 【涉及文件】src/middleware/auth.ts, src/routes/user.ts 【期望】输出完整代码包含错误处理和类型定义会话管理OpenCode 支持多会话并行适合在不同功能分支上同时开发。长对话后建议使用/compact压缩历史避免上下文窗口溢出导致 AI 遗忘早期指令。对话导出支持将会话记录导出为 Markdown 或 JSON 格式便于团队复用 AI 分析结果也可作为技术文档沉淀。与主流工具对比对比维度OpenCodeCursorClaude CodeGitHub Copilot开源协议MIT完全开源闭源闭源闭源运行方式终端原生独立 IDE终端原生IDE 插件模型自由度75 模型可切换限定模型仅 Claude 系列仅 GPT 系列数据隐私代码不离开本地需上传分析需上传分析需上传分析目前免费额度有取决于模型有限免费需订阅需订阅项目上下文AGENTS.md 自动索引自动索引自动索引有限上下文选择建议如果看重开源透明和模型自由度OpenCode 是优先选项如果偏好图形化体验Cursor 更友好如果专注复杂推理任务Claude Code 表现突出。常见问题FAQQ1OpenCode 完全免费吗OpenCode 本身 100% 开源免费但需要接入 AI 模型才能工作。模型费用取决于你选择的提供商——DeepSeek 和智谱 GLM-4 目前提供免费额度可零成本开始体验。Q2Windows 上一定要用 WSL 吗不是必须的。OpenCode 已支持 Windows 原生安装npm、Scoop 均可并且已支持 Windows ARM64 架构。但 WSL 环境下的兼容性和性能表现通常更佳推荐优先考虑。Q3OpenCode 的响应速度如何响应速度主要取决于所选模型和网络环境。使用国内直连的模型如 DeepSeek、智谱 GLM实测首字延迟约 0.6-1.5 秒与商业工具基本持平。Q4代码安全性有保障吗OpenCode 默认在本地运行代码不会上传到外部服务器。Build 模式下AI 对文件的修改会先展示 diff用户确认后才实际写入。配合 Git 使用随时可回退。Q5可以和 Cursor 同时使用吗可以。两者互不冲突。OpenCode 在终端运行Cursor 是独立 IDE很多开发者会在不同场景下交替使用。总结与建议OpenCode 在 2026 年的 AI 编程工具生态中占据了一个独特位置完全开源、模型自由、隐私优先。它的 Plan/Build 双模式设计有效提升了代码生成的可控性75 模型支持让开发者不必被单一厂商绑定。对于国内开发者的入门建议1.从免费模型开始DeepSeek 或智谱 GLM-4 目前提供免费额度适合零成本试用2.先 Plan 后 Build养成先规划再执行的习惯减少返工3.善用 AGENTS.md为每个项目建立记忆文件让 AI 更快理解上下文4.定期 /compact长对话后压缩历史保持响应质量5.关注版本更新OpenCode 迭代节奏快2026 年 3 月一周内发布 5 个版本新功能持续增加无论你是 AI 编程新手还是资深开发者OpenCode 都提供了一个低门槛、高可控的起点。它的开源特性意味着你可以完全掌控工具链而不必依赖任何商业订阅。官方资源GitHubhttps://github.com/anomalyco/opencode官方文档https://opencode.ai/docs【本文完】