OpenCode 集成

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

1. 找到 OpenCode 配置文件

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

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

2. 在 provider 中添加 ccodezh

在 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-6": { "name": "Claude Opus 4.6-1" },
				"claude-sonnet-4-6": { "name": "Claude sonnet 4.6" },
				"claude-opus-4-6-n": { "name": "Claude Opus 4.6-n" },
				"claude-sonnet-4-6-n": { "name": "Claude Sonnet 4.6-n" }
			  }
    }
  },
  "model": "ccodezh/claude-sonnet-4-6-n"
}

模型 ID 请以 https://ccodezh.com/models 的实际可用名称为准；如果你使用的是渠道模型（例如带特殊后缀），直接替换成控制台显示的真实模型名即可。

3. 重启并验证

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

4. 常见问题

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