OpenCode 接入教程

OpenCode 是一款基于 Go 的开源免费命令行编程工具 (CLI)，核心优势在于打破模型限制——你可以同时接入 Claude、GPT、Gemini 等模型自由切换。内置基于 Bubble Tea 的流畅 TUI 体验和 LSP 代码智能。

前置条件

1. 前往 RabbitCloud 控制台 注册并获取 API Key
2. 安装 Node.js 18+ (npm 方式) 或 bash (脚本方式)

1. 安装

macOS / Linux：

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

NPM 安装（全平台，推荐 Windows）：

npm i -g opencode-ai@latest

macOS Homebrew 桌面客户端：

brew install --cask opencode-desktop

2. API 配置

步骤 1：注册自定义服务商

安装后先不要启动 OpenCode，在终端执行：

opencode auth login

在服务商列表中选择 other（最下面，可搜索），然后：

• Provider ID： 输入 rabbitcloud（后续配置需一致）
• API Key： 输入从 RabbitCloud 控制台 获取的 Key

步骤 2：修改配置文件

编辑 ~/.config/opencode/opencode.json（Windows: C:\Users\你的用户名\.config\opencode\opencode.json）：

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "rabbitcloud": {
      "npm": "@ai-sdk/anthropic",
      "name": "RabbitCloud",
      "options": {
        "baseURL": "https://rabbitcloud.club/v1"
      },
      "models": {
        "claude-opus-4-6": {
          "name": "claude opus 4.6"
        },
        "claude-sonnet-4-5": {
          "name": "claude-sonnet-4-5"
        }
      }
    },
    "rabbitcloud-gpt": {
      "npm": "@ai-sdk/openai",
      "name": "RabbitCloud-GPT",
      "options": {
        "baseURL": "https://rabbitcloud.club/v1",
        "apiKey": "sk-你的GPT分组Key"
      },
      "models": {
        "gpt-4o": {
          "name": "gpt-4o"
        }
      }
    }
  }
}

⚠️ 注意： "rabbitcloud" 必须和步骤 1 输入的 Provider ID 完全一致。baseURL 必须以 /v1 结尾。想同时使用 GPT 模型需另建服务商条目。

步骤 3：启动

重启终端后运行 opencode，输入 /models 选择模型即可。

使用技巧

1. 利用会话管理保存和切换不同项目的对话
2. 在 models 中配置多个模型，按需切换
3. 善用 LSP 集成获取代码智能提示

---

💡 提示: 如果遇到问题，请先查看 常见问题 文档。如果依然无法解决，请携带完整报错截图前往首页，公告内添加客服联系方式，添加客服询问解决。