一、OpenCode 是什么简介
OpenCode 是一款开源、免费的 AI 编程助手工具（不包含服务端大模型），支持在终端（TUI）、桌面应用和 IDE 中使用，可替代 Claude Code、Cursor 等商业工具客户端。OpenCode 是一款开源的 AI 编程智能体，它能在终端、桌面应用或主流 IDE 中帮助你理解代码库、编写功能、重构代码和修复 Bug，从而大幅提升开发效率 1。截至目前（2026年02月01号），它拥有超过 80,000 个 GitHub 星标和每月超过 150 万开发者使用，是目前最受欢迎的开源 AI 编程工具之一。
1.1 核心特点
• 100% 开源：采用 MIT 许可证，代码完全开放。
• 多模型支持：支持 Anthropic (Claude), OpenAI (GPT), Google (Gemini), 智谱 AI (GLM), MiniMax 等 75+ 模型提供商，您可以自由切换。
• UI 优先设计：为习惯命令行的开发者打造极致的终端体验，响应快速。
• 客户端/服务器架构：支持远程控制，甚至可以用手机驱动电脑上的 OpenCode。
• 强大的上下文感知：能分析整个项目代码库，通过 @ 符号引用文件，提供精准的代码修改和生成。
• 内置 LSP：开箱即用的语言服务器支持，提供智能诊断。
1.2 提供三种常用使用方式
• 终端界面（TUI）：专为终端用户设计，支持 Vim 风格快捷键
• 桌面应用：独立图形界面，从 GitHub Releases 或 官网 下载
• IDE 扩展：VSCode 等编辑器中的 AI 助手
1.3 核心价值
| 特性 | 说明 | 给你带来的价值 |
|---|---|---|
| 🔓 完全开源 | 代码透明，遵循MIT协议，可公开查阅、使用及修改。 | 自主可控，可根据自身需求自由定制、审计代码，无需担忧供应商锁定或数据隐私泄露问题。 |
| 🔄 多模型支持 | 兼容75+家模型提供商，涵盖OpenAI、Anthropic、Google等国际厂商，以及智谱AI、MiniMax等国产模型，同时支持Ollama等本地模型。 | 灵活自由，可根据具体任务需求、预算成本随时切换最优模型，摆脱单一厂商绑定的限制，提升使用灵活性。 |
| 💻 终端原生 | 配备精美终端用户界面（TUI），专为命令行环境优化适配，可与Vim/Neovim等常用开发工具深度集成。 | 高效流畅，无需切换操作环境、离开终端，即可完成AI辅助编程全流程，有效保持开发专注度，提升工作效率。 |
| 🤖 智能代理模式 | 提供Plan（只读规划）和Build（执行构建）双模式，支持通过oh-my-opencode等插件实现多代理协作。 | 安全可控，采用"先规划、再执行"的逻辑，有效避免AI误操作；多代理协同工作，可高效处理复杂开发任务。 |
| 🌐 多形态适配 | 以核心CLI（命令行界面）为基础，额外提供桌面应用（Beta版本）及VS Code等IDE插件，适配多种使用场景。 | 灵活使用，可匹配不同开发者的操作习惯，满足终端、桌面、IDE等多种使用场景需求，提升使用便捷度。 |
二、OpenCode 官网相关网址与第三方学习网址
2.1 官方相关链接
👉 官方网站：https://opencode.ai
👉 文档（最推荐阅读）：https://opencode.ai/docs
👉 GitHub 主仓库（最新活跃仓库）：https://github.com/anomalyco/opencode
👉 旧仓库（部分已归档历史版本）：https://github.com/opencode-ai/opencode
👉 桌面版下载：https://opencode.ai/download 或 GitHub Releases：https://github.com/anomalyco/opencode/releases
2.2 第三方学习网址
👉 非官方中文 OpenCode 网站：
👉 非官方中文 OpenCode 中文教程
2.3 官方订阅说明（截至2026年02月01日）
👉 OpenCode Zen 订阅与注册入口 --- 用于注册/登录并获取访问 Zen 的 API/订阅密钥
👉 OpenCode 官方文档 --- 官方 Zen 计费页面（含价格详情）计费和定价说明
三、OpenCode 安装与使用入门示例
官方推出了四种安装使用方式（支持跨平台）：OpenCode 终端 、OpenCode 桌面版、OpenCode 插件 （VSCode 插件、etBrains 等）、OpenCode 集成（GitHub、GitLab 等）。
本文以 Mac 系统安装为例，OpenCode 终端使用 HomeBrew 方式安装（也可以选择一键脚本：curl -fsSL https://opencode.ai/install | bash），OpenCode 桌面版下载 M芯片的安装包安装。
3.1 OpenCode 终端版安装（HomeBrew 方式）
brew install anomalyco/tap/opencode
验证安装，输入：
opencode --version
# 在终端输入启动命令
opencode
3.2 OpenCode 桌面版安装（可视化 UI 方式）
OpenCode内置了两个智能体(两种核心工作模式)，通过按 Tab 键切换：
build（构建模式）：默认模式，拥有完整权限，可以直接读取、修改文件并执行命令，用于实现功能或修复问题。
plan（规划模式）：只读模式，用于分析代码、审查或规划任务，不会直接修改文件，适合探索不熟悉的代码库。
3.3 VS Code 插件安装
在 VS Code 中搜索 OpenCode ，找到 OpenCode" 插件并安装，安装完成后重启 VS Code 即可使用。
3.4 OpenCode 常用快捷键与操作
（1）核心操作三件套
（2）常用斜杠命令
（3）全局提示词
（4）OpenCode 终端（CLI / TUI）快捷键与操作
（5）OpenCode 可视化界面（Desktop / GUI）
（6）使用小技巧
✅ 改造一段代码（安全）
```
@src/service/user.go
分析这段代码的问题，先给优化方案，不要直接修改
```
→ `/plan`
→ 确认
→ `/apply`
→ `/diff`
---
✅ 批量重构
```
@src/
统一把日志框架从 logrus 改为 zap
```
→ `/plan`（一定要先看）
→ `/apply`
---
✅ 只读审计（不会改代码）
```
@src/
这是生产代码，只做安全审计，不允许修改任何文件
```四、安装 Oh My OpenCode 扩展
Oh My OpenCode（简称 OMO，常被社区称为"神级插件"或"OpenCode 的 Claude Code 增强版"）是一个开源的 OpenCode 插件/扩展层，由 code-yeongyu 开发（GitHub 星数已超 26k+），它将 OpenCode 从单一 agent 升级为 多代理协作系统（multi-agent orchestration）。
核心亮点：
• Sisyphus Orchestrator（主协调代理，通常用 Claude Opus 4.5 或类似顶级模型）作为大脑，自动拆解复杂任务。
• 后台并行运行 7+ 个专业子代理（plan、build、research、lint、test、docs、cartography 等），分工明确，能处理大型项目、重构、从零建站等单代理容易崩的任务。
• 内置 30+ 高质量 skills（技能，如 MCP 工具链、LSP/AST 分析、代码地图、自动生成 docs/plans 等）。
• 支持 hooks、背景代理、Claude Code 兼容的 AGENTS.md / CLAUDE.md、tmux 监控等高级功能。
• 零学习曲线：安装后基本不用手动配，自动根据你有的订阅（Claude、OpenAI、Gemini、Zen 等）优化模型链。
• 社区评价极高，许多人称"用了 OMO 后 OpenCode 直接起飞，单代理时代结束了"。
• 完全免费开源（MIT 许可），不收费，但效果依赖你接入的 LLM 质量（推荐 Claude Pro/Max + Gemini 高额度）。
| 维度 | OpenCode (基础平台) | oh-my-opencode (扩展插件/框架) |
|---|---|---|
| 本质定位 | 核心引擎：提供最底层的运行环境和基础功能 API。 | 增强框架：基于核心平台的配置管理工具、插件集合和美化包。 |
| 依赖关系 | 独立存在，不依赖 oh-my-opencode。 | 寄生关系，必须先安装 OpenCode 才能运行。 |
| 上手难度 | 高：通常需要手动编写配置文件，从零开始搭建环境。 | 极低：通常提供"开箱即用"的默认配置，一键安装。 |
| 功能体验 | 朴素：只有最基本的功能，界面通常较为原始。 | 丰富：集成了常用插件、自动补全、语法高亮、快捷键别名等。 |
| 个性化 | 需要用户自己懂底层配置语法，手动修改。 | 提供现成的主题 (Themes) 和插件 (Plugins) 列表，切换简单。 |
| 运行效率 | 极快：因为没有加载额外脚本，启动速度最快。 | 略慢：加载了大量插件和美化脚本，启动速度可能受微小影响。 |
| 适用人群 | 高级开发者，喜欢极简主义，或想要完全掌控细节的人。 | 大多数开发者，希望提高效率、界面美观、不想折腾配置的人。 |
4.1 官方链接
👉 **GitHub 主仓库：**https://github.com/code-yeongyu/oh-my-opencode
👉 **英文文档首页：**https://github.com/code-yeongyu/oh-my-opencode/blob/dev/README.md
👉 **中文文档首页：**https://github.com/code-yeongyu/oh-my-opencode/blob/dev/README.zh-cn.md
👉 **OpenCode 生态页提及：**https://opencode.ai/docs/ecosystem
4.2 Oh My OpenCode 安装与使用
安装oh-my-opencode也特别简单，在OpenCode中，新起一个对话，输入以下提示词即可让 AI 自动安装 Oh My OpenCode ：
按照以下说明安装和配置 oh-my-opencode：
https://raw.githubusercontent.com/code-yeongyu/oh-my-opencode/refs/heads/master/docs/guide/installation.md
安装过程中会问我们有没有御三家（Claude、ChatGPT、Gemini）的大模型订阅，我们如实回答就行(最新版本变成选项，根据提示选择即可)，没有就没有，有就是有（不是正经订阅，也要告诉人家，比如：没有Claude，但是我用的opencode-antigravity-auth，可以用Google上的Clude模型 等等）。
很快就安装完成了，如下：
但是回答了一堆英文完全看不懂，我们就告诉它：
我看不懂英文，请使用简体中文回复。
安装完成后，重启 OpenCode 即可使用 Oh My OpenCode 的全部功能。
没有自由的秩序和没有秩序的自由，同样具有破坏性。
