📌 项目简介
OpenCode 是一款开源AI编程代理（Coding Agent），由 anomalyco 团队开发，目前已在GitHub上获得 16.8万枚Star。它可以将你选择的AI模型直接转化为一个能够理解代码库、自主执行开发任务的编程助手——支持全权限的 build 模式用于日常开发，也提供只读的 plan 模式来安全地探索陌生代码库。OpenCode 同时提供命令行工具与跨平台桌面端，让AI编程真正触手可及。
⚙️ 安装要求和过程
环境要求
- 支持 macOS / Linux / Windows 三大平台
- 需要已配置好的AI模型API（支持OpenAI兼容接口，可对接Claude、GPT、DeepSeek等）
- Node.js 18+（使用npm/pnpm安装时）
- 或直接下载桌面端（无需Node.js环境）
快速安装（推荐方式）
# 方式1：一键安装脚本（macOS/Linux）
curl -fsSL https://opencode.ai/install | bash
# 方式2：npm（跨平台）
npm i -g opencode-ai@latest
# 方式3：Homebrew（macOS/Linux）
brew install anomalyco/tap/opencode
# 方式4：Windows（Scoop）
scoop install opencode
# 方式5：下载桌面端（推荐普通用户）
访问 https://opencode.ai/download 下载对应系统安装包
初次配置
安装完成后，运行 opencode 启动，按提示配置AI模型API密钥即可开始使用。
🚀 核心功能
① 双模式代理切换
按 Tab 键即可在 build（全权限开发模式）和 plan（只读分析模式）之间切换。build模式适合日常编码，plan模式则会在修改文件、执行命令前请求确认，非常适合探索陌生代码库或规划大型重构。
② general子代理：复杂多步任务
通过在消息中 @general 即可调用通用子代理，专门处理需要多轮搜索、跨文件分析、多步骤协作的复杂任务。它会在后台自主规划并执行，完成后汇报结果。
③ 跨平台桌面端（Beta）
提供 macOS（Intel + Apple Silicon）、Windows、Linux 的桌面端安装包，内置完整的AI代理能力，同时支持 VS Code SDK 集成。桌面端提供可视化的会话管理、文件预览和代理状态监控，大幅降低了使用门槛。
④ 多模型支持 & 社区生态
支持所有 OpenAI 兼容接口（Claude、GPT、DeepSeek、Gemini 等），可通过环境变量灵活切换。官方 Discord 和 X 社区活跃，有专门的技能分享频道，用户可以提交自己的 Claude Skills 来增强代理能力。
🔬 典型使用场景
场景1：快速理解和修改陌生代码库
刚接手一个开源项目，按下 Tab 切换到 plan 模式，让 OpenCode 分析代码库结构、梳理核心逻辑。它会生成详细的架构说明，并在不修改任何文件的前提下给出重构建议。确认方向后切换回 build 模式执行修改，安全又高效。
场景2：日常功能开发与Bug修复
在 build 模式下，直接用自然语言描述需求：”添加一个用户导出数据的API接口，需要鉴权”。OpenCode 会自动分析现有代码风格和路由结构，生成符合项目规范的代码，并同步更新相关测试用例。整个过程无需手动创建文件或查找文档，AI代理全程搞定。
场景3：团队协作中的代码审查辅助
在 review PR 前，让 OpenCode 先做一次自动化审查：检查代码规范、发现潜在 bug、评估性能影响。它能在几分钟内完成人工需要半小时才能做完的审查工作，并将结果整理成结构化的评论建议，大幅提升团队 code review 效率。
💡 推荐理由
作为近期 GitHub Star 增长最快的AI编程项目之一（28天内新增超过1000+ Star），OpenCode 最打动我的是它对「安全与效率平衡」的设计理念——plan 模式让你可以放心地把AI代理指向任何代码库，不用担心它在只读分析时误操作；build 模式则通过细粒度的权限确认，让你始终掌控每一次文件修改和命令执行。
相比 Cursor、GitHub Copilot 等商业产品，OpenCode 完全开源（MIT协议），你可以自由定制、本地部署，甚至接入自己的私有模型。对于注重数据隐私的团队，或者想要深入理解 AI Coding Agent 工作原理的开发者，这是一个不可多得的优秀项目。
另外，它的多语言 README（含简体中文）和活跃的 Discord 社区也让入门门槛大大降低。如果你正在寻找一个既能用又能学的开源AI编程工具，OpenCode 绝对值得一试。
📥 下载地址
官网：https://opencode.ai
|
下载页：https://opencode.ai/download
GitHub：https://github.com/anomalyco/opencode
|
文档：https://docs.opencode.ai
⭐ 截至2026年6月，GitHub Star数：168,000+
本文由 WorkBuddy AI 自动采集撰写，内容来源于项目公开资料，欢迎在评论区分享你的使用体验！