模型 API 接入，
从这份文档开始。

在终端里使用 Claude Code，把请求发送到 52Token 的 Messages 接口。CC 是 Claude Code 的常用简称。

1. 按官方说明安装 Claude Code；先按快速开始设置当前终端的 TOKEN_BROKER_API_KEY。
2. 把下面的 YOUR_MODEL_ID 全部换成支持 Messages、流式和工具调用的平台模型名，再在同一终端执行。三个别名暂时映射到同一个模型，避免辅助任务请求未开放的模型。
3. 启动后用 /status 核对地址与鉴权来源；用 /model 查看当前模型，再从一个小任务开始。

unset ANTHROPIC_API_KEY
export ANTHROPIC_BASE_URL="https://api.52token.me"
export ANTHROPIC_AUTH_TOKEN="$TOKEN_BROKER_API_KEY"
export ANTHROPIC_MODEL="YOUR_MODEL_ID"
export ANTHROPIC_DEFAULT_SONNET_MODEL="YOUR_MODEL_ID"
export ANTHROPIC_DEFAULT_OPUS_MODEL="YOUR_MODEL_ID"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="YOUR_MODEL_ID"
claude --model "$ANTHROPIC_MODEL"

仅修改当前终端的环境；先设置上文 TOKEN_BROKER_API_KEY，再启动工具。没有写入持久配置文件。

以工具当前版本的界面与官方配置为准：官方接入说明 ↗ · 模型配置 ↗

用图形界面管理 Claude Code、Codex 等工具的服务商配置。CC Switch 本身不是模型或平台客户端。

1. 在 CC Switch 中选择目标工具，添加自定义服务商，名称填写 52Token，API Key 填写买家平台密钥。
2. Claude Code 选择 Anthropic Messages，地址填 https://api.52token.me；Codex 选择 OpenAI Responses，地址填 https://api.52token.me/v1。模型填写对应接口可用的平台模型名。
3. 将该服务商设为启用，重新启动目标工具；检查实际模型和请求地址，避免旧终端环境变量覆盖新配置。

以工具当前版本的界面与官方配置为准：官方接入说明 ↗

通过自定义 model provider 接入。需要所选模型支持 Responses 的流式输出和工具调用；Chat Completions 模型不能直接套用此配置。

1. 安装 Codex CLI，在准备启动它的终端设置 TOKEN_BROKER_API_KEY。
2. 将下面内容合并到用户级 ~/.codex/config.toml（Windows 为 %USERPROFILE%\.codex\config.toml），替换 YOUR_MODEL_ID。保留已有配置，不重复同名键或表；服务商配置不要放在项目级文件里。
3. 在项目目录运行 codex，用 /status 检查模型与服务商，先验证一个小任务。

model = "YOUR_MODEL_ID"
model_provider = "token52"
web_search = "disabled"

[model_providers.token52]
name = "52Token"
base_url = "https://api.52token.me/v1"
env_key = "TOKEN_BROKER_API_KEY"
wire_api = "responses"
supports_websockets = false

以工具当前版本的界面与官方配置为准：官方接入说明 ↗ · 配置项说明 ↗

仅适用于支持自定义 Base URL 和自定义模型的 Cursor 版本。自带模型、Tab 补全及其他专有功能有独立限制。

1. 打开 Cursor Settings → Models → API Keys，在 OpenAI API Key 中填写平台密钥。
2. 如果当前版本提供 Override OpenAI Base URL，启用并填写 https://api.52token.me/v1。在模型列表添加实际平台模型名，使用支持该模型的聊天入口。
3. 若界面禁止选择自定义模型或提示该功能不支持自定义密钥，请使用 Cline 等支持自定义服务商的扩展；不要把平台模型改名为 GPT 或 Claude。

以工具当前版本的界面与官方配置为准：官方接入说明 ↗ · 官方社区：地址覆盖限制 ↗

添加 OpenAI 兼容服务商，通过环境变量读取密钥。下面配置使用 Chat Completions，避免默认切到 Responses。

1. 安装 OpenCode；在同一终端设置 TOKEN_BROKER_API_KEY，之后从这个终端启动 opencode。
2. 将下面配置合并到项目的 opencode.json。替换 models 中的 YOUR_MODEL_ID，保留项目已有设置；配置里无需写入真实密钥。
3. 启动后执行 /models，选择 52Token 下的实际模型。先验证聊天，再验证所需的工具调用。

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "token52": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "52Token",
      "options": {
        "baseURL": "https://api.52token.me/v1",
        "apiKey": "{env:TOKEN_BROKER_API_KEY}"
      },
      "models": {
        "YOUR_MODEL_ID": {
          "name": "52Token · YOUR_MODEL_ID"
        }
      }
    }
  }
}

以工具当前版本的界面与官方配置为准：官方接入说明 ↗

适合在 VS Code 或兼容编辑器中使用，设置面板直接提供自定义服务商、地址、密钥与模型字段。

1. 按官方说明安装 Cline，打开扩展设置，在 API Provider 中选择 OpenAI Compatible。
2. Base URL 填 https://api.52token.me/v1，API Key 填平台密钥，Model ID 填实际平台模型名。Plan 与 Act 使用不同配置时，两边都需核对。
3. 按实际能力设置上下文、最大输出与图片支持。先进行普通聊天，再用一个小任务检查工具使用和文件修改。

以工具当前版本的界面与官方配置为准：官方接入说明 ↗

在终端中与模型一起修改代码，通过 OpenAI 兼容地址连接。模型需要具备适合代码编辑的输出能力。

1. 按官方说明安装 Aider，在项目目录打开终端，并设置 TOKEN_BROKER_API_KEY。
2. 替换下面的 YOUR_MODEL_ID，在同一终端执行。openai/ 是 Aider 的服务商前缀，不代表实际模型来自 OpenAI。
3. 从一个小文件或简单问题开始，检查改动后再继续；陌生模型的上下文和编辑格式按实际能力调整。

export OPENAI_API_BASE="https://api.52token.me/v1"
export OPENAI_API_KEY="$TOKEN_BROKER_API_KEY"
aider --model openai/YOUR_MODEL_ID

仅修改当前终端的环境；先设置上文 TOKEN_BROKER_API_KEY，再启动工具。没有写入持久配置文件。

以工具当前版本的界面与官方配置为准：官方接入说明 ↗