OpenCode 接入 CCSub：opencode.json 的 provider 和 baseURL 怎么写

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "ccsub": {
      "npm": "@ai-sdk/anthropic",
      "name": "CCSub",
      "options": {
        "baseURL": "https://www.ccsub.net/api/v1",
        "apiKey": "{env:CCSUB_API_KEY}"
      },
      "models": {
        "claude-sonnet-5": { "name": "claude-sonnet-5" }
      }
    }
  },
  "model": "ccsub/claude-sonnet-5"
}

OpenCode 是一个开源的终端编程助手，模型接入走的是 Vercel AI SDK 的各个 provider 包，所以 Anthropic 协议和 OpenAI 协议都能接 CCSub。配置都写在一个 JSON 文件里，改完重启 OpenCode 即可。

配置文件在哪

写法一：Anthropic 协议（调用 Claude 型号）

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "ccsub": {
      "npm": "@ai-sdk/anthropic",
      "name": "CCSub",
      "options": {
        "baseURL": "https://www.ccsub.net/api/v1",
        "apiKey": "{env:CCSUB_API_KEY}"
      },
      "models": {
        "claude-sonnet-5": { "name": "claude-sonnet-5" }
      }
    }
  },
  "model": "ccsub/claude-sonnet-5"
}

写法二：OpenAI 兼容协议（调用 GPT 型号）

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "ccsub-openai": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "CCSub OpenAI",
      "options": {
        "baseURL": "https://www.ccsub.net/api/v1",
        "apiKey": "{env:CCSUB_API_KEY}"
      },
      "models": {
        "gpt-5.5": { "name": "gpt-5.5" }
      }
    }
  },
  "model": "ccsub-openai/gpt-5.5"
}

@ai-sdk/openai-compatible 会在 baseURL 后拼 /chat/completions。两个 provider 可以同时写在一个 provider 对象里，用 /models 在 OpenCode 里随时切换。

字段说明

• provider 下的键名（上面的 ccsub、ccsub-openai）就是 provider ID，可以自己起，后面引用型号时要用到。
• {env:CCSUB_API_KEY} 表示从环境变量读 Key。先在 shell 配置里加一行 export CCSUB_API_KEY="sk-你的密钥"，重开终端。
• models 里列出你要用的型号 ID。model 可填 claude-sonnet-5 等，全部可用型号 ID 见 型号列表。每个型号还可以加 limit（context 和 output），让 OpenCode 计算剩余上下文；不写的话它无法提示上下文快满了。
• 顶层 model 的格式是 provider ID/型号 ID，例如 ccsub/claude-sonnet-5。

两个 provider 一起用

上面两种写法可以合并进同一个 provider 对象：ccsub 用 @ai-sdk/anthropic 调用 Claude 型号，ccsub-openai 用 @ai-sdk/openai-compatible 调用 GPT 型号，两边的 apiKey 都引用同一个 CCSUB_API_KEY。顶层 model 选一个作为默认，会话里随时用 /models 切换。

顶层还可以加一个 small_model，同样写成 provider ID/型号 ID，OpenCode 会用它处理生成会话标题这类轻量任务。不写的话，OpenCode 会尝试在同一个 provider 里找一个更便宜的型号，找不到就用默认型号；这些请求同样会出现在 CCSub 的「使用记录」里。

改完 opencode.json 要重新启动 OpenCode 才会生效；如果启动时报配置错误，多半是 JSON 里少了逗号或引号，可以先用编辑器的 JSON 校验检查一遍。

不想把 Key 写进文件：用 /connect

在 OpenCode 里输入 /connect，选择 Other，输入 provider ID（必须和配置里的键名一致，例如 ccsub），再粘贴 Key。Key 会保存到 ~/.local/share/opencode/auth.json，这时配置里的 apiKey 可以删掉。用 opencode auth list 能查看已保存的凭证。

验证

在项目目录执行 opencode，发一句话，然后到 CCSub 控制台的「使用记录」里找这条请求。也可以用 CC Switch 管理 OpenCode 的供应商，它的预设里有 CCSub。需要 Claude Code 的写法见 Claude Code 接入教程。