OpenCode + Oh My OpenCode 配置和开发教程

icodebase 20天前 AI基础 opencode 收藏

0 / 3204

如果你是编程新手，对 AI 辅助开发工具感兴趣，但又不知道从哪里入手，这个教程就是为你准备的。我们会一步一步走，从零开始安装、配置，到实际开发使用。整个过程像聊天一样简单，不需要高深的编程知识。

首先，简单介绍一下：

OpenCode ：这是一个开源的 AI 编程助手，像 Claude Code 的免费替代品。它可以帮你分析代码、生成功能、修改项目，支持多种 AI 模型（如 Claude、ChatGPT、Gemini）。它运行在终端里，超级方便。
Oh My OpenCode （也叫 Oh My Opencode）：这是 OpenCode 的增强插件，像“Oh My Zsh”一样，添加了更多强大功能。比如多 AI 模型协作、智能体系统（Agents）、提示词优化等，让开发效率翻倍。安装它后，OpenCode 会变得更智能。

教程基于官方文档和 GitHub README，假设你是 Windows、macOS 或 Linux 用户。如果卡壳了，可以参考视频教程（如 YouTube 上的 OpenCode 入门视频）。

第一步：准备前提条件

在开始前，确保你的电脑满足这些：

一个现代终端（命令行窗口）。推荐：
- macOS/Linux：用 Terminal 或安装 Alacritty。
- Windows：用 Windows Terminal（系统自带）或 WezTerm。
网络连接（安装时需要下载）。
可选：ChatGPT Plus、Claude Pro 或 Gemini 订阅（免费模型也能用，但付费的更强）。如果你有这些账号，准备好 API 密钥。
Node.js 或 Bun（Oh My OpenCode 需要）。如果没有，安装脚本会帮你处理。

如果你是纯小白，先打开你的终端（命令行）：

Windows：搜索“cmd”或“PowerShell”。
macOS：搜索“Terminal”。
Linux：Ctrl+Alt+T。

第二步：安装 OpenCode

OpenCode 安装超级简单，一行命令搞定。

打开终端，运行这个安装脚本：

curl -fsSL https://opencode.ai/install | bash

如果你是 Windows，用 PowerShell 运行：

Invoke-WebRequest -Uri https://opencode.ai/install -UseBasicParsing | Invoke-Expression

其他方式（如果 curl 不行）：
- 用 npm（需先安装 Node.js）：
```
npm install -g opencode-ai
```
- macOS 用 Homebrew：
```
brew install anomalyco/tap/opencode
```

验证安装：运行
```
opencode --version
```
如果显示版本号（如 1.0.150 或更高），就成功了！如果报错，检查网络或重启终端。

第三步：配置 OpenCode

配置主要是设置 AI 模型的 API 密钥，让 OpenCode 能调用 AI。

运行 OpenCode：
```
opencode
```
这会打开一个终端界面（TUI，像聊天窗口）。
在界面里输入命令 /connect，选择提供商（如 opencode、anthropic、openai、Google）。
- 推荐新手用 opencode （官方免费试用）：访问 opencode.ai/auth，登录，复制 API 密钥，粘贴到终端。
- 如果用 Claude：选 anthropic，输入你的 API 密钥（从 Claude 官网获取）。
- ChatGPT：选 openai，输入 OpenAI API 密钥。
- Gemini：选 Google，类似。
配置好后，退出（Ctrl+C），重启 opencode 测试。如果看到欢迎界面，就 OK 了。

高级配置（可选，新手可跳过）：编辑配置文件 ~/.config/opencode/opencode.json（Windows 是 %APPDATA%\opencode\opencode.json）。比如添加主题或键位。

第四步：安装 Oh My OpenCode

这个插件让 OpenCode 升级为“多 AI 团队”。安装基于你的订阅情况。

先确认你的订阅（用于配置参数）：
- Claude Pro/Max：用 --claude=yes 或 --claude=max20（max20 是高级模式）。
- ChatGPT Plus：用 --chatgpt=yes。
- Gemini：用 --gemini=yes。
- 没有就用 no。
安装 Bun（如果没装，Oh My 需要）：
```
curl -fsSL https://bun.sh/install | bash
```
重启终端。

一键安装 Oh My OpenCode：

bunx oh-my-opencode install --no-tui --claude=yes --chatgpt=yes --gemini=yes

替换参数根据你的订阅。比如只有 Claude：

bunx oh-my-opencode install --no-tui --claude=yes --chatgpt=no --gemini=no

如果 Bun 有问题，用 npx（需 Node.js）：

npx oh-my-opencode install --no-tui --claude=yes ...

验证：运行

cat ~/.config/opencode/opencode.json | grep "oh-my-opencode"

如果看到插件名，就安装成功了。

完成认证（如果用付费模型）：
- 运行 opencode auth login，选提供商，浏览器登录 OAuth。
- 对于 Gemini/ChatGPT，可能需额外插件（如 opencode-antigravity-auth），加到 opencode.json 的 plugin 数组里。

第五步：配置 Oh My OpenCode

配置在 JSON 文件里，新手用默认就行，但我们可以简单调整。

配置文件位置：
- 全局：~/.config/opencode/oh-my-opencode.json
- 项目级：在项目文件夹下创建 .opencode/oh-my-opencode.json

打开文件（用记事本或 VS Code），添加基本配置。例如：

{
  "google_auth": false,  // 如果用外部Gemini认证
  "agents": {
    "frontend-ui-ux-engineer": { "model": "google/gemini-3-pro-high" },  // 自定义模型
    "oracle": { "model": "openai/gpt-5.2" }  // 添加新Agent
  },
  "sisyphus_agent": { "disabled": false },  // 启用主编排器
  "background_task": { "defaultConcurrency": 5 }  // 并发任务数
}

新手提示：复制这个，改成你的模型。保存后，重启 opencode。

如果想禁用某些功能，加 "disabled_agents": ["某个agent名"]。

第六步：进入开发状态（实际使用）

现在，你可以开发了！OpenCode + Oh My 像一个 AI 团队，帮你写代码。

进入项目文件夹：

cd /path/to/your/project  // 替换成你的项目路径
opencode

初始化项目：
输入 /init，它会分析项目，生成 AGENTS.md 文件（定义编码规则）。
基本开发示例：
- 提问代码 ：输入“How does authentication work in main.js?”（Oh My 的 Agents 会帮分析）。
- 添加功能 ：切换到 Plan 模式（按 Tab 键，右下角显示 Plan）。
  输入： “Add a delete button for notes, flag as deleted in DB, and create a recovery screen.”
  AI 会生成计划。反馈后，切换回 Build 模式（Tab），输入“Go ahead!”让它执行代码修改。
- 用 Oh My 的超级功能 ：输入“ulw Add a REST API” （ulw 触发多 Agent 协作），AI 团队会自动分工（一个写前端，一个写后端）。
- 自定义 Agent ：输入“让 @oracle 设计数据库 schema。”（@oracle 是 Oh My 的智能体）。
其他命令：
- /undo：撤销修改。
- /redo：重做。
- /share：分享对话。

新手 Tips：

多用自然语言描述需求，像和朋友聊天。
如果卡住，输入 ulw 让 Oh My 全自动处理复杂任务。
测试代码：修改后，在终端运行你的项目（比如 node app.js），看效果。
学习更多：看 Oh My 的 Agents.md 文件，了解每个智能体的作用。

恭喜！你现在进入开发状态了！从简单项目开始练手，比如一个 TODO 列表 App。