🍊柑橘 RSS 阅读器 - 鸿蒙首款原生 RSS 阅读器

引言 (Introduction)

近期，AI 编程工具领域最炙手可热的新星非 OpenCode 莫属。作为一个完全开源的项目，它被广泛视为 Claude Code 的最佳平替，甚至在某些方面青出于蓝。

对于许多开发者——尤其是部分地区用户来说，Claude Code 虽然强大，但“封号”、“限速”以及复杂的注册门槛往往让人望而却步。OpenCode 的出现完美解决了这些痛点：它完全开源、无封号风险，且对所有用户都极度友好，让你能专注于创造本身而非账号管理。

它的核心优势在于极致的灵活与低门槛：

开箱即用（免费）： 内置了 Gemini 4.7、MiniMax 2.1 等高性能免费模型，小白也能零成本上手体验 AI 编程的乐趣。
全模型兼容： 只要有 API Key，你就可以接入 OpenAI、Claude、DeepSeek 等各家顶尖模型，甚至通过 OpenRouter 接入市面上几乎所有的 AI 模型。

本文旨在提供一份面向所有人的 “保姆级使用指南”。无论你是想提高效率的独立开发者，还是普通的编程爱好者，这篇文章都将手把手带你玩转 OpenCode，并会随着工具迭代持续更新。

概况 (Overview)

OpenCode 是什么？简单来说，OpenCode 可以看作是开源版的 Claude Code。它不仅复刻了 Claude Code 几乎所有的核心功能，还打破了模型绑定的限制，支持市面上主流的所有 AI 模型。

OpenCode官网：https://opencode.ai/
OpenCode的GitHub地址：https://github.com/anomalyco/opencode

为了适应不同用户的使用习惯，OpenCode 目前提供了四种主要的存在形态：

命令行工具 (CLI)这是功能最全、最原生的版本。通过 Node.js 的 npm 命令即可轻松安装，轻量且高效，是目前最推荐的使用方式。
桌面客户端 (Desktop)专为不喜欢黑色终端窗口的用户设计。它拥有简洁清爽的图形化界面，虽然目前仍处于 Beta 测试阶段（Bug 可能稍多），但对于非技术背景的用户来说，是体验 AI 编程门槛最低的入口。
编辑器插件 (VS Code Extension)可以直接在 VS Code 或 Cursor 的扩展商店中搜索安装。它的优势在于“沉浸感”：能自动关联当前打开的代码文件，你只需选中代码并通过快捷键，就能将其投喂给 AI 进行分析或重构。
云端运行环境 (Cloud / GitHub Actions)这是最高阶的玩法。将 OpenCode 集成到 GitHub 仓库后，它就变成了一个云端员工。你只需提交一个 Issue，它就能在后台自动分析问题、修复 Bug，并直接提交代码合并请求 (Pull Request)，全程无需人工干预。

使用指南 (User Guide)

命令行工具（CLI）中使用

安装OpenCode命令行工具（CLI）

OpenCode 的安装非常轻量，它基于 Node.js 环境。

环境准备： 确保你的电脑上安装了 Node.js（建议版本较高）。
一键安装CLI： 打开终端（Terminal 或 CMD），输入以下命令即可：
npm i -g opencode-ai
或者使用 npx 直接运行（无需安装）：
npx open-code
Mac 用户特别通道： 如果你是 macOS 用户，也可以使用 Homebrew 快速安装：
brew install open-code

初始化和基础用法

安装完成后，在终端terminal中输入 opencode 即可启动。

对话框类输入内容聊天，就像使用AI聊天框一样
输入/，唤起不同的功能服务，例如：/models唤起模型配置服务

模型配置 (Configuration)

初次启动时，软件会引导你进行简单的配置。

启用免费“真香”模型：OpenCode 对新手最友好的地方在于内置了免费模型。启动后输入 /models 命令，你会看到带有 free 标记的模型。
- 推荐： GLM 4.7 或 MiniMax 2.1。这两个模型的编程能力非常不错，且完全免费，零配置开箱即用。
接入最强模型（进阶）：
如果你追求极致的编程体验，可以将它连接到更强大的模型：
- OpenRouter： 输入 /models 后选择 OpenRouter，填入 API Key，即可使用 DeepSeek、Claude 3.5 Sonnet 等市面上几乎所有的模型。
- OpenAI / Anthropic： 同样支持直接输入官方 API Key 接入 GPT-4 或 Claude 系列。

核心模式与工作流 (Core Modes)

OpenCode 的工作流设计非常符合开发直觉，主要分为两种模式：

Plan 模式 (策划)：这是默认模式。AI 在这里充当“产品经理”或“架构师”。它会和你沟通需求、拆解任务、制定详细的开发计划，但不会直接修改代码。
- 适用场景： 需求分析、技术选型、复杂功能的头脑风暴。
Build 模式 (构建)：当计划确认无误后，通过按 Tab 键（或在对话中指示）切换到 Build 模式。此时 AI 变身为“资深程序员”，拥有读写文件、运行终端命令的权限，开始自动写代码、跑测试、修 Bug 。
Session 管理 (多任务并行)：
OpenCode 引入了 Session（会话）的概念。
- 新开任务： 输入 /ne 命令可以开启一个全新的 Session，清理上下文以便开始新任务。
- 并行开发： 它是支持后台运行的！你可以同时开启多个 Session，让一个 AI 在后台写前端，另一个在后台写后端，互不干扰，极大提升效率。

插件中使用

安装和使用

通过Extensions搜索安装

使用

打开命令面板
Wine：Ctrl+Shift+P
Mac：Cmd+Shift+P
快速复制复用代码
Win：Ctrl+Alt+K
Mac：Cmd+Option+K

场景化用例 (Use Cases)

光说不练假把式，OpenCode 到底能帮我们干什么？以下是三个覆盖不同需求的典型实战场景：

从零打造：极速构建 Web 应用

如果你有一个点子，OpenCode 能在几分钟内帮你把它变成现实。

案例： 创建一个现代化的数据分析仪表盘（Dashboard）。
操作流程：
1. 下达指令： 输入提示词，要求包含“数据可视化、实时更新、深色模式支持” 。
2. 自动执行： 切换到 Build 模式，AI 会自动规划文件结构、编写 HTML/CSS/JS 代码，甚至处理复杂的图表逻辑。
3. 成果： 几分钟后，一个交互流畅、具备动态效果的仪表盘就完成了，全程无需手动编写一行代码。

存量改造：给现有 App 加功能

OpenCode 的强大之处在于它能“读懂”你现有的复杂项目，而非仅仅处理单个文件。

案例： 给一个已有的 iOS 原生背单词 App 增加“判断题”或“专注计时器”功能。
核心步骤：
1. 建立认知 (/init)： 在项目根目录运行 /init 命令。OpenCode 会扫描整个项目，生成一个 .opencode/agent.md (或 .agency.md) 文件，里面记录了项目的技术栈、架构和代码规范。
2. 精准修改： 开启新会话 (/ne)，提出需求。AI 会利用 LSP (语言服务器协议) 精准定位相关代码文件（如 Swift 文件），在不破坏原有逻辑的前提下新增功能。
3. 零错误交付： 实测中，它能一次性正确实现“下拉选择时间”、“倒计时逻辑”等功能，并自动通过编译。

云端雇员：自动化 Bug 修复

这是 OpenCode 最具科幻感的玩法——把它变成你的 GitHub “云端员工”。

案例： 自动修复用户提交的 Bug。
操作流程：
1. 配置环境： 将 OpenCode 集成到 GitHub Actions 中。
2. 触发任务： 当用户在 Issue 中反馈 Bug（例如“导航栏功能冲突”）时，你只需在评论区 @OpenCode 。
3. 自动闭环： OpenCode 会在云端自动运行，定位问题，修复代码，并提交一个 Pull Request (PR)。你只需要点击“合并”即可。

隐藏技巧/高级玩法 (Advanced Tips)

如果你以为 OpenCode 只是一个像 GitHub Copilot 那样的代码补全工具，那你就太小看它了。配合以下高级玩法，它能真正实现“一人抵一个开发团队”。

插件：opencode-antigravity-auth

地址：https://github.com/NoeFabris/opencode-antigravity-auth

调用Antigravity内置的AI模型

神级插件：Oh My OpenCode (OMO)

这是 OpenCode 目前最强的开源插件，安装它之后，你的 AI 助手将进化为一个完整的 AI 开发团队 。

团队角色分工： OMO 不再让一个模型干所有的活，而是引入了多个专业智能体 (Agents)：
- Sisyphus (西西弗斯)： 主控智能体，负责指挥、派发任务和验证结果。
- Oracle (先知)： 负责架构设计和复杂 Bug 修复。
- Frontend (前端专家)： 专精 UI/UX 设计，甚至能调用 Gemini 1.5 Pro 这种多模态模型来处理视觉任务。
魔法咒语 (****outlaw / **w****)：**安装 OMO 后，只需在对话框输入 outlaw 或简写 w，就能激活“全自动模式” 。Sisyphus 会自动拆解你的需求，并在后台并行启动多个 Agent 同时干活，全程零人工干预。

项目记忆：`.agency.md`

如何让 AI 真正懂你的代码风格，而不是每次都乱写？答案是建立“记忆”。

什么是 .agency.md****： 这是一个 Markdown 文件，相当于项目的“说明书”或“宪法”。它记录了你的项目是做什么的、技术栈是什么（如 Next.js + Tailwind）、以及必须遵守的代码规范。
如何生成： 不需要手写。在一个新项目中，运行 /init 命令，OpenCode 会自动通读整个项目，生成一份标准的 .agency.md 放在 .opencode 目录下。以后每次对话，AI 都会先读这份“记忆”，保证输出代码风格的一致性。

技能扩展 (Skills)

你可以把重复性的工作流程封装成“技能包”，让 AI 学会标准操作。

标准化流程： 比如“出差报销”或“UI 组件设计规范”。你可以定义好步骤：第一步找谁签字，第二步核对金额。
智能加载： OpenCode 的 Skills 采用“懒加载”机制。它不会把所有规章制度一次性塞给 AI（浪费 Token），只有当检测到你通过关键词触发该技能时，才会读取相关文件。
兼容性： 如果你之前用过 Claude Code 的 Skills，直接把 .cloud 目录改名为 .opencode 就能无缝迁移。

连接世界：MCP (Model Context Protocol)

通过配置 MCP，你可以让 OpenCode 联网，不再局限于本地闭门造车。

能力边界突破：
- Web Search： 接入 Brave Search 或 Google Search，让 AI 自行搜索最新的 API 文档或解决方案。
- GitHub 检索： 快速搜索 GitHub 上的相关代码库作为参考。
配置方式： 修改配置文件中的 MCP 部分，支持本地命令 (Local) 和远程服务器 (Remote) 两种连接方式。

横向对比 (Comparison)

在 AI 编程工具百花齐放的今天，OpenCode 到底处于什么位置？我们将它与目前最主流的竞品进行对比。

vs. Claude Code

OpenCode 最初就是作为 Claude Code 的开源替代品而诞生的，两者在使用体验上非常相似，但在灵活性上 OpenCode 更胜一筹。

优势：
- 无封号风险： Claude Code 有严格的地区和频率限制，容易封号；OpenCode 完全开源（MIT 协议），彻底解决了这一痛点。
- 成本可控： 它是目前唯一能让你一目了然看到 Token 消耗的工具。
- 模型自由： 不强制绑定 Claude 模型。你可以用 Gemini、GPT-4，甚至通过 OpenRouter 使用 DeepSeek，选择权在你手中。
- 功能完整： 相比 Claude Code，OpenCode 对 LSP（语言服务器协议）的支持更加完整和稳定。
劣势：
- 需要自己配置 API Key，不像 Claude Code 那样登录即用官方全家桶（虽然 OpenCode 也有内置免费模型）。

vs. Cursor / Windsurf

定位不同： Cursor 和 Windsurf 本质上是IDE（编辑器），它们不仅是 AI，还是写代码的工具；而 OpenCode 更像是一个独立的 AI 员工（Agent）。
协作模式： Cursor 适合你在写代码时让 AI 补全或修改当前文件；OpenCode 更适合处理复杂的、跨文件的任务（如“重构整个模块”、“修复 Bug”），你只需要下达指令，它就能在后台自主规划和执行，甚至通过 OMO 插件并行处理多个任务。

结语 (Conclusion)

OpenCode 不仅仅是一个免费的“平替”，它代表了 AI 编程工具的一种新方向：开源、透明、且高度可定制。
无论你是想白嫖免费模型练手的新手小白，还是追求极致效率、希望组建 AI 开发团队（Sisyphus 军团）的资深开发者，OpenCode 都能给你带来惊喜。它让“一人抵一个开发团队”不再是一句空话。
工具的价值在于使用。现在就打开终端，输入 npx open-code，开启你的 AI 结对编程之旅吧！
随着不断探索，持续更新最新内容，欢迎收藏关注。

常见问题 (FAQ)

Q: 安装时报错，提示权限不足怎么办？
A: 如果使用 npm install -g 报错，通常是 Node.js 目录权限问题。Mac/Linux 用户可以尝试在命令前加 sudo，或者直接使用 npx open-code 免安装运行。

Q: 如何切换不同的 AI 模型？
A: 在对话框中输入斜杠命令 /model，即可呼出模型选择列表。你可以随时在免费模型（如 Gemini 4.7）和付费模型（如 Claude 3.5 Sonnet）之间切换。

Q: 它可以并行处理多个任务吗？
A: 可以。OpenCode 引入了 Session（会话）概念。你可以通过 /ne 命令开启新会话，此时旧会话会在后台保持运行。你可以像老板一样，同时指挥多个 Session 帮你干活。

Q: 之前的 Claude Code 的技能（Skills）能直接用吗？
A: 完全可以。OpenCode 完美兼容 Claude Code 的生态。你只需要把原来文件夹中的 .cloud 重命名为 .opencode，以前积累的 Skills 就能直接加载。

Q: 上下文太长了怎么办？
A: 输入 /compact 命令。它会自动压缩之前的对话历史，提炼成摘要，从而释放上下文窗口，节省 Token 并提高响应速度。

参考

OpenCode官网：https://opencode.ai/
OpenCode的GitHub地址：https://github.com/anomalyco/opencode

引言 (Introduction)

它的核心优势在于极致的灵活与低门槛：

开箱即用（免费）： 内置了 Gemini 4.7、MiniMax 2.1 等高性能免费模型，小白也能零成本上手体验 AI 编程的乐趣。
全模型兼容： 只要有 API Key，你就可以接入 OpenAI、Claude、DeepSeek 等各家顶尖模型，甚至通过 OpenRouter 接入市面上几乎所有的 AI 模型。

概况 (Overview)

OpenCode官网：https://opencode.ai/
OpenCode的GitHub地址：https://github.com/anomalyco/opencode

为了适应不同用户的使用习惯，OpenCode 目前提供了四种主要的存在形态：

命令行工具 (CLI)这是功能最全、最原生的版本。通过 Node.js 的 npm 命令即可轻松安装，轻量且高效，是目前最推荐的使用方式。
桌面客户端 (Desktop)专为不喜欢黑色终端窗口的用户设计。它拥有简洁清爽的图形化界面，虽然目前仍处于 Beta 测试阶段（Bug 可能稍多），但对于非技术背景的用户来说，是体验 AI 编程门槛最低的入口。
编辑器插件 (VS Code Extension)可以直接在 VS Code 或 Cursor 的扩展商店中搜索安装。它的优势在于“沉浸感”：能自动关联当前打开的代码文件，你只需选中代码并通过快捷键，就能将其投喂给 AI 进行分析或重构。
云端运行环境 (Cloud / GitHub Actions)这是最高阶的玩法。将 OpenCode 集成到 GitHub 仓库后，它就变成了一个云端员工。你只需提交一个 Issue，它就能在后台自动分析问题、修复 Bug，并直接提交代码合并请求 (Pull Request)，全程无需人工干预。

使用指南 (User Guide)

命令行工具（CLI）中使用

安装OpenCode命令行工具（CLI）

OpenCode 的安装非常轻量，它基于 Node.js 环境。

环境准备： 确保你的电脑上安装了 Node.js（建议版本较高）。
一键安装CLI： 打开终端（Terminal 或 CMD），输入以下命令即可：
npm i -g opencode-ai
或者使用 npx 直接运行（无需安装）：
npx open-code
Mac 用户特别通道： 如果你是 macOS 用户，也可以使用 Homebrew 快速安装：
brew install open-code

初始化和基础用法

安装完成后，在终端terminal中输入 opencode 即可启动。

对话框类输入内容聊天，就像使用AI聊天框一样
输入/，唤起不同的功能服务，例如：/models唤起模型配置服务

模型配置 (Configuration)

初次启动时，软件会引导你进行简单的配置。

启用免费“真香”模型：OpenCode 对新手最友好的地方在于内置了免费模型。启动后输入 /models 命令，你会看到带有 free 标记的模型。
- 推荐： GLM 4.7 或 MiniMax 2.1。这两个模型的编程能力非常不错，且完全免费，零配置开箱即用。
接入最强模型（进阶）：
如果你追求极致的编程体验，可以将它连接到更强大的模型：
- OpenRouter： 输入 /models 后选择 OpenRouter，填入 API Key，即可使用 DeepSeek、Claude 3.5 Sonnet 等市面上几乎所有的模型。
- OpenAI / Anthropic： 同样支持直接输入官方 API Key 接入 GPT-4 或 Claude 系列。

核心模式与工作流 (Core Modes)

OpenCode 的工作流设计非常符合开发直觉，主要分为两种模式：

Plan 模式 (策划)：这是默认模式。AI 在这里充当“产品经理”或“架构师”。它会和你沟通需求、拆解任务、制定详细的开发计划，但不会直接修改代码。
- 适用场景： 需求分析、技术选型、复杂功能的头脑风暴。
Build 模式 (构建)：当计划确认无误后，通过按 Tab 键（或在对话中指示）切换到 Build 模式。此时 AI 变身为“资深程序员”，拥有读写文件、运行终端命令的权限，开始自动写代码、跑测试、修 Bug 。
Session 管理 (多任务并行)：
OpenCode 引入了 Session（会话）的概念。
- 新开任务： 输入 /ne 命令可以开启一个全新的 Session，清理上下文以便开始新任务。
- 并行开发： 它是支持后台运行的！你可以同时开启多个 Session，让一个 AI 在后台写前端，另一个在后台写后端，互不干扰，极大提升效率。

插件中使用

安装和使用

通过Extensions搜索安装

使用

打开命令面板
Wine：Ctrl+Shift+P
Mac：Cmd+Shift+P
快速复制复用代码
Win：Ctrl+Alt+K
Mac：Cmd+Option+K

场景化用例 (Use Cases)

光说不练假把式，OpenCode 到底能帮我们干什么？以下是三个覆盖不同需求的典型实战场景：

从零打造：极速构建 Web 应用

如果你有一个点子，OpenCode 能在几分钟内帮你把它变成现实。

案例： 创建一个现代化的数据分析仪表盘（Dashboard）。
操作流程：
1. 下达指令： 输入提示词，要求包含“数据可视化、实时更新、深色模式支持” 。
2. 自动执行： 切换到 Build 模式，AI 会自动规划文件结构、编写 HTML/CSS/JS 代码，甚至处理复杂的图表逻辑。
3. 成果： 几分钟后，一个交互流畅、具备动态效果的仪表盘就完成了，全程无需手动编写一行代码。

存量改造：给现有 App 加功能

OpenCode 的强大之处在于它能“读懂”你现有的复杂项目，而非仅仅处理单个文件。

案例： 给一个已有的 iOS 原生背单词 App 增加“判断题”或“专注计时器”功能。
核心步骤：
1. 建立认知 (/init)： 在项目根目录运行 /init 命令。OpenCode 会扫描整个项目，生成一个 .opencode/agent.md (或 .agency.md) 文件，里面记录了项目的技术栈、架构和代码规范。
2. 精准修改： 开启新会话 (/ne)，提出需求。AI 会利用 LSP (语言服务器协议) 精准定位相关代码文件（如 Swift 文件），在不破坏原有逻辑的前提下新增功能。
3. 零错误交付： 实测中，它能一次性正确实现“下拉选择时间”、“倒计时逻辑”等功能，并自动通过编译。

云端雇员：自动化 Bug 修复

这是 OpenCode 最具科幻感的玩法——把它变成你的 GitHub “云端员工”。

案例： 自动修复用户提交的 Bug。
操作流程：
1. 配置环境： 将 OpenCode 集成到 GitHub Actions 中。
2. 触发任务： 当用户在 Issue 中反馈 Bug（例如“导航栏功能冲突”）时，你只需在评论区 @OpenCode 。
3. 自动闭环： OpenCode 会在云端自动运行，定位问题，修复代码，并提交一个 Pull Request (PR)。你只需要点击“合并”即可。

隐藏技巧/高级玩法 (Advanced Tips)

如果你以为 OpenCode 只是一个像 GitHub Copilot 那样的代码补全工具，那你就太小看它了。配合以下高级玩法，它能真正实现“一人抵一个开发团队”。

插件：opencode-antigravity-auth

地址：https://github.com/NoeFabris/opencode-antigravity-auth

调用Antigravity内置的AI模型

神级插件：Oh My OpenCode (OMO)

这是 OpenCode 目前最强的开源插件，安装它之后，你的 AI 助手将进化为一个完整的 AI 开发团队 。

团队角色分工： OMO 不再让一个模型干所有的活，而是引入了多个专业智能体 (Agents)：
- Sisyphus (西西弗斯)： 主控智能体，负责指挥、派发任务和验证结果。
- Oracle (先知)： 负责架构设计和复杂 Bug 修复。
- Frontend (前端专家)： 专精 UI/UX 设计，甚至能调用 Gemini 1.5 Pro 这种多模态模型来处理视觉任务。
魔法咒语 (****outlaw / **w****)：**安装 OMO 后，只需在对话框输入 outlaw 或简写 w，就能激活“全自动模式” 。Sisyphus 会自动拆解你的需求，并在后台并行启动多个 Agent 同时干活，全程零人工干预。

项目记忆：`.agency.md`

如何让 AI 真正懂你的代码风格，而不是每次都乱写？答案是建立“记忆”。

什么是 .agency.md****： 这是一个 Markdown 文件，相当于项目的“说明书”或“宪法”。它记录了你的项目是做什么的、技术栈是什么（如 Next.js + Tailwind）、以及必须遵守的代码规范。
如何生成： 不需要手写。在一个新项目中，运行 /init 命令，OpenCode 会自动通读整个项目，生成一份标准的 .agency.md 放在 .opencode 目录下。以后每次对话，AI 都会先读这份“记忆”，保证输出代码风格的一致性。

技能扩展 (Skills)

你可以把重复性的工作流程封装成“技能包”，让 AI 学会标准操作。

标准化流程： 比如“出差报销”或“UI 组件设计规范”。你可以定义好步骤：第一步找谁签字，第二步核对金额。
智能加载： OpenCode 的 Skills 采用“懒加载”机制。它不会把所有规章制度一次性塞给 AI（浪费 Token），只有当检测到你通过关键词触发该技能时，才会读取相关文件。
兼容性： 如果你之前用过 Claude Code 的 Skills，直接把 .cloud 目录改名为 .opencode 就能无缝迁移。

连接世界：MCP (Model Context Protocol)

通过配置 MCP，你可以让 OpenCode 联网，不再局限于本地闭门造车。

能力边界突破：
- Web Search： 接入 Brave Search 或 Google Search，让 AI 自行搜索最新的 API 文档或解决方案。
- GitHub 检索： 快速搜索 GitHub 上的相关代码库作为参考。
配置方式： 修改配置文件中的 MCP 部分，支持本地命令 (Local) 和远程服务器 (Remote) 两种连接方式。

横向对比 (Comparison)

在 AI 编程工具百花齐放的今天，OpenCode 到底处于什么位置？我们将它与目前最主流的竞品进行对比。

vs. Claude Code

OpenCode 最初就是作为 Claude Code 的开源替代品而诞生的，两者在使用体验上非常相似，但在灵活性上 OpenCode 更胜一筹。

优势：
- 无封号风险： Claude Code 有严格的地区和频率限制，容易封号；OpenCode 完全开源（MIT 协议），彻底解决了这一痛点。
- 成本可控： 它是目前唯一能让你一目了然看到 Token 消耗的工具。
- 模型自由： 不强制绑定 Claude 模型。你可以用 Gemini、GPT-4，甚至通过 OpenRouter 使用 DeepSeek，选择权在你手中。
- 功能完整： 相比 Claude Code，OpenCode 对 LSP（语言服务器协议）的支持更加完整和稳定。
劣势：
- 需要自己配置 API Key，不像 Claude Code 那样登录即用官方全家桶（虽然 OpenCode 也有内置免费模型）。

vs. Cursor / Windsurf

定位不同： Cursor 和 Windsurf 本质上是IDE（编辑器），它们不仅是 AI，还是写代码的工具；而 OpenCode 更像是一个独立的 AI 员工（Agent）。
协作模式： Cursor 适合你在写代码时让 AI 补全或修改当前文件；OpenCode 更适合处理复杂的、跨文件的任务（如“重构整个模块”、“修复 Bug”），你只需要下达指令，它就能在后台自主规划和执行，甚至通过 OMO 插件并行处理多个任务。

结语 (Conclusion)

常见问题 (FAQ)

Q: 上下文太长了怎么办？
A: 输入 /compact 命令。它会自动压缩之前的对话历史，提炼成摘要，从而释放上下文窗口，节省 Token 并提高响应速度。

参考

OpenCode官网：https://opencode.ai/
OpenCode的GitHub地址：https://github.com/anomalyco/opencode

引言 (Introduction)

它的核心优势在于极致的灵活与低门槛：

开箱即用（免费）： 内置了 Gemini 4.7、MiniMax 2.1 等高性能免费模型，小白也能零成本上手体验 AI 编程的乐趣。
全模型兼容： 只要有 API Key，你就可以接入 OpenAI、Claude、DeepSeek 等各家顶尖模型，甚至通过 OpenRouter 接入市面上几乎所有的 AI 模型。

概况 (Overview)

OpenCode官网：https://opencode.ai/
OpenCode的GitHub地址：https://github.com/anomalyco/opencode

为了适应不同用户的使用习惯，OpenCode 目前提供了四种主要的存在形态：

命令行工具 (CLI)这是功能最全、最原生的版本。通过 Node.js 的 npm 命令即可轻松安装，轻量且高效，是目前最推荐的使用方式。
桌面客户端 (Desktop)专为不喜欢黑色终端窗口的用户设计。它拥有简洁清爽的图形化界面，虽然目前仍处于 Beta 测试阶段（Bug 可能稍多），但对于非技术背景的用户来说，是体验 AI 编程门槛最低的入口。
编辑器插件 (VS Code Extension)可以直接在 VS Code 或 Cursor 的扩展商店中搜索安装。它的优势在于“沉浸感”：能自动关联当前打开的代码文件，你只需选中代码并通过快捷键，就能将其投喂给 AI 进行分析或重构。
云端运行环境 (Cloud / GitHub Actions)这是最高阶的玩法。将 OpenCode 集成到 GitHub 仓库后，它就变成了一个云端员工。你只需提交一个 Issue，它就能在后台自动分析问题、修复 Bug，并直接提交代码合并请求 (Pull Request)，全程无需人工干预。

使用指南 (User Guide)

命令行工具（CLI）中使用

安装OpenCode命令行工具（CLI）

OpenCode 的安装非常轻量，它基于 Node.js 环境。

环境准备： 确保你的电脑上安装了 Node.js（建议版本较高）。
一键安装CLI： 打开终端（Terminal 或 CMD），输入以下命令即可：
npm i -g opencode-ai
或者使用 npx 直接运行（无需安装）：
npx open-code
Mac 用户特别通道： 如果你是 macOS 用户，也可以使用 Homebrew 快速安装：
brew install open-code

初始化和基础用法

安装完成后，在终端terminal中输入 opencode 即可启动。

对话框类输入内容聊天，就像使用AI聊天框一样
输入/，唤起不同的功能服务，例如：/models唤起模型配置服务

模型配置 (Configuration)

初次启动时，软件会引导你进行简单的配置。

启用免费“真香”模型：OpenCode 对新手最友好的地方在于内置了免费模型。启动后输入 /models 命令，你会看到带有 free 标记的模型。
- 推荐： GLM 4.7 或 MiniMax 2.1。这两个模型的编程能力非常不错，且完全免费，零配置开箱即用。
接入最强模型（进阶）：
如果你追求极致的编程体验，可以将它连接到更强大的模型：
- OpenRouter： 输入 /models 后选择 OpenRouter，填入 API Key，即可使用 DeepSeek、Claude 3.5 Sonnet 等市面上几乎所有的模型。
- OpenAI / Anthropic： 同样支持直接输入官方 API Key 接入 GPT-4 或 Claude 系列。

核心模式与工作流 (Core Modes)

OpenCode 的工作流设计非常符合开发直觉，主要分为两种模式：

Plan 模式 (策划)：这是默认模式。AI 在这里充当“产品经理”或“架构师”。它会和你沟通需求、拆解任务、制定详细的开发计划，但不会直接修改代码。
- 适用场景： 需求分析、技术选型、复杂功能的头脑风暴。
Build 模式 (构建)：当计划确认无误后，通过按 Tab 键（或在对话中指示）切换到 Build 模式。此时 AI 变身为“资深程序员”，拥有读写文件、运行终端命令的权限，开始自动写代码、跑测试、修 Bug 。
Session 管理 (多任务并行)：
OpenCode 引入了 Session（会话）的概念。
- 新开任务： 输入 /ne 命令可以开启一个全新的 Session，清理上下文以便开始新任务。
- 并行开发： 它是支持后台运行的！你可以同时开启多个 Session，让一个 AI 在后台写前端，另一个在后台写后端，互不干扰，极大提升效率。

插件中使用

安装和使用

通过Extensions搜索安装

使用

打开命令面板
Wine：Ctrl+Shift+P
Mac：Cmd+Shift+P
快速复制复用代码
Win：Ctrl+Alt+K
Mac：Cmd+Option+K

场景化用例 (Use Cases)

光说不练假把式，OpenCode 到底能帮我们干什么？以下是三个覆盖不同需求的典型实战场景：

从零打造：极速构建 Web 应用

如果你有一个点子，OpenCode 能在几分钟内帮你把它变成现实。

案例： 创建一个现代化的数据分析仪表盘（Dashboard）。
操作流程：
1. 下达指令： 输入提示词，要求包含“数据可视化、实时更新、深色模式支持” 。
2. 自动执行： 切换到 Build 模式，AI 会自动规划文件结构、编写 HTML/CSS/JS 代码，甚至处理复杂的图表逻辑。
3. 成果： 几分钟后，一个交互流畅、具备动态效果的仪表盘就完成了，全程无需手动编写一行代码。

存量改造：给现有 App 加功能

OpenCode 的强大之处在于它能“读懂”你现有的复杂项目，而非仅仅处理单个文件。

案例： 给一个已有的 iOS 原生背单词 App 增加“判断题”或“专注计时器”功能。
核心步骤：
1. 建立认知 (/init)： 在项目根目录运行 /init 命令。OpenCode 会扫描整个项目，生成一个 .opencode/agent.md (或 .agency.md) 文件，里面记录了项目的技术栈、架构和代码规范。
2. 精准修改： 开启新会话 (/ne)，提出需求。AI 会利用 LSP (语言服务器协议) 精准定位相关代码文件（如 Swift 文件），在不破坏原有逻辑的前提下新增功能。
3. 零错误交付： 实测中，它能一次性正确实现“下拉选择时间”、“倒计时逻辑”等功能，并自动通过编译。

云端雇员：自动化 Bug 修复

这是 OpenCode 最具科幻感的玩法——把它变成你的 GitHub “云端员工”。

案例： 自动修复用户提交的 Bug。
操作流程：
1. 配置环境： 将 OpenCode 集成到 GitHub Actions 中。
2. 触发任务： 当用户在 Issue 中反馈 Bug（例如“导航栏功能冲突”）时，你只需在评论区 @OpenCode 。
3. 自动闭环： OpenCode 会在云端自动运行，定位问题，修复代码，并提交一个 Pull Request (PR)。你只需要点击“合并”即可。

隐藏技巧/高级玩法 (Advanced Tips)

如果你以为 OpenCode 只是一个像 GitHub Copilot 那样的代码补全工具，那你就太小看它了。配合以下高级玩法，它能真正实现“一人抵一个开发团队”。

插件：opencode-antigravity-auth

地址：https://github.com/NoeFabris/opencode-antigravity-auth

调用Antigravity内置的AI模型

神级插件：Oh My OpenCode (OMO)

这是 OpenCode 目前最强的开源插件，安装它之后，你的 AI 助手将进化为一个完整的 AI 开发团队 。

团队角色分工： OMO 不再让一个模型干所有的活，而是引入了多个专业智能体 (Agents)：
- Sisyphus (西西弗斯)： 主控智能体，负责指挥、派发任务和验证结果。
- Oracle (先知)： 负责架构设计和复杂 Bug 修复。
- Frontend (前端专家)： 专精 UI/UX 设计，甚至能调用 Gemini 1.5 Pro 这种多模态模型来处理视觉任务。
魔法咒语 (****outlaw / **w****)：**安装 OMO 后，只需在对话框输入 outlaw 或简写 w，就能激活“全自动模式” 。Sisyphus 会自动拆解你的需求，并在后台并行启动多个 Agent 同时干活，全程零人工干预。

项目记忆：`.agency.md`

如何让 AI 真正懂你的代码风格，而不是每次都乱写？答案是建立“记忆”。

什么是 .agency.md****： 这是一个 Markdown 文件，相当于项目的“说明书”或“宪法”。它记录了你的项目是做什么的、技术栈是什么（如 Next.js + Tailwind）、以及必须遵守的代码规范。
如何生成： 不需要手写。在一个新项目中，运行 /init 命令，OpenCode 会自动通读整个项目，生成一份标准的 .agency.md 放在 .opencode 目录下。以后每次对话，AI 都会先读这份“记忆”，保证输出代码风格的一致性。

技能扩展 (Skills)

你可以把重复性的工作流程封装成“技能包”，让 AI 学会标准操作。

标准化流程： 比如“出差报销”或“UI 组件设计规范”。你可以定义好步骤：第一步找谁签字，第二步核对金额。
智能加载： OpenCode 的 Skills 采用“懒加载”机制。它不会把所有规章制度一次性塞给 AI（浪费 Token），只有当检测到你通过关键词触发该技能时，才会读取相关文件。
兼容性： 如果你之前用过 Claude Code 的 Skills，直接把 .cloud 目录改名为 .opencode 就能无缝迁移。

连接世界：MCP (Model Context Protocol)

通过配置 MCP，你可以让 OpenCode 联网，不再局限于本地闭门造车。

能力边界突破：
- Web Search： 接入 Brave Search 或 Google Search，让 AI 自行搜索最新的 API 文档或解决方案。
- GitHub 检索： 快速搜索 GitHub 上的相关代码库作为参考。
配置方式： 修改配置文件中的 MCP 部分，支持本地命令 (Local) 和远程服务器 (Remote) 两种连接方式。

横向对比 (Comparison)

在 AI 编程工具百花齐放的今天，OpenCode 到底处于什么位置？我们将它与目前最主流的竞品进行对比。

vs. Claude Code

OpenCode 最初就是作为 Claude Code 的开源替代品而诞生的，两者在使用体验上非常相似，但在灵活性上 OpenCode 更胜一筹。

优势：
- 无封号风险： Claude Code 有严格的地区和频率限制，容易封号；OpenCode 完全开源（MIT 协议），彻底解决了这一痛点。
- 成本可控： 它是目前唯一能让你一目了然看到 Token 消耗的工具。
- 模型自由： 不强制绑定 Claude 模型。你可以用 Gemini、GPT-4，甚至通过 OpenRouter 使用 DeepSeek，选择权在你手中。
- 功能完整： 相比 Claude Code，OpenCode 对 LSP（语言服务器协议）的支持更加完整和稳定。
劣势：
- 需要自己配置 API Key，不像 Claude Code 那样登录即用官方全家桶（虽然 OpenCode 也有内置免费模型）。

vs. Cursor / Windsurf

定位不同： Cursor 和 Windsurf 本质上是IDE（编辑器），它们不仅是 AI，还是写代码的工具；而 OpenCode 更像是一个独立的 AI 员工（Agent）。
协作模式： Cursor 适合你在写代码时让 AI 补全或修改当前文件；OpenCode 更适合处理复杂的、跨文件的任务（如“重构整个模块”、“修复 Bug”），你只需要下达指令，它就能在后台自主规划和执行，甚至通过 OMO 插件并行处理多个任务。

结语 (Conclusion)

常见问题 (FAQ)

Q: 上下文太长了怎么办？
A: 输入 /compact 命令。它会自动压缩之前的对话历史，提炼成摘要，从而释放上下文窗口，节省 Token 并提高响应速度。

参考

OpenCode官网：https://opencode.ai/
OpenCode的GitHub地址：https://github.com/anomalyco/opencode

引言 (Introduction)

概况 (Overview)

使用指南 (User Guide)

命令行工具（CLI）中使用

安装OpenCode命令行工具（CLI）

初始化和基础用法

模型配置 (Configuration)

核心模式与工作流 (Core Modes)

插件中使用

安装和使用

使用

场景化用例 (Use Cases)

从零打造：极速构建 Web 应用

存量改造：给现有 App 加功能

云端雇员：自动化 Bug 修复

隐藏技巧/高级玩法 (Advanced Tips)

插件：opencode-antigravity-auth

神级插件：Oh My OpenCode (OMO)

项目记忆：.agency.md

技能扩展 (Skills)

连接世界：MCP (Model Context Protocol)

横向对比 (Comparison)

vs. Claude Code

vs. Cursor / Windsurf

结语 (Conclusion)

常见问题 (FAQ)

参考

引言 (Introduction)

概况 (Overview)

使用指南 (User Guide)

命令行工具（CLI）中使用

安装OpenCode命令行工具（CLI）

初始化和基础用法

模型配置 (Configuration)

核心模式与工作流 (Core Modes)

插件中使用

安装和使用

使用

场景化用例 (Use Cases)

从零打造：极速构建 Web 应用

存量改造：给现有 App 加功能

云端雇员：自动化 Bug 修复

隐藏技巧/高级玩法 (Advanced Tips)

插件：opencode-antigravity-auth

神级插件：Oh My OpenCode (OMO)

项目记忆：.agency.md

技能扩展 (Skills)

连接世界：MCP (Model Context Protocol)

横向对比 (Comparison)

vs. Claude Code

vs. Cursor / Windsurf

结语 (Conclusion)

常见问题 (FAQ)

参考

引言 (Introduction)

概况 (Overview)

使用指南 (User Guide)

命令行工具（CLI）中使用

安装OpenCode命令行工具（CLI）

初始化和基础用法

模型配置 (Configuration)

核心模式与工作流 (Core Modes)

插件中使用

安装和使用

使用

场景化用例 (Use Cases)

从零打造：极速构建 Web 应用

存量改造：给现有 App 加功能

云端雇员：自动化 Bug 修复

隐藏技巧/高级玩法 (Advanced Tips)

插件：opencode-antigravity-auth

神级插件：Oh My OpenCode (OMO)

项目记忆：.agency.md

技能扩展 (Skills)

连接世界：MCP (Model Context Protocol)

横向对比 (Comparison)

vs. Claude Code

vs. Cursor / Windsurf

结语 (Conclusion)

常见问题 (FAQ)

项目记忆：`.agency.md`

项目记忆：`.agency.md`

项目记忆：`.agency.md`