鹊桥 API
CC Switch · Codex · Claude Code

一键导入
CC Switch

把鹊桥 API 一键加进 CC Switch,Codex 和 Claude Code 都能用:接口地址、密钥、模型、推理强度、上下文窗口和余额显示都会自动配好,不用手改配置文件。

导入到
线路

用默认分组的密钥,Claude Code 走本站的 GPT 模型(服务端转换格式)。

  • 协议 OpenAI Responses
  • 上下文 872K
  • 自动压缩 90%
  • 推理强度 5 档
  • 模型 6 款
  • 卡片显示 余额
  • 协议 Anthropic
  • 上下文 872K
  • 自动压缩 90%
  • 模型 6 款
  • 模型 真 Claude
  • 档位 Opus · Sonnet · Haiku · Fable
  • 卡片显示 余额

CC Switch 是电脑软件,请在电脑上打开这个页面。

Codex 和 Claude Code 通过 CC Switch 连接鹊桥 API

打开 API 密钥页面

这条线路要用 Claude(Kiro)分组的密钥:在控制台「API 密钥」新建密钥时选这个分组。

在控制台「API 密钥」页面点密钥右侧的「⋯」→「一键导入」→「CC Switch(推荐)」进来时会自动填好;也可以直接粘贴。

默认模型主模型

价格 · 元 / 百万 token
OpenAI · GPT 系列6 款

导入后在 Codex 里输入 /model 随时切换这 6 个模型和推理强度。价格为每百万 token;上下文按模型上限 87.2 万设置,单次请求的提示词超过 27.2 万 token 时按长上下文价格计费,详见模型与价格。

主模型是 Claude Code 默认用的模型;/model 里 Opus 档位是 claude-opus-5-5、Sonnet 档位是这个分组的 Sonnet、Fable 档位是 claude-fable-5-1。价格为每百万 token,按这个分组计价,缓存写入和命中另算,详见模型与价格。

主模型负责日常对话和编程,Claude Code 的 Opus、Sonnet 档位都用它。价格为每百万 token;上下文按模型上限 87.2 万设置,用到 90% 时 Claude Code 自动压缩;单次请求的提示词超过 27.2 万 token 时按长上下文价格计费,详见模型与价格。

后台小模型

Claude Code 的后台任务,以及指定用 Haiku 档位的子代理会用它,默认 gpt-5.6-luna。luna 在上游限流时,这些请求会自动改用 gpt-6.1-sol 完成,按实际使用的模型计费。要选这个分组里有的模型,填了分组里没有的模型会报“无可用渠道”。

默认推理强度推理强度和余额显示

5 档,6 个模型均实测可用

Claude 线路不写推理强度,用 Claude Code 自己的设置(/effort)。

低(low):响应快,推理较轻

CC Switch 导入 Claude Code 时不写推理强度(它只写入地址、密钥、模型和上下文这类设置)。这里选的档位由导入后运行一次的命令写入,手动配置里也会带上;以后在 Claude Code 里用 /effort 切换也可以,会保存为默认值(max 只在当前会话生效)。不设置时 Claude Code 用 high。

导入之后

导入后怎么用

  1. 01

    安装 CC Switch

    还没装 CC Switch?先到 GitHub 下载(需要 4.0.10 或更新版本,旧版本不会导入推理强度、上下文等设置),装好后回到这里再点一次导入。

  2. 02

    确认导入

    CC Switch 弹出导入确认框,核对地址是 https://queqiaoapi.com/v1,点「导入」。可以顺手打开「导入后立即切换」。

  3. 03

    设为当前供应商

    在 CC Switch 的 Codex 页面把「鹊桥 API」设为当前供应商,然后重新打开 Codex。

  4. 04

    使用较新的 Codex

    Codex 建议使用 0.155 或更新版本(GPT-6 系列模型需要较新的 Codex 才会显示在模型列表里)。

  1. 01

    安装 CC Switch

    还没装 CC Switch?先到 GitHub 下载(需要 4.0.10 或更新版本,本页按这个版本的导入规则生成链接),装好后回到这里再点一次导入。

  2. 02

    确认导入

    CC Switch 弹出导入确认框,核对地址是 https://queqiaoapi.com(不带 /v1),点「导入」。可以顺手打开「导入后立即切换」。

  3. 03

    设为当前供应商

    在 CC Switch 的 Claude 页面把「鹊桥 API」(Claude 线路是「鹊桥 API · Claude Kiro / MAX」)设为当前供应商,然后重新打开 Claude Code。不要给它开启本地路由,也不用改接口格式。

  4. 04

    换模型和推理强度

    Claude Code 里 /model 的 Opus、Sonnet 档位就是你选的主模型,Haiku 档位是小模型;推理强度用 /effort 切换。/model 里可以在 Opus、Sonnet、Haiku、Fable 档位之间切换,都是这个分组的 Claude 模型。要换成别的模型,回到本页重新导入即可。

导入后在终端运行一次下面的命令:Claude Code 抓取网页(WebFetch)前,会先连 api.anthropic.com 检查域名,国内网络连不上时会报 Unable to verify if domain … is safe to fetch;推理强度也一样,CC Switch 写不进这类设置。命令会在 ~/.claude/settings.json 里加上 "skipWebFetchPreflight": true和你选的推理强度 "effortLevel",文件里原有的内容不变。运行一次即可,以后用 CC Switch 切换供应商也会保留;运行后重新打开 Claude Code。

Windows · PowerShell
$p=Join-Path $env:USERPROFILE '.claude\settings.json'; $t=if(Test-Path $p){[IO.File]::ReadAllText($p)}else{''}; $j=if($t.Trim()){$t|ConvertFrom-Json}else{New-Object psobject}; $j|Add-Member -Force -NotePropertyName skipWebFetchPreflight -NotePropertyValue $true; $j|Add-Member -Force -NotePropertyName effortLevel -NotePropertyValue 'high'; [void](New-Item -ItemType Directory -Force (Split-Path $p)); [IO.File]::WriteAllText($p,($j|ConvertTo-Json -Depth 64),(New-Object Text.UTF8Encoding $false)); 'OK: '+$p
macOS / Linux · 终端
python3 -c 'import json,os;p=os.path.expanduser("~/.claude/settings.json");os.makedirs(os.path.dirname(p),exist_ok=True);t=open(p,encoding="utf-8-sig").read() if os.path.exists(p) else "";d=json.loads(t) if t.strip() else {};d["skipWebFetchPreflight"]=True;d["effortLevel"]="high";open(p,"w",encoding="utf-8").write(json.dumps(d,ensure_ascii=False,indent=2)+"\n");print("OK:",p)'
配置明细

会写入哪些设置

设置值说明
接口地址https://queqiaoapi.com/v1OpenAI Responses 协议,和 Codex 官方用法一致
模型gpt-6.1-sol你在上面选的默认模型
推理强度low本站实测 6 个模型都支持 low / medium / high / xhigh / max 五档
上下文窗口872000模型支持的最大上下文(Codex 官方目录的上限,本站实测单次 86.6 万 token 正常返回)。单次请求的提示词超过 27.2 万 token 时,这次请求按长上下文价格计费(输入和缓存 ×2、输出 ×1.5)
自动压缩784800上下文用到 90% 时,Codex 自动压缩较早的对话,这是 Codex 的默认比例(设得更高 Codex 也会按 90% 处理)
模型目录/site-assets/codex/models.jsonCodex 的模型列表只显示本站真实可用的 6 个模型,参数取自 Codex 官方目录
流式空闲超时600000 毫秒高推理强度可能长时间只思考不输出,放宽到 10 分钟,避免被误判断线(Codex 默认 5 分钟)
WebSocket关闭走标准的流式 HTTP,这是本站实测稳定的方式
远程压缩unsupported上游不支持 /responses/compact,长对话由 Codex 用普通请求自动压缩,效果不变
余额显示可选CC Switch 卡片上显示账户余额(人民币)

缓存命中不需要设置:Codex 每个会话会自动带会话标识,鹊桥 API 会把同一会话固定到同一条上游线路,长对话里重复的内容按输入价的 5%~10% 计费。

设置值说明
接口地址https://queqiaoapi.com不带 /v1。Claude Code 照常发 Anthropic Messages 请求,鹊桥 API 在服务端转换后交给所选的 GPT 模型Claude 模型名的请求原样交给这个分组的 Claude 渠道
密钥ANTHROPIC_AUTH_TOKEN以 Bearer 方式发送,Claude Code 不会再询问是否使用这个 API Key
主模型gpt-6.1-sol写进 ANTHROPIC_MODEL 和 Opus、Sonnet、Fable 三个档位写进 ANTHROPIC_MODEL
各档位claude-opus-5-5Opus、Sonnet、Fable 档位(ANTHROPIC_DEFAULT_OPUS_MODEL 等)填这个分组对应的 Claude 模型,/model 里切换
小模型gpt-5.6-luna写进 ANTHROPIC_DEFAULT_HAIKU_MODEL,后台任务和 Haiku 档位的子代理用它
上下文窗口872000CLAUDE_CODE_MAX_CONTEXT_TOKENS:模型支持的最大上下文(本站实测单次 86.6 万 token 正常返回)。单次请求的提示词超过 27.2 万 token 时,这次请求按长上下文价格计费(输入和缓存 ×2、输出 ×1.5)
自动压缩817800CLAUDE_CODE_AUTO_COMPACT_WINDOW:Claude Code 在这个值减去 3.3 万预留时压缩,也就是上下文用到 78.48 万(90%)时自动压缩较早的对话,和 Codex 的比例一致
长上下文x-queqiao-context: longANTHROPIC_CUSTOM_HEADERS:告诉鹊桥 API 这个会话按 87.2 万上下文处理;不带它时,超过 27.2 万 token 的请求会被拦下并让 Claude Code 先压缩
自动模式0CLAUDE_CODE_AUTO_MODE_SERVER:由 Claude Code 自己判断自动模式下的操作,不再显示经过网关的提示
推理强度higheffortLevel:CC Switch 写不进这一项,由导入后运行一次的命令写入;以后可以在 Claude Code 里用 /effort 切换
网页抓取trueskipWebFetchPreflight:不再先去 api.anthropic.com 检查域名,国内网络下 WebFetch 才能正常抓取网页;CC Switch 写不进这一项,由导入后运行一次的命令写入
余额显示可选CC Switch 卡片上显示账户余额(人民币)

缓存命中不需要设置:Claude Code 每个会话会自动带会话标识,鹊桥 API 会把同一会话固定到同一条上游线路,长对话里重复的内容按缓存价计费(GPT 为输入价的 5%~10%Claude 按模型为输入价的 2.5%~10%,写入缓存另按缓存写入价计费)。用 Claude Code 和其他用法价格相同,按模型与价格里的 token 单价计费。

和官方 Claude 模型的不同:
  • 思考过程显示的是模型的推理摘要,不是完整的思考内容,推理较短时可能是空的。
  • 网页搜索由 OpenAI 的搜索服务完成,结果和官方 Claude 不同。
  • 启动时 Claude Code 可能提示模型未被识别或请求经过网关,这是正常提示,不影响使用。
不用 CC Switch?查看手动配置直接写 Codex 的 config.toml,再把密钥存进环境变量直接写 Claude Code 的 settings.json

把下面的内容写进 ~/.claude/settings.json(Windows 在 %USERPROFILE%\.claude\settings.json)。文件里已经有其他设置时,把 skipWebFetchPreflight 和 env 里的这些项合并进去。保存后重新打开终端运行 claude。模型名请用本站的 6 个 GPT 模型名;用默认分组的密钥时,claude- 开头的名称会转给 GPT 模型。密钥要在对应的 Claude 分组,模型名填这个分组里有的 Claude 模型。

settings.json
{
  "skipWebFetchPreflight": true,
  "effortLevel": "high",
  "env": {
    "ANTHROPIC_BASE_URL": "https://queqiaoapi.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的密钥",
    "ANTHROPIC_MODEL": "gpt-6.1-sol",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "gpt-6.1-sol",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "gpt-6.1-sol",
    "ANTHROPIC_DEFAULT_FABLE_MODEL": "gpt-6.1-sol",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "gpt-5.6-luna",
    "ANTHROPIC_CUSTOM_HEADERS": "x-queqiao-context: long",
    "CLAUDE_CODE_MAX_CONTEXT_TOKENS": "872000",
    "CLAUDE_CODE_AUTO_COMPACT_WINDOW": "817800",
    "CLAUDE_CODE_AUTO_MODE_SERVER": "0",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "CLAUDE_CODE_GATEWAY_HINT_HEADERS": "1",
    "CLAUDE_CODE_ATTRIBUTION_HEADER": "0"
  }
}

把 config.toml 里的配置写进 ~/.codex/config.toml(Windows 在 %USERPROFILE%\.codex\config.toml),再按 环境变量 里的命令把密钥存进环境变量 QUEQIAO_API_KEY,然后重新打开终端运行 codex。这种写法已用官方 Codex 0.162.1 实测可用,不会覆盖你在 Codex 里的 ChatGPT 登录。

config.toml
model_provider = "queqiao"
model = "gpt-6.1-sol"
model_reasoning_effort = "low"
model_context_window = 872000
model_auto_compact_token_limit = 784800

[model_providers.queqiao]
name = "鹊桥 API"
base_url = "https://queqiaoapi.com/v1"
wire_api = "responses"
env_key = "QUEQIAO_API_KEY"
model_catalog_url = "https://queqiaoapi.com/site-assets/codex/models.json"
supports_websockets = false
stream_idle_timeout_ms = 600000
capabilities = { remote_compaction = "unsupported" }
环境变量
# Windows(PowerShell 或 CMD)
setx QUEQIAO_API_KEY "sk-你的密钥"

# macOS / Linux(用 bash 的把 ~/.zshrc 换成 ~/.bashrc)
echo 'export QUEQIAO_API_KEY="sk-你的密钥"' >> ~/.zshrc