一键导入
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 是电脑软件,请在电脑上打开这个页面。
这条线路要用 Claude(Kiro)分组的密钥:在控制台「API 密钥」新建密钥时选这个分组。
在控制台「API 密钥」页面点密钥右侧的「⋯」→「一键导入」→「CC Switch(推荐)」进来时会自动填好;也可以直接粘贴。
默认模型主模型
价格 · 元 / 百万 token价格暂时没加载出来,可以稍后刷新页面,或到价格页查看。
导入后在 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。
导入后怎么用
- 01
安装 CC Switch
还没装 CC Switch?先到 GitHub 下载(需要 4.0.10 或更新版本,旧版本不会导入推理强度、上下文等设置),装好后回到这里再点一次导入。
- 02
确认导入
CC Switch 弹出导入确认框,核对地址是
https://queqiaoapi.com/v1,点「导入」。可以顺手打开「导入后立即切换」。 - 03
设为当前供应商
在 CC Switch 的 Codex 页面把「鹊桥 API」设为当前供应商,然后重新打开 Codex。
- 04
使用较新的 Codex
Codex 建议使用 0.155 或更新版本(GPT-6 系列模型需要较新的 Codex 才会显示在模型列表里)。
- 01
安装 CC Switch
还没装 CC Switch?先到 GitHub 下载(需要 4.0.10 或更新版本,本页按这个版本的导入规则生成链接),装好后回到这里再点一次导入。
- 02
确认导入
CC Switch 弹出导入确认框,核对地址是
https://queqiaoapi.com(不带 /v1),点「导入」。可以顺手打开「导入后立即切换」。 - 03
设为当前供应商
在 CC Switch 的 Claude 页面把「鹊桥 API」(Claude 线路是「鹊桥 API · Claude Kiro / MAX」)设为当前供应商,然后重新打开 Claude Code。不要给它开启本地路由,也不用改接口格式。
- 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。
max 不能保存为默认值,命令里没有写推理强度;需要时在 Claude Code 里输入 /effort max(只在当前会话生效)。
$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
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/v1 | OpenAI 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.json | Codex 的模型列表只显示本站真实可用的 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-5 | Opus、Sonnet、Fable 档位(ANTHROPIC_DEFAULT_OPUS_MODEL 等)填这个分组对应的 Claude 模型,/model 里切换 |
| 小模型 | gpt-5.6-luna | 写进 ANTHROPIC_DEFAULT_HAIKU_MODEL,后台任务和 Haiku 档位的子代理用它 |
| 上下文窗口 | 872000 | CLAUDE_CODE_MAX_CONTEXT_TOKENS:模型支持的最大上下文(本站实测单次 86.6 万 token 正常返回)。单次请求的提示词超过 27.2 万 token 时,这次请求按长上下文价格计费(输入和缓存 ×2、输出 ×1.5) |
| 自动压缩 | 817800 | CLAUDE_CODE_AUTO_COMPACT_WINDOW:Claude Code 在这个值减去 3.3 万预留时压缩,也就是上下文用到 78.48 万(90%)时自动压缩较早的对话,和 Codex 的比例一致 |
| 长上下文 | x-queqiao-context: long | ANTHROPIC_CUSTOM_HEADERS:告诉鹊桥 API 这个会话按 87.2 万上下文处理;不带它时,超过 27.2 万 token 的请求会被拦下并让 Claude Code 先压缩 |
| 自动模式 | 0 | CLAUDE_CODE_AUTO_MODE_SERVER:由 Claude Code 自己判断自动模式下的操作,不再显示经过网关的提示 |
| 推理强度 | high | effortLevel:CC Switch 写不进这一项,由导入后运行一次的命令写入;以后可以在 Claude Code 里用 /effort 切换 |
| 网页抓取 | true | skipWebFetchPreflight:不再先去 api.anthropic.com 检查域名,国内网络下 WebFetch 才能正常抓取网页;CC Switch 写不进这一项,由导入后运行一次的命令写入 |
| 余额显示 | 可选 | CC Switch 卡片上显示账户余额(人民币) |
缓存命中不需要设置:Claude Code 每个会话会自动带会话标识,鹊桥 API 会把同一会话固定到同一条上游线路,长对话里重复的内容按缓存价计费(GPT 为输入价的 5%~10%Claude 按模型为输入价的 2.5%~10%,写入缓存另按缓存写入价计费)。用 Claude Code 和其他用法价格相同,按模型与价格里的 token 单价计费。
- 思考过程显示的是模型的推理摘要,不是完整的思考内容,推理较短时可能是空的。
- 网页搜索由 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 模型。
{
"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 登录。
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