OpenCode 安装和配置指南

本指南将帮助你安装 OpenCode 并配置使用 CC Club 的 Claude 模型。

为什么需要特殊配置？

兼容性问题说明

模型 ID 格式不同：OpenCode 默认使用不带日期的 Anthropic 模型 ID（如 claude-sonnet-4-5），而 CC Club 使用带日期的模型 ID（如 claude-sonnet-4-5-20250929）。
需要模型映射：为了让 OpenCode 能够正确调用 CC Club 的模型，需要通过配置工具或中转服务来解决这个兼容性问题。
避免客户端限制：通过适当的配置可以避免官方提示不能使用 OpenCode 客户端的限制。

我们提供三种配置方法：

方法一（推荐）：直接编辑配置文件，最简单快捷
方法二：使用 CC Switch 桌面应用，可视化管理配置，一键切换
方法三（进阶）：通过 New API 中转服务，适合需要更多自定义配置的场景

方法一：直接配置（推荐）

这是最简单的配置方式，只需编辑 OpenCode 的配置文件即可。

安装 OpenCode

go install github.com/anomalyco/opencode@latest

brew install opencode

获取 CC Club API Key

访问获取 API Key 页面了解如何获取 CC Club 的 API Key。

编辑配置文件

编辑 ~/.config/opencode/opencode.json 文件（如果文件不存在则创建）：

cat ~/.config/opencode/opencode.json

{
  "provider": {
    "anthropic": {
      "options": {
        "baseURL": "https://claude-code.club/api/v1",
        "apiKey": "cr_你的API密钥"
      },
      "npm": "@ai-sdk/anthropic",
      "name": "cc-club(Claude)"
    }
  },
  "$schema": "https://opencode.ai/config.json"
}

⚠️

注意：请将 cr_你的API密钥 替换为你实际的 CC Club API Key。

CC Club API 地址

根据你的网络环境，可以选择不同的 API 地址：

地址	说明
`https://claude-code.club/api/v1`	默认地址（直连延迟 < 100ms 时最快）
`https://jp.claude-code.club/api/v1`	日本节点（阿里云，回国优化）
`https://hk.claude-code.club/api/v1`	香港节点（阿里云，回国优化）
`https://sz.ai-code.club/api/v1`	深圳节点（国内，由服务器代为出境）

验证配置

启动 OpenCode 验证是否配置成功：

opencode

验证成功标志：OpenCode 正常启动并可以进行对话

方法二：使用 CC Switch 配置

CC Switch 是一款开源的跨平台桌面应用，专门用于统一管理 AI 编程助手的配置。它支持 Claude Code、Codex、OpenCode、Gemini CLI 四大工具的可视化配置管理。

推荐理由

✅ 可视化界面，无需手动编辑配置文件
✅ 一键切换多个 API Provider
✅ 内置延迟测试，选择最快的节点
✅ 自动处理模型 ID 映射问题
✅ 支持配置备份和云同步

安装 CC Switch

根据你的操作系统选择对应的安装方式：

方式一：MSI 安装包（推荐）

访问 CC Switch Releases
下载最新版本的 .msi 文件
双击安装包，按提示完成安装

方式二：便携版

下载 .zip 便携版
解压到任意目录
直接运行 cc-switch.exe

方式一：Homebrew（推荐）

brew install --cask cc-switch

方式二：手动安装

访问 CC Switch Releases
下载 .dmg 或 .zip 文件
拖入 Applications 文件夹

⚠️

首次启动可能遇到 Gatekeeper 警告，需要在「系统偏好设置 → 安全性与隐私」中允许运行。

根据你的发行版选择：

Ubuntu/Debian

# 下载 .deb 包后
sudo dpkg -i cc-switch.deb

Fedora/RHEL

# 下载 .rpm 包后
sudo rpm -i cc-switch.rpm

Arch Linux

paru -S cc-switch-bin

通用方式（AppImage）

# 下载 AppImage 后
chmod +x cc-switch.AppImage
./cc-switch.AppImage

安装 OpenCode

go install github.com/anomalyco/opencode@latest

brew install opencode

获取 CC Club API Key

访问获取 API Key 页面了解如何获取 CC Club 的 API Key。

配置 CC Switch

启动 CC Switch 应用后，按以下步骤添加 CC Club Provider：

点击「Add Provider」按钮
选择「Custom」自定义配置
填写配置信息：
- 名称：CC Club（或自定义名称）
- Base URL：选择合适的 API 地址（见下方地址表）
- API Key：填写你的 CC Club API Key
- 模型映射（重要）：配置模型 ID 映射关系

配置模型映射示例：

{
  "claude-opus-4-5": "claude-opus-4-5-20251101",
  "claude-sonnet-4-5": "claude-sonnet-4-5-20250929",
  "claude-opus-4-5-20251101": "claude-opus-4-5-20251101",
  "claude-sonnet-4-5-20250929": "claude-sonnet-4-5-20250929"
}

模型映射说明：左侧是 OpenCode 使用的模型 ID（不带日期），右侧是 CC Club 实际的模型 ID（带日期）。这样配置后，OpenCode 就能正确调用 CC Club 的模型了。

CC Club API 地址

根据你的网络环境选择合适的地址：

地址	说明
`https://claude-code.club/api`	默认地址（直连延迟 < 100ms 时最快）
`https://jp.claude-code.club/api`	日本节点（阿里云，回国优化）
`https://hk.claude-code.club/api`	香港节点（阿里云，回国优化）
`https://sz.ai-code.club/api`	深圳节点（国内，由服务器代为出境）

切换到 CC Club Provider

配置保存后：

在 CC Switch 主界面的 Provider 列表中找到「CC Club」
点击「Switch」按钮或直接点击该 Provider
CC Switch 会自动修改 OpenCode 的配置文件

测试连接

使用 CC Switch 测速功能：
- 点击 Provider 旁边的「Test」按钮
- 等待延迟测试完成
- 查看响应时间和状态指示
启动 OpenCode 验证：
```
opencode
```

验证成功标志：OpenCode 正常启动并可以进行对话

详细教程参考：CC Switch 完全指南

方法三：使用 New API 中转（进阶）

如果你需要更多自定义配置或前两种方法无法满足需求，可以使用 New API 中转服务。

为什么需要中转？

OpenCode 默认的 Anthropic 模型 ID 使用不带日期的格式（如 claude-sonnet-4-5），而 CC Club 使用带日期的模型 ID（如 claude-sonnet-4-5-20250929）。通过 New API 中转可以解决这个兼容性问题。
通过中转可以避免官方提示不能使用 OpenCode 客户端的限制。

部署 New API 中转服务

New API 是一个开源的 API 管理和中转服务，支持多种 AI 模型的统一管理。

部署参考

New API 支持 Docker、1Panel 等多种部署方式，详细的部署步骤请参考：

官方文档：https://docs.newapi.pro/zh/docs
GitHub 仓库：https://github.com/QuantumNous/new-api

配置 New API 渠道

部署完成后，需要在 New API 中配置 CC Club 的渠道信息。

添加渠道

进入 New API 管理界面，点击”渠道管理” → “添加渠道”。

配置渠道信息

填写以下信息：

渠道类型：选择 Anthropic Claude
渠道名称：CC Club（或自定义名称）
代理地址：填写 CC Club 的 API 地址（参考 CC Club API 地址）
密钥：填写你的 CC Club API Key

测试渠道

点击”测试”按钮，确认渠道配置正确。测试通过后会有成功提示。

安装 OpenCode

go install github.com/anomalyco/opencode@latest

brew install opencode

配置 OpenCode

找到 OpenCode 的配置文件并进行配置。配置文件通常位于 ~/.config/opencode/config.json。

⚠️

重要注意事项：

API 地址后缀一定要加 /v1
必须添加 models 参数进行模型重命名，因为 OpenCode 默认使用不带日期的模型 ID

配置示例

{
  "anthropic": {
    "options": {
      "baseURL": "http://你的NewAPI地址/v1"
    },
    "models": {
      "claude-opus-4-5-20251101": {
        "name": "claude-opus-4-5-20251101"
      },
      "claude-sonnet-4-5-20250929": {
        "name": "claude-sonnet-4-5-20250929"
      }
    }
  }
}

配置说明

配置项	说明
`options.baseURL`	New API 的地址，必须以 `/v1` 结尾
`models`	模型配置，定义可用的模型及其名称

验证配置

配置完成后，启动 OpenCode 验证是否配置成功：

opencode

验证成功标志：

OpenCode 正常启动并可以进行对话
在 New API 的日志中可以看到调用记录

查看调用日志

在 New API 管理界面的”日志”页面，可以查看 OpenCode 的调用记录，确认请求是否正确转发到 CC Club。

常见问题

Q: 三种方法应该选择哪一种？

A: 推荐优先使用方法一（直接配置），最简单快捷。如果需要可视化管理多个 Provider，可以使用方法二（CC Switch）。如果需要更多自定义配置，再考虑使用方法三（New API）。

Q: 提示模型不存在？

方法一：检查配置文件中的 baseURL 是否正确，确保以 /v1 结尾
方法二：检查 CC Switch 配置的 Base URL 是否正确
方法三：检查 models 配置是否正确，确保模型 ID 配置正确

Q: 请求失败或超时？

A: 请检查：

网络连接是否正常
API Key 是否正确
Base URL 是否正确（必须以 /v1 结尾）
如使用方法三，检查 New API 服务是否正常运行

Q: 如何获取 CC Club API Key？

A: 请访问获取 API Key 页面了解如何获取密钥。

OpenCode 介绍 Clawdbot 介绍