OpenCode 集成

本页参考 OpenCode 官方 Providers/Config 文档整理，适合已在使用 OpenCode 的用户接入 ccodezh。

1. 找到配置文件

OpenCode 支持全局和项目级配置：

• 全局（推荐）：~/.config/opencode/opencode.json
• 项目级（优先级更高）：<项目根目录>/opencode.json
• Windows 全局：C:\Users\你的用户名\.config\opencode\opencode.json

2. 添加 ccodezh provider

在 opencode.json 的 provider 中添加（或合并）以下内容，将 apiKey 替换为真实的 sk- 密钥：

{
  "provider": {
    "ccodezh": {
      "npm": "@ai-sdk/anthropic",
      "name": "ccodezh",
      "options": {
        "baseURL": "https://api.ccodezh.com/v1",
        "apiKey": "sk-替换成你自己的 key"
      },
      "models": {
				"claude-opus-4-5-20251101": { "name": "Claude Opus 4.5" },
				"claude-sonnet-4-5-20250929": { "name": "Claude Sonnet 4.5" },
				"claude-haiku-4-5-20251001": { "name": "Claude Haiku 4.5" }
			  }
    }
  },
  "model": "ccodezh/claude-sonnet-4-5-20250929"
}

模型 ID 以 https://ccodezh.com/models 的实际可用名称为准，直接用标准名称（不再加 -n）。 走主渠道还是第三方由你 API 令牌所在的分组决定：cc 主渠道、cc-n 第三方更便宜，详见渠道分组配置。

3. 重启并验证

• 重启 OpenCode
• 执行 /models，确认能看到 ccodezh/* 模型
• 开一个新会话测试正常对话

4. 常见问题

• /models 看不到新模型：检查 opencode.json 是否为合法 JSON，且 model 写的是 ccodezh/模型ID
• 鉴权失败：确认 apiKey 有效、有余额；若走 auth login，确认 provider id 与配置里的 ccodezh 一致
• 仍走官方端点：确认 baseURL 是 https://api.ccodezh.com/v1，且未被项目级配置覆盖