OpenCode开源AI编程工具使用指南及优势详解

最近OpenCode这个开源AI编程工具突然火了。GitHub上70,000+ Star，每月65万活跃开发者，增长速度确实让人侧目。

目前大家用得比较多的还是Claude Code和Codex CLI。这两个工具都深度体验过——Claude Code的模型质量没得说，Codex CLI则成了现在的主要工具。但OpenCode能在这么短时间内吸引这么多开发者，背后肯定有原因。

这几天深度体验了OpenCode，从安装配置到实际使用，下面就把使用感受摊开来聊聊。

Claude Code和Codex CLI简单说两句

在聊OpenCode之前，先快速说一下另外两个工具，算是给个参照系。

Claude Code是Anthropic官方的AI编程助手，闭源专有，开箱即用，Claude模型质量高，文档完善。但只针对Claude系列模型优化，而且只有终端界面——对于习惯用IDE的开发者来说，工作流程需要调整。

Codex CLI是OpenAI推出的编程智能体，主要搭配GPT-5-codex模型。功能丰富，可配置性强，支持网络搜索、文件引用、图像输入等。主要绑定OpenAI生态，虽然开源，但由官方主导开发。

这两个工具都很优秀。但话说回来，这个月初，Anthropic突然限制了第三方工具调用Claude API的能力，很多使用OpenCode和Cursor的开发者突然发现没法继续用Claude模型了，而且没有任何警告。这件事在开发者社区引发了不少争议，也让人们开始重新思考工具选择的问题。

OpenCode是什么？

OpenCode是一个100%开源的AI编程袋里工具，可以在终端、IDE、甚至桌面应用中使用。

从GitHub仓库（github.com/anomalyco/o…）来看，数据很亮眼：

• 70,000+ GitHub Stars
• 500+ 贡献者
• 7,000+ commits
• 65万月活跃开发者

这些数字说明OpenCode不是一个小众项目，而是一个活跃的、有生命力的开源社区。

核心特性：

1. 多模型支持

这是OpenCode最大的亮点。它支持75+种LLM提供商，包括Claude、GPT、Gemini，国内所有厂商，甚至本地模型。你可以根据任务特点、成本预算、模型能力来自由选择。

（注意，图片中只展示了部分）

而且OpenCode还提供了一些免费模型，比如GLM-4.7、Grok Code Fast 1、MiniMax M2.1等。如果你有Claude Pro或ChatGPT Plus订阅，也可以直接复用。

2. LSP支持

LSP（Language Server Protocol）是现代IDE的核心功能之一，提供代码补全、跳转定义、错误检查等能力。OpenCode开箱即用就集成了LSP支持，AI能够更准确地理解你的代码上下文。

相比之下，Claude Code和Codex CLI需要额外配置才能用上LSP。

3. 多平台支持

OpenCode不只是一个终端工具，它还提供：

• 终端CLI
• 桌面应用（macOS/Windows/Linux）
• IDE扩展

这意味着你可以在自己习惯的工作环境中使用OpenCode，不需要为了工具而改变工作流程。

4. 多会话并行

这是一个很实用的功能。你可以在同一个项目中启动多个OpenCode会话，分别处理不同的任务。比如一个会话负责开发新功能，另一个会话负责重构代码，互不干扰。

5. 内置两种Agent

OpenCode提供了两种内置Agent，可以用Tab键切换：

• build：默认的全权限Agent，适合日常开发工作
• plan：只读Agent，默认拒绝文件编辑，运行bash命令前会请求权限，适合探索陌生代码库或规划变更

6. 分享链接

你可以分享任何会话的链接给同事或朋友，方便协作和问题调试。这个功能在团队协作中很有用。

7. 客户端/服务器架构

OpenCode采用了客户端/服务器架构，这意味着你可以在本地电脑上运行服务器，然后从其他设备（比如平板、手机）远程访问。TUI终端界面只是一种客户端形式，未来还可能有更多客户端形态。

为什么OpenCode能火起来？

除了上面提到的功能特性，OpenCode能够快速获得开发者认可，还有几个深层原因。

1. 社区驱动的开源

100%开源意味着代码完全透明。虽然Codex也是开源的，但OpenCode是完全由社区驱动，开发方向由社区决定，而不是某个大公司的战略考量，有持续的生命力。

2. 不绑定厂商

支持75+种模型提供商，这意味着你永远有选择权。如果某个模型不好用了，或者价格涨了，或者API被限制了，你可以随时切换到其他模型，不会被单一厂商绑定。

Ruby on Rails的创始人DHH在评论Anthropic封禁事件时说：“没有哪个开发者会想安装五个不同的CLI。他们肯定希望学习并使用一个能够控制所有模型的工具。对我来说，这个工具就是OpenCode。”

3. 工作流友好

不强制使用终端，支持IDE集成和桌面应用，这让OpenCode能够无缝融入现有的开发工作流程。

4. 社区驱动

作为开源项目，OpenCode的发展方向由社区决定。如果你有好的想法，可以提Issue或者直接贡献代码。这种参与感是闭源工具无法提供的。

安装和配置

OpenCode的安装非常简单，支持多种方式。

快速安装（推荐）：

# macOS和Linux（推荐，总是最新版本）brew install anomalyco/tap/opencode# 或者使用官方brew formula（更新较慢）brew install opencode# 一键安装脚本（YOLO）curl -fsSL https://opencode.ai/install | bash# npm/pnpm/yarn/bunnpm i -g opencode-ai@latest# Windows用户scoop bucket add extrasscoop install extras/opencode# 或者用Chocolateychoco install opencode

桌面应用：

如果你更喜欢图形界面，OpenCode也提供了桌面应用。可以从GitHub的releases页面下载，或者访问opencode.ai/download。

如果你用Homebrew，也可以直接安装：

brew install --cask opencode-desktop

OpenCode的桌面端界面如下，非常简洁：

建议先安装桌面端，因为你可以从桌面端直接一键安装命令行CLI：

当然，如果不想使用桌面端，按照上面的方式只安装CLI即可。

如果你已经有Claude或ChatGPT的付费订阅，可以直接复用，不需要额外付费。

使用指南

启动OpenCode：

在终端输入opencode即可启动。

基本交互：

OpenCode的交互方式很直观，和Claude Code/Codex CLI等命令行方式一样，直接用自然语言描述需求，OpenCode会理解并执行。

斜杠命令：

OpenCode支持一些快捷命令，可以提高效率。输入/就能看到所有可用命令。

常用命令：

• /init：初始化项目指导文件（AGENTS.md），为AI提供项目上下文
• /review：代码审查
• /new：新建会话
• /agents：切换Agent（build或plan）
• /model：切换模型

文件引用：

用@符号可以快速引用项目中的文件，比如@src/utils.js。这样AI就能准确理解你在讨论哪个文件。

切换Agent：

按 command+. （mac）键可以在build和plan两个Agent之间切换。

• build：完全权限，适合日常开发
• plan：只读模式，适合探索代码库或规划变更

会话管理：

OpenCode支持多会话并行，在侧边栏可以看到所有会话。你可以为每个会话命名，方便管理。

用起来和Claude Code、Codex CLI等工具基本没任何区别，这里就不做案例演示了，简单看下桌面端界面是个什么样子，毕竟也不是模型测评，大家自行体验即可，没有任何切换门槛。

oh-my-opencode：让OpenCode更好用

oh-my-opencode是一个社区项目，为OpenCode提供了增强功能和预设配置，有点像oh-my-zsh之于zsh。

这不是一个必选项，而是一个可选项，但建议搭配oh-my-opencode使用，体验更好。

主要功能：

1. 预设Prompt模板：针对常见任务（比如代码审查、测试生成、文档编写）提供优化的Prompt
2. 快捷命令扩展：添加更多实用的斜杠命令
3. 主题和界面定制：美化OpenCode界面
4. 工作流集成：与Git、CI/CD等工具更好地集成

安装oh-my-opencode：

直接运行以下命令进行交互式安装：

npx oh-my-opencode install# or with bunbunx oh-my-opencode install

但建议直接使用OpenCode的免费模型，比如GLM-4.7帮你安装，因为直接运行命令安装可能会遇到环境和版本等问题，自己处理比较闹心。让大模型帮你安装的话，它直接帮你全处理好了，比较省事。

只需要输入下面描述词即可：

Install and configure by following the instructions here https://raw.githubusercontent.com/code-yeongyu/oh-my-opencode/refs/heads/master/README.md

安装成功后，你重新运行OpenCode，应该会看到下面的提示：

而且，安装完成后，oh-my-opencode会自动加载预设配置。你可以使用默认配置，也可以根据自己的需求修改配置文件，详情请看官方介绍：github.com/code-yeongy…

推荐配置：

比如可以添加一些常用的Prompt模板：

• 代码审查模板：关注性能、安全、可维护性
• 测试生成模板：自动生成单元测试和集成测试
• 重构模板：遵循SOLID原则和设计模式

这些模板可以让OpenCode更加智能和高效。

客观说说OpenCode的不足

使用过程中，也发现了一些OpenCode的局限性，这里客观说一下。

1. 文档相对分散

虽然官方文档在不断完善，但相比Claude Code和Codex CLI这种大厂产品，OpenCode的文档还是显得有点分散。有些高级功能需要自己摸索或者去社区问。

好在社区很活跃，Discord和GitHub Discussions上能找到很多答案。

2. 企业支持

作为开源项目，OpenCode没有商业公司提供的SLA（服务等级协议）和企业技术支持。如果你的公司对这些有硬性要求，可能需要考虑商业工具。

不过OpenCode团队也在探索企业版，未来可能会有改善。

3. 多模型选择的学习成本

75+种模型听起来很自由，但也意味着你需要了解不同模型的特点、定价、适用场景。对于新手来说，可能会有选择困难。

建议刚开始使用时，先用OpenCode Zen提供的优化模型，这些模型经过专门测试，适合编程Agent使用。熟悉之后再根据需求切换。

4. 桌面应用还在Beta

桌面应用目前还是Beta版本，稳定性不如终端CLI。如果你主要用桌面应用，可能会遇到一些小bug。

但好消息是，开发团队更新很快，bug修复速度也快。

我的使用建议

用了几天OpenCode，感受是：这是一个值得尝试的工具，尤其是如果你关心工具的长期可持续性。

什么情况适合切换到OpenCode：

1. 你担心厂商绑定风险，希望有更多选择权
2. 你使用多种AI模型，需要根据任务灵活切换
3. 你喜欢开源工具，愿意参与社区贡献
4. 你的工作流程依赖IDE集成，不想被迫使用终端
5. 你需要多会话并行、分享链接等高级功能

什么情况可以继续用Claude Code或Codex CLI：

1. 你只用Claude或GPT模型，不需要多模型切换
2. 你的公司要求使用有SLA保障的商业工具
3. 你更看重开箱即用的体验，不想折腾配置
4. 你不介意厂商绑定，信任Anthropic或OpenAI的长期策略

建议：

对于大多数开发者，都建议试试OpenCode。安装很简单，而且支持免费模型，试错成本很低。

如果你已经有Claude或ChatGPT的付费订阅，可以直接在OpenCode里复用，不需要额外花钱。

体验几天后，你会对AI编程工具的开源生态有更深的理解，也能更明确自己真正需要什么样的工具。

在AI工具越来越重要的今天，拥有选择权本身就是一种价值。OpenCode给了我们这个选择权。