2026 年，OpenCode 的 GitHub 星数超过 16 万，超越 Claude Code，成为最受欢迎的Open Source AI 编码代理。 本指南涵盖了专业开发人员的安装、多模型路由、LSP 集成和实际工作流程。
- MIT
- 更新于 2026-05-19
Tabby: Self-Hosted AI Coding Assistant with 33K+ Stars • Persistent Memory for AI Coding Agents in 2026
TL;DR: OpenCode is a free, MIT-licensed terminal AI coding agent with 160K+ GitHub stars. It supports 75+ LLM providers, integrates LSP for ~50ms codebase navigation, and costs $0 in software fees. This guide walks you from installation to production-grade workflows.
为什么 OpenCode 成为 2026 年增长最快的 AI Dev Utils2026 年的人工智能编码工具格局由单一张力定义：便利与自由。 Claude Code 和 Cursor 等闭源工具提供了完美的开箱即用体验，但它们将您锁定在专有模型、固定定价层和不透明的数据处理中。 OpenCode 采取了相反的赌注，并且赢了。到 2026 年 5 月，OpenCode 已积累超过 160,000 个 GitHub 星，超过 Claude Code（122K），成为历史上星数最多的Open Source编码代理。 它的增长不是由营销推动的；而是由营销推动的。 它是由对专业开发人员来说很重要的三个结构优势驱动的：1. 提供商不可知论：在 GPT-5.5、Gemini 3.1 Pro、Claude Sonnet 4.6、DeepSeek-V4、本地 Ollama 模型和 70 多个其他提供商之间切换，无需重写您的工作流程。 #
- 零软件成本：MIT 许可，无需订阅。 您只需为您使用的 API 令牌付费，或者如果您运行本地模型，则无需支付任何费用。
- 终端原生速度：基于 OpenTUI（TypeScript API + Zig 后端）构建，具有原生 LSP 集成，可在 ~50 毫秒内提供符号导航，而不是其他代理中常见的 45 秒文本搜索。—
OpenCode 到底是什么（和不是什么）OpenCode 并不是像 GitHub Copilot 这样的代码补全插件。 它是一个自主编码代理，在您的终端内运行，读取整个代码库，执行 shell 命令，管理 Git 操作，并通过模型上下文协议 (MCP) 编排外部工具。将其视为居住在您的终端中的高级工程师，通过"AGENTS.md"了解您的项目约定，并且可以端到端地实现功能，同时让您处于审批循环中。### 架构概览```` #
┌──────────────────────────────────────────┐ │ 用户输入（自然语言） │ ├──────────────────────────────────────────┤ │ OpenTUI 前端 (Zig + TypeScript) │ ├──────────────────────────────────────────┤ │ LSP 集成 │ Models.dev 路由器 │ │ （~50ms 符号） │ （75+ 提供商） │ ├──────────────────────────────────────────┤ │ 沙盒外壳 │ Git Native │ MCP 总线 │ └──────────────────────────────────────────┘
LS
P
集成是架构的差异化因素。 大多数人工智能编码代理将代码解析为原始文本，这会大规模崩溃。 OpenCode 连接到语言服务器协议服务器，使其能够结构化地理解类型、导入和调用图，这对于跨大型单一存储库进行重构至关重要。---
## 安装：选择你的路径### 通用安装程序（macOS 和 Linux）````
bas
h
卷曲-fsSL https://opencode.ai/install | 巴什
````这会检测您的操作系统，安装依赖项，并在全局范围内设置"opencode"二进制文件。 典型安装时间：**低于 60 秒**。### 包管理器| Platform | Command |
|----------
|---------
|
| npm / bun / pnpm | `npm install -g opencode-ai` |
| Homebrew | `brew install anomalyco/tap/opencode` |
| Arch Linux | `sudo pacman -S opencode` |
| Windows (Scoop) | `scoop in```
bas
h
curl -fsSL https://opencode.ai/install | bash
``` opencode` |
| Docker | `docker run -it --rm ghcr.io/anomalyco/opencode` |**Windows 建议**：使用 WSL2 作为 TUI，或安装 [桌面应用程序](https://opencode.ai/download) 以获得本机 GUI 体验。---
## 连接您的第一个人工智能提供商使用"opencode"启动 OpenCode，然后输入"/connect"。### 选项 A：自带密钥 (BYOK)如果您已经订阅了 API，那么这是理想的选择。 支持的提供商包括：
- **人择**（克劳德十四行诗 4.6，作品 4.7）
- **OpenAI**（GPT-5.4、GPT-5.5、o3）
- **Google**（Gemini 3.1 Pro、Gemini 2.0 Flash）
- **AWS Bedrock**、**Azure OpenAI**、**Groq**
- **OpenRouter**（聚合了数十个前沿和开放权重模型）### 选项 B：OpenCode Zen由 OpenCode 团队管理的精选模型服务。 对编码任务进行了预先测试，托管在美国，数据保留为零。 预付 20 美元起； 代币定价零加价。### 选项 C：通过 Ollama 的本地模型````
bas
h
# 安装 Ollama，然后拉取编码优化模型
奥拉马拉杰玛4: 9b
奥拉马拉qwen3: 14b
````在
OpenCode 中，选择"ollama: //gemma4: 9b"。 **零 API 成本。 零数据离开您的机器。** 这是国防承包商、HIPAA 下的医疗机构以及任何使用敏感 IP 的人员的首选设置。---
## 项目初始化：AGENTS.md 合约在 OpenCode 能够有效工作之前，它需要了解您的项目。 `/init` 命令生成一个 ```
bas
h
# 安装 Ollama，然后拉取编码优化模型
奥拉马拉杰玛4: 9b
奥拉马拉qwen3: 14b
```
TS
.md 模板``降价
# 项目：电子商务微服务平台## 堆栈
- Go 1.24 + Fiber网络框架
- PostgreSQL 16（通过 sqlc 进行类型安全查询）
- Redis 7 用于缓存和会话
- 用于服务间通信的 gRPC
- 用于本地开发的 Docker Compose## 惯例
- 所有 HTTP 处理程序都位于"internal/handlers/{domain}/"中
- 数据库迁移位于"db/migrations/"中，切勿手动编辑
- 使用"slog"进行结构化日志记录； 生产代码中没有"fmt.Println"
- 错误用 `github.com/pkg/errors` 包装以保留堆栈跟踪
- 测试必须达到 >80% 的覆盖率； 使用 `testify` asse```
markdow
n
# 项目：电子商务微服务平台
## 堆栈
- Go 1.24 + Fiber网络框架
- PostgreSQL 16（通过 sqlc 进行类型安全查询）
- Redis 7 用于缓存和会话
- 用于服务间通信的 gRPC
- 用于本地开发的 Docker Compose
## 惯例
- 所有 HTTP 处理程序都位于"internal/handlers/{domain}/"中
- 数据库迁移位于"db/migrations/"中，切勿手动编辑
- 使用"slog"进行结构化日志记录； 生产代码中没有"fmt.Println"
- 错误用 `github.com/pkg/errors` 包装以保留堆栈跟踪
- 测试必须达到 >80% 的覆盖率； 使用"testify"断言
所有 Stripe webhook 处理程序的 ``ency 键。 确定当前实施中的竞争条件。”计划模式输出：
1. 受影响的文件和行范围
2. 提议的幂等性密钥模式
3. 数据库迁移要求
4. 需要更新的测试用例
5. 回滚策略审查、迭代，然后继续。### 构建模式（执行）OpenCode 编写代码、运行测试、迭代修复故障并提交更改。 实验性**后台子代理**允许并行任务执行，例如，一个代理重构，另一个代理编写测试，第三个代理更新 API 文档。---
## true实工作流程：端到端构建功能**场景**：将使用 Google 和 GitHub 的 OAuth 2.0 登录添加到现有 Express + Prisma 应用程序。**第1步**：初始化并选择模型
bas h cd 我的应用程序 开放代码 /初始化 /connect # 为 1M-token 上下文窗口选择 Gemini 3.1 Pro
添加 Google 和 GitHub OAuth 2.0 登录。 将 Passport.js 与 JWT 会话结合使用 策略。 使用以下用户和帐户模型更新 Prisma 架构 NextAuth 约定。 添加受保护的路由中间件。 写集成 使用 supertest 进行测试。
OpenCod
e
标识：
- 需要创建 `src/auth/` 目录
- `prisma/schema.prisma` 需要用户/帐户/会话模型
- `.env.example` 需要 GOOGLE_CLIENT_ID、GITHUB_CLIENT_ID
- `src/middleware/requireAuth.ts` 用于路由保护
- `tests/auth/oauth.test.ts` 用于覆盖范围**第3步**：切换到构建模式并执行
OpenCode 创建文件，运行"prisma migrate dev"，执行"npm test"，并修复在测试失败期间检测到的丢失的"passport.serializeUser"配置。**第 4 步**：审核并分享
/分享
生成只读链接。 将其发送给您的团队，以便在合并之前对人工智能的推理进行异步审查。---
## 多模型策略：优化成本和质量OpenCode 的杀手级功能是**适合任务的模型选择**。 整体方法——使用 C```
bas
h
cd 我的应用程序
开放代码
/初始化
/connect # 为 1M-token 上下文窗口选择 Gemini 3.1 Pro
```` 成本|
|----------
|--------------------------------
|----------------
|
| Linting、格式化、简单重构 | Gemma 4（本地/Ollama```
> 添加 Google 和 GitHub OAuth 2.0 登录。 将 Passport.js 与 JWT 会话结合使用
> 策略。 使用以下用户和帐户模型更新 Prisma 架构
> NextAuth 约定。 添加受保护的路由中间件。 写集成
> 使用 supertest 进行测试。
``问|
| 遗留代码迁移（COBOL→Go） | Claude Opus 4.7（xhigh 努力）| ~$5.00-10.00/任务 |团队报告称，通过将每项任务路由到最便宜的功能模型，与单一模型订阅相比，**可降低 60-80% 的成本**。---
## 使用 MCP 服务器扩展 OpenCode模型上下文协议 (MCP) 将 OpenCode 从编码代理转变为通用自动化引擎。### 示例：PostgreSQL MCP添加到`~/.config/opencode/opencode.json`：
```
jso
n
{
"mcp服务器"：{
"数据库"：{
"命令"：["npx"，"-y"，"@modelcontextprotocol/server-postgres"]，
"env"：{"DATABASE_URL"："postgresql: //localhost/devdb"}
}
}
}
````现在您可以提示：
>"显示订单表的架构并建议`src/```中慢速查询的索引
> /分享
``y.ts`。"OpenCode 查询实时数据库，读取查询代码，并提出带有 EXPLAIN ANALYZE 验证的"CREATE INDEX"语句。### 流行的 MCP 集成| Server | Capability |
|--------
|-----------
|
| `@modelcontextprotocol/server-postgres` | Schema inspection, query optimization |
| `@modelcontextprotocol/server-browser` | Web scraping, visual regression testing |
| `@modelcontextprotocol/server-github` | Issue creation, PR review, automated releases |
| `@modelcontextprotocol/server-slack` | Notify channels on build status |---
## 正面交锋：OpenCode 与竞争对手| 能力| 开放代码 | 克劳德·代码 | 光标| GitHub 副驾驶 |
|------------
|----------
|-------------
|--------------------
|----------------
|
| 许可证| MIT（Open Source）| 专有| 专有| 专有|
| 软件月费 | 0 美元 | 20-200 美元 | 20 美元 | 10-39 美元 |
| 模型灵活性 | 75+ 提供商 | 仅限人类 | 有限公司| 有限公司|
| 本地/离线模式 | ✅ 奥拉马/vLLM | ❌ | ❌ | ❌ |
| 终端原生 | ✅ | ✅ | ❌ | ❌ |
| IDE 扩展 | VS Code、光标、Zed | ❌ | 内置IDE | VS Code、JetBrains |
| LSP 集成 | ✅ ~50ms | ❌ 文字搜索 | 通过 VS 代码 | 通过 VS 代码 |
| MCP 支持 | ✅ | ```
jso
n
{
"mcp服务器"：{
"数据库"：{
"命令"：["npx"，"-y"，"@modelcontextprotocol/server-postgres"]，
"env"：{"DATABASE_URL"："postgresql: //localhost/devdb"}
}
}
}
``的
- **Claude Code**：深度人类集成、企业合规性 (SOC2)、大型组织的代理团队
- **光标**：视觉设计师、非终端用户、一体化 IDE 偏好
- **Copilot**：微软生态系统锁定，为个人开发者提供最简单的设置---
## 高级配置和性能调优### 自定义模型路由规则创建`~/.config/opencode/model-routes.json`：
```
jso
n
{
"路线"：[
{ "pattern": "refactor|lint|format", "model": "ollama: //gemma4: 9b" },
{"模式"："安全|审计|漏洞"，"模型"："anthropic: //claude-sonnet-4.6"}，
{"模式"："架构|设计|微服务"，"模型"："google: //gemini-3.1-pro"}
]
}
OpenCod e 根据您的提示关键字自动选择最便宜的合适型号。### 工作区持久性OpenCode 的实验性 工作区 功能可保存完整的会话上下文（包括文件状态、对话历史记录和 LSP 缓存），因此您可以在几天后恢复复杂的重构任务，而不会丢失上下文。—
常见问题故障排除**“上下文太大"错误** #
- 禁用"opencode.json"中未使用的 MCP 服务器
- 使用每个代理工具配置来限制活动 MCP
- 切换到 Gemini 3.1 Pro 以获得 1M+ 代币窗口大型代码库响应缓慢
- 确保 LSP 服务器正在运行（OpenCode 中的”/lsp status"）
- 从索引中排除
node_modules/、.git/和构建工件 - 使用与".gitignore"相同的".opencodeignore"语法模型提供者超时
- 增加提供商配置中的超时（默认值：30 秒）
- 对于本地模型，验证 Ollama 是否响应：
curl http://localhost: 11434/api/tags—
推荐的托管和基础设施在将这些工具部署到生产中之前，您需要坚实的基础设施。 dibi8实际使用和推荐的两个选项：- {< aff “digitalocean” “footer-cta-legacy” “DigitalOcean” >}} — 200 美元免费赠金，为期 60 天，覆盖全球 14 个以上区域。 运行Open SourceAI Tools的独立开发者的默认选项。 #
- {< aff “htstack” “footer-cta-legacy” “HTStack” >}} — 具有低延迟 ac
jso n 的香港 VPS { "路线"：[ { "pattern": "refactor|lint|format", "model": "ollama: //gemma4: 9b" }, {"模式"："安全|审计|漏洞"，"模型"："anthropic: //claude-sonnet-4.6"}， {"模式"："架构|设计|微服务"，"模型"："google: //gemini-3.1-pro"} ] }随着前沿模型在功能上的趋同（GPT-5.5、Claude Sonnet 4.6、Gemini 3.1 Pro 现在在 SWE 基准上的得分相差在 5% 以内），差异化转移到编排层。 OpenCode 的赌注是开发人员希望拥有这一层——随着市场的发展混合、匹配和迁移模型。160,000 颗星之后，这个赌注似乎得到了回报。 OpenCode 不会取代高级工程师，但它消除了占用开发人员一周 30-40% 时间的样板税。 剩下的时间用于建筑、品味、以及只有人类才能做出的决定。今天安装它。 您的终端已经打开。```` bas h 卷曲-fsSL https://opencode.ai/install | 巴什
---**参考文献**
- GitHub 存储库：https://github.com/anomalyco/opencode
- 文档：https://opencode.ai/docs
- MCP 规范：https://modelcontextprotocol.io
- Models.dev 目录：https://models.dev### 另请参阅：工具比较如果您在 **Cursor 和 Claude Code** 之间进行选择，请参阅我们的并排细分：[2026 年 Cursor 与 Claude Code — 哪种 AI 编码工具获胜？](/vs/cursor-vs-claude-code/)*最后更新时间：2026 年 5 月 19 日。 AI Tools领域发展迅速； 根据官方文档验证详细信息。*<!--自动引用-->
## 参考文献和来源- [OpenCode](https://github.com/sst/opencode)
- [Ollama](https://github.com/ollama/ollama)
- [模型上下文协议](https://modelcontextprotocol.io)
- [Models.dev](https://models.dev)
- [Passport.js](https://www.passportjs.org)
- [Prisma](https://github.com/prisma/prisma)
- [语言服务器协议](https://microsoft.github.io/language-server-protocol/)
- [sqlc](https://github.com/sqlc-dev/sqlc)
- [作证](https://github.com/stretchr/testify)
- [光纤](https://github.com/go Fiber/ Fiber)
bas h 卷曲-fsSL https://opencode.ai/install | 巴什
💬 留言讨论