📋 目录

• 一、什么是 OpenCode？
• 二、四种安装形态
• 三、免费模型配置
• 四、核心功能亮点
• 五、Skills 技能迁移
• 六、MCP 配置
• 七、Oh My Open Code (OMO) 超强插件
• 八、其他实用功能
• 九、总结与推荐
• 十、实战记录：安装 Oh My OpenAgent
• 附录：踩坑记录

一、什么是 OpenCode？

OpenCode 是近期热度最高的 AI 编程工具，本质上是一个开源版的 Claude Code。它几乎复刻了 Claude Code 的所有核心功能，同时解决了 Claude Code 在中国用户中常见的限速、封号等痛点。

与 Claude Code 对比

核心定位

• 开源版 Claude Code：具备几乎全部功能，中国用户友好，不限速不封号
• 免费模型：开箱即用 GLM-4.7、MiniMax-2.1 等免费模型，零配置即可上手
• 顶级模型接入：通过 Antigravity 插件免费接入 Gemini 3 Pro、Claude 4.5 Opus；通过 /connect 接入 GPT Codex
• 杀手级功能：Session 并行、Timeline 回退、Share 分享、Ultra Work 多智能体协作
• 插件生态：Oh My Open Code (OMO) 集成七大编程智能体 + 三大 MCP Server + 多种工具

二、四种安装形态

⭐ 1. 命令行版（主力推荐）

最稳定、功能最全的使用方式。

1
2
3
4
5

# 安装（需先安装 Node.js）
npm i -g opencode-ai

# 启动
opencode

前置条件：需要安装 Node.js（前往 nodejs.org 下载对应系统版本）

2. 桌面客户端（Beta）

从官网下载客户端，一路下一步安装，选择项目文件夹即可使用。

⚠️ 目前处于 Beta 测试阶段，bug 较多，暂不推荐作为主力工具。

3. VS Code 插件版

前提：已安装命令行版 OpenCode。插件版的核心价值在于与 IDE 的无缝集成，让 AI 直接感知你的代码上下文。

1. 在 VS Code 扩展商店搜索 OpenCode 并安装
2. 快捷键 Ctrl + Shift + P → 输入 open opencode 回车
3. 插件会自动关联左侧窗口打开的代码文件
4. 选中代码后按 Ctrl + Alt + K 可快速粘贴到 OpenCode 聊天窗口

4. 云端运行环境（GitHub Actions）

非常适合开源项目的自动化 Issue 修复：

1. 将项目上传到 GitHub 公开仓库
2. 在仓库中配置 API Key（Settings → Secrets and Variables → Actions）
3. 在 Issue 评论中输入 /opencode + 需求描述
4. GitHub Actions 自动运行 OpenCode 工作流
5. 完成后自动创建 Pull Request

三、免费模型配置

查看可用模型

1

/models    # 查看所有可用模型（带 free 标记的即可免费使用）

推荐免费模型

💡 新手用这两个免费模型练习 AI 编程绰绰有余。

接入顶级模型

方式一：Antigravity 插件（免费接入 Gemini + Claude）

Antigravity 是 Google 推出的 AI 编程 IDE，它慷慨地免费提供了 Gemini 3 Pro 和 Claude 4.5 Opus。

1. 在 OpenCode 中粘贴安装提示词（从 Antigravity GitHub 首页复制）
2. 等待 AI 自动完成安装
3. 打开新终端执行登录命令，选择 Google → Antigravity 登录
4. 登录 Google 账户，粘贴生成的 URL
5. 重启 OpenCode，/models 即可看到 Gemini 3 Pro 和 Claude 4.5 Opus

方式二：GPT Codex（OpenAI 官方合作）

OpenAI 与 OpenCode 官宣合作，可直接接入 ChatGPT Codex。

1

/connect    # 选择 OpenAI → GPT Pro → 浏览器登录

前提：需要有 ChatGPT Plus 或以上订阅。

方式三：OpenRouter（万能接入）

通过 OpenRouter 可以接入市面上几乎所有大模型，国内用户也能方便获取额度。

1

/connect    # 选择 OpenRouter → 填写 API Key

OpenCode 支持 75 种 AI 接入方式，几乎囊括所有模型供应商。

四、核心功能亮点

1. 反问式需求澄清

在动手编码之前，OpenCode 会反向询问你一系列问题：

• 只需要代码样例，还是完整可运行的程序？
• 哪些功能是必须实现的？
• 调用哪个模型？
• 环境变量如何保存？

这种"先问清楚再动手"的机制，大幅减少了返工。

2. 命令行代码比对界面

OpenCode 的命令行 diff 展示被认为是所有命令行编程工具中做得最好的，代码变更一目了然。

⭐ 3. Session 并行处理

这是 OpenCode 最具特色的功能——多 Session 并行运行：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

# 发起第一个任务（如：增加计时器）
# 任务执行中，创建新 session
/new

# 发起第二个任务（如：画笔调色）
# 查看所有 session 状态
/sessions

# 在 session 间切换
/session <id>

打转符号表示 Session 正在后台运行。两个需求可以完全并行开发，互不干扰。

4. Timeline 检查点回退

1

/timeline    # 查看当前 Session 的完整对话记录

选择任意历史节点：

• Revert：将代码和聊天内容同时回退到该时间点
• View：查看当时 AI 做了什么修改

相当于编程过程中的"时光机"，可以大胆尝试不同方案。

5. Share 分享

1
2
3

/share      # 将对话记录分享为网页
/unshare    # 取消分享
/export     # 导出对话记录为文件

分享后生成一个网页链接，展示完整的对话记录和代码修改过程，方便与他人协作或展示。

五、Skills 技能迁移

OpenCode 完全兼容 Claude Code 的 Skills 目录结构，迁移成本极低：

1
2

# 目录结构对应关系
.claude/skills/<skill-name>/    →    .opencode/skills/<skill-name>/

操作步骤

1. 在项目根目录新建 .opencode 文件夹
2. 在 .opencode 下新建 skills 文件夹
3. 将原 .claude/skills/ 下的技能文件夹直接复制过来
4. 重启 OpenCode，AI 即可识别并调用这些 Skills

每个 Skill 就是一个带目录的说明书，告诉 AI 如何完成特定领域的任务。

六、MCP 配置

OpenCode 支持两种 MCP（Model Context Protocol）模式：

本地 MCP（Local）

通过本地命令执行。在 ~/.config/opencode/opencode.json 中配置：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

{
  "mcpServers": {
    "shed-cn": {
      "type": "local",
      "command": "npx",
      "args": ["shed-cn"],
      "enabled": true
    }
  }
}

远程 MCP（Remote）

通过 URL 远程调用。以 Context7 为例：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12

{
  "mcpServers": {
    "context7": {
      "type": "remote",
      "url": "https://context7-mcp-server-url",
      "headers": {
        "Authorization": "Bearer <your-api-key>"
      },
      "enabled": true
    }
  }
}

配置完成后重启 OpenCode，输入 /mcp 即可查看已配置的 MCP Server。

七、Oh My Open Code (OMO) 超强插件 ⭐

OMO 是 OpenCode 上最火的编程插件，本质上是 工具 + MCP + 编程 Agent 的组合捆绑包。

七大编程智能体

每个智能体都分配了最适合其工作的大模型，据作者称耗费了 24,000 美元的 Token 才找到最佳组合。

三大 MCP Server

• Web Search：网络搜索
• Context7：获取最新技术文档
• Grep App：GitHub 仓库快速代码搜索

集成工具

• LSP 高级版：通过编程语言的语法和语义帮助 AI 快速定位代码
• AST 工具：通过代码语法树进行关联搜索
• LOC 工具：借助多模态视觉能力理解图片、PDF
• Delegate Task / Background Task：Agent 任务分配和后台调度

安装与使用

配置文件位置：C:\Users\<用户名>\.config\opencode\oh-my-opencode.json

1. 从 OMO GitHub 首页复制 install 开头的提示词
2. 粘贴到 OpenCode 中，回答配置问题（订阅情况等）
3. 自动完成安装

两种核心用法

① @ 指定智能体

1

@前端工程师 帮我优化这个页面的响应式布局

② Ultra Work 模式（魔法词 ULW）

1

ULW 帮我创建一个宠物商店应用

Ultra Work 模式下，西西弗斯作为主智能体会：

• 将任务拆解成 Todo List
• 同时开启多个后台任务并行执行
• 居中调度各个智能体协同工作
• 最终交付完整项目

Ralph Loop 循环模式

强制 AI 长时间循环工作，适合极难任务：

1

/ralph-loop

示例：“使用 Spring Boot 4 最新标准重构整个项目，直到所有测试用例通过”——可以连续运行数小时直到任务完成。

八、其他实用功能

/init — 项目知识初始化

让 AI 通读整个项目文件夹，生成 agents.md 文件作为系统提示词，帮助 AI 快速了解项目。

/compact — 上下文压缩

将之前的对话提炼为简洁摘要，释放模型上下文窗口，避免 Token 超限。

自定义命令

在 ~/.config/opencode/commands/ 下创建 .md 文件定义自定义命令：

1
2
3
4

# 运行测试
模式：build
命令：npm test
描述：运行项目的全部测试用例

使用：/运行测试 即可触发。

自定义智能体

在 ~/.config/opencode/agents/ 下创建 .md 文件：

1
2
3
4

# Code Review Agent
类型：subagent
模型：claude-4.5-opus
描述：专门负责代码审查，检查代码质量、安全漏洞和最佳实践。

• Primary Agent：按 Tab 键切换，在对话中直接使用
• Sub Agent：由主智能体在后台自动调度

九、总结与推荐

适用场景

推荐配置路线

1
2
3
4
5
6
7

入门 → 命令行安装 + 内置免费模型
  ↓
进阶 → 配置 Antigravity 接入 Gemini/Claude
  ↓
高效 → 配置 Skills + MCP
  ↓
极限 → 安装 OMO 插件，开启 Ultra Work 模式

OpenCode 打破了 AI 编程工具的高门槛，让每个人都能以零成本开始探索 AI 辅助编程的无限可能。特别对于中国用户，不再需要担心限速和封号，可以"随便造、随便玩"。

十、实战记录：安装 Oh My OpenAgent

以下是笔者亲测安装 Oh My OpenAgent（原 Oh My Open Code）的完整对话记录，环境为 Windows + PowerShell。

环境检查

1
2

opencode --version
# 输出: 1.14.39

安装过程

在 OpenCode 对话中直接告诉 AI：

“Install and configure oh-my-openagent by following the instructions here: https://raw.githubusercontent.com/code-yeongyu/oh-my-openagent/refs/heads/dev/docs/guide/installation.md"

AI 会先询问你拥有的模型订阅情况：

⚠️ AI 会提示 “Without a Claude subscription, the Sisyphus agent might not work ideally”，但 GitHub Copilot 会作为后备模型自动接管。

确认订阅后，AI 自动执行安装命令：

1
2
3
4
5

bunx oh-my-openagent install --no-tui \
  --claude=no --openai=no --gemini=no \
  --copilot=yes --opencode-zen=yes \
  --zai-coding-plan=no --opencode-go=no \
  --kimi-for-coding=no --vercel-ai-gateway=no

安装成功的输出：

1
2
3
4

[1/4] Checking OpenCode installation...
[OK] OpenCode 1.14.39 detected
[2/4] Adding oh-my-openagent plugin...
[OK] Plugin added -> C:\Users\<用户名>\.config\opencode\opencode.json

安装后的配置文件

主配置文件 ~/.config/opencode/opencode.json：

1
2
3
4
5

{
  "plugin": [
    "oh-my-openagent@latest"
  ]
}

Agent 模型配置 ~/.config/opencode/oh-my-openagent.json：

AI 自动根据 GitHub Copilot 订阅分配了模型：

认证配置

安装完成后需要手动认证 GitHub Copilot：

1

opencode auth login

交互步骤：

1. 上下键选择 GitHub Copilot
2. 按回车确认
3. 浏览器自动打开，登录 GitHub 学生账号
4. 授权完成，终端显示认证成功

如何重新配置 Agent 模型？

方式一：直接告诉 AI

“把 Sisyphus 的模型改成 claude-sonnet-4.6” “Oracle 用 gpt-5.5”

方式二：手动编辑配置文件

直接修改 ~/.config/opencode/oh-my-openagent.json 中对应 agent 的 model 字段。

追加配置：补上 OpenCode Zen 作为备选

安装时遗漏了免费的 OpenCode Zen（--opencode-zen=no），后续在 OpenCode 新对话中直接让 AI 帮忙修正：

“其实我还有你免费的 OpenCode Zen，但是我已经登录 GitHub Copilot 了，你帮我修改一下”

AI 的第一次尝试把 OpenCode Zen 设成了主力（opencode/claude-opus-4-7），GitHub Copilot 变成了备选。实际需求是反过来的：

“不是，是 GitHub Copilot 作为主力，OpenCode Zen 自带的免费模型作为备选”

AI 修正后，最终配置策略：

1
2

主力模型: github-copilot/*     （已付费，优先使用）
备选模型: opencode/*           （免费额度，Copilot 不可用时自动切换）

关键配置片段（以 Sisyphus 为例）：

1
2
3
4
5
6
7
8
9

{
  "sisyphus": {
    "model": "github-copilot/claude-opus-4-7",
    "fallback_models": [
      { "model": "opencode/claude-opus-4-7" },
      { "model": "opencode/gpt-5.5" }
    ]
  }
}

💡 经验：描述配置需求时，主次关系要说清楚——“XX 作为主力，YY 作为备选”，避免 AI 搞反。

使用提示

安装完成后，在终端输入 opencode 即可开始：

• 在 prompt 中包含 ultrawork 或 ulw 触发自动并行处理
• 按 Tab 进入 Prometheus（规划器）模式
• 运行 /start-work 执行完整编排

附录：踩坑记录

📚 参考来源：技术爬爬虾 - OpenCode 详细攻略、Oh My OpenAgent 安装指南