OpenCode 是一款完全开源(MIT 协议)的 AI 编码代理,由 anomalyco 团队开发,在 GitHub 上已获得 183,000+ 星标。它被称为”AI 编码代理领域的 Linux”——开放、自由、可定制。
什么是 OpenCode?
OpenCode 是一个能在终端、桌面应用或 IDE 中运行的 AI 编程助手。与 Claude Code、Cursor、GitHub Copilot 等功能相似,但 OpenCode 的核心优势在于:
- 完全开源(MIT 协议)—— 代码透明,可审计、可私有化部署
- 模型自由—— 支持 75+ 种 LLM 提供商,包括 Claude、GPT、Gemini、DeepSeek,甚至本地模型
- 隐私优先—— 不存储用户代码,适合敏感环境
- 多端可用—— 终端 TUI / 桌面应用 / IDE 扩展三端覆盖
- 零成本入门—— 提供免费内置模型(OpenCode Zen)
目前全球每月有超过 750 万开发者在使用 OpenCode,社区活跃度极高。
核心功能详解
双模式代理系统
OpenCode 内置了两种工作模式,通过 Tab 键一键切换:
- Build 模式(默认)—— 完整权限,可读取和修改代码、执行命令、安装依赖。适合日常开发工作。
- Plan 模式—— 只读模式,分析代码结构、制定修改计划,但不会改动任何文件。适合在动手前先确认方案。
此外还有 @general 子代理 机制,可以派生子代理并行处理复杂任务。
LSP 智能感知
OpenCode 能自动加载项目中使用的语言服务器协议(LSP),理解代码的类型信息、符号定义、引用关系等,使 AI 对代码的理解更加精准。
多会话并行
支持同时启动多个代理会话,分别处理不同的任务,互不干扰。桌面版以标签页形式管理多会话。
会话分享
执行 /share 命令即可将当前 AI 会话生成为链接,分享给团队成员查看。这在协作调试和代码审查时非常方便。
安装方式
OpenCode 提供多种安装方式,覆盖全平台:
Windows
- 桌面版 下载 ZIP 包解压运行(推荐)
- Scoop:
scoop install opencode - Chocolatey:
choco install opencode - npm:
npm install -g opencode-ai - 建议 Windows 用户优先使用 WSL 获得最佳体验
macOS
- Homebrew:
brew install anomalyco/tap/opencode - 桌面版:下载 .dmg 安装包
- npm:
npm install -g opencode-ai - 一键脚本:
curl -fsSL https://opencode.ai/install | bash
Linux
- 桌面版提供 .deb / .rpm / .AppImage 格式
- 包管理器:
sudo pacman -S opencode(Arch) - Docker:
docker run -it --rm ghcr.io/anomalyco/opencode
快速上手
安装完成后,三步即可开始使用:
1. 配置模型
# 启动后运行
/connect
# 选择 OpenCode Zen(免费)或连接自己的 API Key
2. 初始化项目
cd /your/project
opencode
# 执行
/init
# 这会生成 AGENTS.md,建议提交到 Git 仓库
3. 开始对话
# 提问(用 @+文件名 模糊搜索)
"@src/main.rs 里的错误处理逻辑是什么?"
# 改代码
"给 /settings 路由加上认证,参考 @auth.ts 的实现"
# 先规划再动手(Tab 切换到 Plan 模式)
"我希望添加一个回收站功能..."
# 满意后 Tab 切回 Build 模式执行
# 不满意 /undo 撤销
实用技巧
- 拖拽图片到终端—— OpenCode 能识别图片内容,可用于 UI 参考
- @ 文件搜索—— 提示词中用 @ 后跟文件名模糊搜索
- 多级 /undo—— 支持多次撤销回到任意历史版本
- 先 Plan 再 Build—— 复杂的改动先用 Plan 模式确认方向
- 提交 AGENTS.md—— 让下次打开时 OpenCode 了解项目规则
- 多标签页—— 桌面版支持同时处理多个项目
高级自定义
OpenCode 提供了丰富的自定义选项:
- 主题系统(内置多套 + 自定义)
- 快捷键绑定
- 代码格式化规则
- 自定义 /command 快捷命令
- MCP 服务连接(扩展外部工具)
- 权限策略(精细控制文件和命令操作)
- Agent Skills 扩展系统
- GitHub / GitLab 深度集成
总结
OpenCode 是目前最受欢迎的开源 AI 编码代理之一。它的开放性和灵活性使其成为 Claude Code、Cursor 等商业产品的有力替代方案。无论是个人开发者还是团队,都可以免费使用并深度定制。
下载地址:github.com/anomalyco/opencode/releases
官方文档:opencode.ai/docs
GitHub 仓库:github.com/anomalyco/opencode