开始使用
注册、充值、创建密钥,然后接入你用的工具。
-
接入工具
电脑上还没装过这些工具、第一次接触的,先看从零开始。用 Codex 或 Claude Code 的,推荐一键导入 CC Switch;其他工具照下面填写。
从零开始
第一次接触 AI 工具也没关系:先选一个合适的工具,再照步骤装好。
| 工具 | 是什么、适合谁 | 用哪个分组的密钥 |
|---|---|---|
| Cherry Studio Chatbox | 像聊天软件一样的桌面应用,装好就能用,不用敲命令。适合聊天、写作、翻译、看图,不写代码也能用。 第一次接触推荐从这里开始 | 用 GPT:默认分组 用 Claude:Claude 分组 用 Gemini:Gemini 分组 |
| Claude Code | Anthropic 出的编程智能体,在终端(命令行)里运行,能读写你电脑上的代码、执行命令,帮你写程序、改项目。 | 用 Claude 模型:Claude 分组 用 GPT 模型:默认分组 |
| Codex | OpenAI 出的编程智能体,也在终端里运行(也有 VS Code 插件),用途和 Claude Code 一样。 | 默认分组 |
先选对密钥的分组
每个密钥属于一个分组,分组决定能用哪些模型:「默认分组」只能用 GPT 模型,「Claude(Kiro)」「Claude(MAX 满血)」只能用 Claude 模型,「Gemini(Vertex 官方)」只能用 Gemini 模型。余额各分组通用,同一个账号可以建多个密钥,比如一个给 Codex,一个给 Claude Code。
如果报错里有 分组 max 下模型 gpt-6.1-sol 无可用渠道 这样的话,就是用 Claude 分组的密钥去调了 GPT 模型(或者反过来),换一个对应分组的密钥就好。
安装 Claude Code 或 Codex(约 10 分钟)
只用 Cherry Studio、Chatbox 的可以跳过这一段,直接到资源下载下载安装包。
-
装 Node.js
打开 Node.js 官网下载页,下载 LTS(长期支持)版的安装包,一路「下一步」装完。Claude Code 要求 Node.js 22 或更高,LTS 版都满足。官网下载慢的,可以从 npmmirror 国内镜像下载同一个版本。
-
打开终端
Windows:按键盘上的 Windows 键,搜索「PowerShell」,点开。Mac:按 Command + 空格,搜索「终端」,点开。
输入
node -v按回车,显示v24.x.x这样的版本号,就说明 Node.js 装好了。 -
安装 Claude Code 或 Codex
在终端里复制粘贴下面的命令,按回车,等它装完(命令里已经用了国内镜像,速度快):
安装 Claude Code终端 npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com
安装 Codex终端 npm install -g @openai/codex --registry=https://registry.npmmirror.com
Mac 上提示没有权限(
EACCES)的,在命令最前面加上sudo再运行,输入开机密码(输入时屏幕上不显示,正常输完按回车就行)。 -
接入鹊桥 API
最省事的是装 CC Switch,然后在控制台「API 密钥」页点密钥右边的「⋯」一键导入,Claude Code、Codex 都能用。也可以照下面的教程手动配置。
-
开始使用
在终端里进入你的项目文件夹(比如
cd D:\我的项目,Mac 上是cd ~/我的项目),输入claude或codex按回车,就可以用中文直接告诉它你想做什么了。第一次启动会问你是否信任这个文件夹,选「是」。
资源下载
下面都是官方下载地址,全部免费。请不要从来路不明的网站下载,以免装到带病毒或被篡改的版本。
| 工具 | 用途 | 下载 |
|---|---|---|
| Cherry Studio | 桌面聊天软件(Windows、Mac、Linux) | 官网下载 |
| Chatbox | 聊天软件(电脑、手机都有) | 官网下载 |
| Node.js | 运行 Claude Code、Codex 需要,下载 LTS 版 | 官网下载 |
| Git | Windows 上用 Claude Code 需要 | 官网下载 |
| Claude Code | Anthropic 的编程智能体 | 用命令安装,见从零开始第 4 步 |
| Codex | OpenAI 的编程智能体 | 用命令安装,见从零开始第 4 步 |
| CC Switch | 一键导入鹊桥的配置,给 Claude Code、Codex 切换服务商 | GitHub 下载 下载和你电脑系统对应的安装包;用法见一键导入 |
| VS Code | 代码编辑器,可以装 Claude Code、Codex 的插件,在编辑器里用 | 官网下载 |
Codex
两种方式任选其一。推荐用 CC Switch 一键导入:模型列表、推理强度、上下文窗口、自动压缩、余额显示都会自动配好。附实测数据和常见报错的完整教程见《Codex 国内怎么用》。
方法一:一键导入 CC Switch 推荐
-
打开导入菜单
在控制台「API 密钥」页面,点密钥右侧的「⋯」,再选:
- 一键导入
- CC Switch(推荐)
-
选模型和推理强度
在打开的页面
选好默认模型和推理强度。 -
导入
点「导入到 CC Switch」。
自动配好
- 模型列表
- 推理强度
- 上下文窗口
- 自动压缩
- 余额显示
方法二:手动配置
写入配置文件
已用官方 Codex 0.162.1 实测编辑 Codex 的配置文件 config.toml,写入下面的内容:
- macOS / Linux
~/.codex/config.toml- Windows
%USERPROFILE%\.codex\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" }
配置说明(指向某一项,代码里会标出对应的行)
model- 默认模型,可以换成上面列出的任一模型。
model_reasoning_effort- 默认推理强度,low / medium / high / xhigh / max 五档都可以用。
model_context_window- 上下文按模型支持的最大值 87.2 万 token 设置。单次请求的提示词超过 27.2 万 token 时,这次请求按长上下文价格计费。
model_auto_compact_token_limit- 上下文用到 90%(78.48 万 token)时 Codex 自动压缩较早的对话,这是 Codex 的默认比例。
env_key- 密钥放在环境变量
QUEQIAO_API_KEY里,不会覆盖你在 Codex 里的 ChatGPT 登录。 model_catalog_url- 让 Codex 的模型列表(
/model)只显示本站可用的 6 个模型。 stream_idle_timeout_ms- 放宽到 10 分钟,避免高推理强度
长时间思考时被误判断线。 remote_compaction- 上游不支持远程压缩接口,所以写了
remote_compaction = "unsupported",长对话由 Codex 用普通请求自动压缩。
设置密钥环境变量
再把密钥存进环境变量 QUEQIAO_API_KEY,然后重新打开终端运行 codex:
# Windows(PowerShell 或 CMD) setx QUEQIAO_API_KEY "sk-你的密钥" # macOS / Linux(用 bash 的把 ~/.zshrc 换成 ~/.bashrc) echo 'export QUEQIAO_API_KEY="sk-你的密钥"' >> ~/.zshrc && source ~/.zshrc
Codex 版本
建议 Codex 0.155 或更新版本,GPT-6 系列模型在旧版里不会显示。
Claude Code
Claude Code 有两种用法:用 Claude 分组(Kiro 或 MAX 满血)的密钥,走真正的 Claude 模型;用默认分组的密钥,走本站的 GPT 模型(本站在服务端转换格式)。推荐用 CC Switch 一键导入,选好线路后模型、余额显示等都会自动配好;也可以手动写配置。附实测的完整教程见《Claude Code 国内怎么用》。
方法一:一键导入 CC Switch 推荐
-
打开导入页面
在控制台「API 密钥」页面,点密钥右侧的「⋯」,再选:
- 一键导入
- CC Switch(推荐)
在打开的页面上方选「Claude Code」。
-
选线路和模型
线路选 GPT(默认分组的密钥)
或 Claude Kiro / Claude MAX (对应分组的密钥), 再选主模型和后台小模型。 -
导入并切换
点「导入到 CC Switch」,在 CC Switch 的 Claude 页面
把「鹊桥 API」设为当前供应商, 再重新打开 Claude Code。 -
运行一次设置命令
CC Switch 只写入地址、密钥、模型和上下文这类设置。
导入页下方有一条命令(Windows、macOS 各一条), 在终端运行一次, 加上网页抓取的设置 (不加时国内网络下 WebFetch 会报错) 和推理强度。
自动配好
- 主模型
- 后台小模型
- 上下文窗口
- 自动压缩
- 余额显示
方法二:手动配置(GPT 模型,默认分组的密钥)
写入配置文件
已用 Claude Code 2.1.300 实测编辑 Claude Code 的配置文件 settings.json,写入下面的内容。文件里已经有其他设置时,把最上面两项和 env 里的这些项合并进去:
- macOS / Linux
~/.claude/settings.json- Windows
%USERPROFILE%\.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"
}
}
配置说明(指向某一项,代码里会标出对应的行)
skipWebFetchPreflight- Claude Code 抓取网页(WebFetch)前,默认先连
api.anthropic.com检查域名;国内网络连不上这个地址,不加这一行时 WebFetch 会报Unable to verify if domain … is safe to fetch。写在最外层,不要放进env。 effortLevel- 推理强度,可选 low / medium / high / xhigh;以后在 Claude Code 里用
/effort切换会改写它。要用 max,在 Claude Code 里输入/effort max(只在当前会话生效)。 ANTHROPIC_BASE_URL- 不带 /v1。Claude Code 照常发 Anthropic 格式的请求,鹊桥 API 在服务端转换后交给所选的 GPT 模型。
ANTHROPIC_AUTH_TOKEN- 换成你的密钥。用
ANTHROPIC_AUTH_TOKEN而不是ANTHROPIC_API_KEY,Claude Code 不会再询问是否使用这个 API Key。 ANTHROPIC_MODEL- 主模型,可以换成上面列出的任一 GPT 模型;下面 Opus、Sonnet、Fable 三个档位填同一个。想用真正的 Claude 模型,用 Claude 分组的密钥,按「手动配置 · Claude」填写。
ANTHROPIC_DEFAULT_HAIKU_MODEL- 后台小模型:Claude Code 的后台任务、WebFetch 读取网页内容和 Haiku 档位的子代理用它。gpt-5.6-luna 在上游限流或暂时不可用时,这些请求会自动改用 gpt-6.1-sol 完成,按实际使用的模型计费。
- 上下文(3 项)
- 按模型上限 87.2 万 token 设置(
CLAUDE_CODE_MAX_CONTEXT_TOKENS);CLAUDE_CODE_AUTO_COMPACT_WINDOW让 Claude Code 在用到 78.48 万(90%)时自动压缩较早的对话;ANTHROPIC_CUSTOM_HEADERS这一行告诉鹊桥 API 按 87.2 万处理。单次请求的提示词超过 27.2 万 token 时,这次请求按长上下文价格计费。 - 最后 4 项
- 不显示自动模式经过网关的提示;关掉自动更新、遥测等非必要流量;请求带上类型提示(比如上下文压缩);不在提示词开头加版本标记。
重新打开 Claude Code
保存后重新打开终端运行 claude。
方法三:手动配置(Claude 模型,Claude 分组的密钥)
创建 Claude 分组的密钥
控制台「API 密钥」→「创建 API 密钥」,分组选「Claude(Kiro)」或「Claude(MAX 满血)」。两个分组的模型名一样,价格 = 官方价 × 分组倍率(Kiro ×0.54,MAX 满血 ×1.56),见模型与价格。
写入配置文件
已用 Claude Code 2.1.301 实测文件位置和「手动配置 · GPT」里一样,最上面的 skipWebFetchPreflight 也是让 WebFetch 在国内网络下能用。按密钥的分组选一份:
{
"skipWebFetchPreflight": true,
"env": {
"ANTHROPIC_BASE_URL": "https://queqiaoapi.com",
"ANTHROPIC_AUTH_TOKEN": "sk-你的Kiro分组密钥",
"ANTHROPIC_MODEL": "claude-opus-5-5",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5",
"ANTHROPIC_DEFAULT_FABLE_MODEL": "claude-fable-5-1",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5-20251001",
"CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
}
}
{
"skipWebFetchPreflight": true,
"env": {
"ANTHROPIC_BASE_URL": "https://queqiaoapi.com",
"ANTHROPIC_AUTH_TOKEN": "sk-你的MAX分组密钥",
"ANTHROPIC_MODEL": "claude-opus-5-5",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5-5",
"ANTHROPIC_DEFAULT_FABLE_MODEL": "claude-fable-5-1",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-5-5",
"CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
}
}
ANTHROPIC_AUTH_TOKEN- 换成 Claude 分组的密钥。用默认分组的密钥时,
claude-开头的名称会转给本站的 GPT 模型,不是真 Claude。 ANTHROPIC_MODEL和各档位- 填这个分组里有的 Claude 模型:sonnet-5-5、haiku-5-5 只在 MAX;opus-4-7、opus-4-6、opus-4-5、sonnet-4-6、sonnet-4-5、haiku-4-5 只在 Kiro;其余两个分组都有。填了分组里没有的模型会报「分组 kiro 下模型 … 无可用渠道」,所以 Kiro 的 Haiku 档位填
claude-haiku-4-5-20251001。完整列表见模型与价格。 - 计费
- 按所选分组的 Claude 价格计费;Claude Code 会大量用到提示缓存(实测第二轮起每次有几万 token 命中缓存),缓存写入和命中分别计价。
重新打开 Claude Code
保存后重新打开终端运行 claude。
思考过程是推理摘要
用 GPT 模型时,Claude Code 里显示的思考过程是模型的推理摘要,不是完整的思考内容,推理较短时可能是空的。
换模型和推理强度
/model 里的 Opus、Sonnet 档位就是主模型,Haiku 档位是小模型。要换别的模型,改 settings.json 或重新一键导入;推理强度用 /effort 切换,会保存为默认值。
网页搜索
用 GPT 模型时,WebSearch 由 OpenAI 的搜索服务完成,结果和官方 Claude 不同。
启动时的提示可以忽略
用 GPT 模型时,Claude Code 可能提示模型未被识别,或请求经过网关。这是接入第三方模型的正常提示,不影响使用。
想把上下文控制在 27.2 万以内(GPT 模型)
上面的配置按模型上限 87.2 万设置,单次请求的提示词超过 27.2 万 token 时,这次请求按长上下文价格计费(输入和缓存 ×2、输出 ×1.5)。想一直按标准价,把 CLAUDE_CODE_MAX_CONTEXT_TOKENS 改成 "272000",删掉 CLAUDE_CODE_AUTO_COMPACT_WINDOW 和 ANTHROPIC_CUSTOM_HEADERS 两行,Claude Code 会在 27.2 万以内自动压缩。
用 Claude Code 和其他用法价格相同,按模型与价格里所用模型(和分组)的 token 单价计费。
Cherry Studio
可以一键导入,也可以手动添加。
方式一
一键导入
在控制台「API 密钥」页面,点密钥右侧的「⋯」,再选:
- 一键导入
- Cherry Studio
方式二
手动添加
在 Cherry Studio 里依次打开:
- 设置
- 模型服务
- 添加
- 提供商类型
- OpenAI
- API 密钥
- 你的密钥
- API 地址
https://queqiaoapi.com不带 /v1,Cherry Studio 会自动补上
然后:点「管理」添加模型(如 gpt-6.1-sol),再点「检查」测试连通。用 Claude 分组的密钥时,添加 claude- 开头的模型(如 claude-sonnet-5);用 Gemini 分组的密钥时,添加 gemini- 开头的模型(如 gemini-3.8-flash),提供商类型同样选 OpenAI。
其他兼容 OpenAI 的工具
Chatbox、NextChat、LobeChat、沉浸式翻译等,照下表填写即可。
| 提供商 | 选「OpenAI」或「OpenAI 兼容」 |
|---|---|
| 接口地址 | https://queqiaoapi.com/v1个别工具要求不带 /v1,就填 |
| 密钥 | 你的密钥 |
| 模型名 | 上面列出的模型之一,例如 gpt-6.1-sol用 Claude(Kiro)或 Claude(MAX 满血)分组的密钥时,填 Claude 模型名,例如 |
代码调用
GPT 模型兼容 OpenAI 的 Chat Completions 和 Responses,用 openai 官方库或 curl 都可以直接调用;Claude 模型用 Anthropic 的 Messages 接口,也可以用 OpenAI 格式的 Chat Completions,密钥要在 Claude 分组。
Python
openai 官方库PYfrom openai import OpenAI
client = OpenAI(base_url="https://queqiaoapi.com/v1", api_key="sk-你的密钥")
# Responses 接口
resp = client.responses.create(model="gpt-6.1-sol", input="用一句话介绍你自己", reasoning={"effort": "medium"})
print(resp.output_text)
# Chat Completions 接口(流式)
stream = client.chat.completions.create(
model="gpt-6.1-sol",
messages=[{"role": "user", "content": "你好"}],
stream=True,
)
for chunk in stream:
if chunk.choices: # 最后一个数据块只有用量信息,没有 choices
print(chunk.choices[0].delta.content or "", end="")
curl
流式输出SHELLcurl https://queqiaoapi.com/v1/chat/completions \
-H "Authorization: Bearer sk-你的密钥" \
-H "Content-Type: application/json" \
-d '{"model":"gpt-5.6-terra","stream":true,"messages":[{"role":"user","content":"你好"}]}'
curl · Claude
Anthropic Messages 接口SHELLcurl https://queqiaoapi.com/v1/messages \
-H "x-api-key: sk-你的Claude分组密钥" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{"model":"claude-opus-5-5","max_tokens":1024,"messages":[{"role":"user","content":"你好"}]}'
示例里的 sk-你的密钥 换成你在控制台创建的密钥;Claude 示例要用 Claude(Kiro)或 Claude(MAX 满血)分组的密钥。
注意事项
支持哪些接口、推理强度怎么选,以及几条使用建议。
支持
接口
/v1/chat/completions(GPT、Claude)/v1/responses(GPT)/v1/messages(Claude 模型、Claude Code)/v1/models/v1beta/models/模型名:generateContent(Gemini 模型的原生格式)
能力 已实测
- 流式输出
- 函数调用(tools)
- 图片输入
- 提示缓存(Claude:5 分钟、1 小时)
不支持
接口格式
- GPT、Claude 模型用 Gemini 格式调用
/v1/responses/compact
也没有
- 图片生成
- Embeddings
- 语音模型
推理强度 GPT 系列 已实测
low / medium / high / xhigh / max 五档都可以用;minimal 和 none 会按 medium 处理,ultra 会报错。
- low
- medium
- high
- xhigh
- max
推荐开启流式输出(stream)
生成时间长的非流式请求
不要开代理
国内可以直连。开着代理软件时切换节点,正在生成的回复会中断。
每次请求都带上完整的对话内容
previous_response_id、store: true 这类
模型可能会自称 Codex、ChatGPT 或 Claude
这是上游附加的系统指令或客户端自带的提示词导致的,正常现象。
余额与个人信息
余额不足时请求会失败,请留意控制台余额。请勿发送身份证号、密码、银行卡等敏感个人信息;使用本服务须遵守法律法规和用户协议。
常见报错
按报错里的关键字找到对应的一行。请求失败不扣费。
| 报错里有 | 原因 | 怎么解决 |
|---|---|---|
无可用渠道例如“分组 max 下模型 gpt-6.1-sol 无可用渠道” | 密钥的分组和模型对不上:比如用 Claude 分组的密钥调了 GPT 模型 | 用 GPT 模型(Codex 等)换「默认分组」的密钥;用 Claude 模型换 Claude 分组的密钥;用 Gemini 模型换「Gemini(Vertex 官方)」分组的密钥。见先选对密钥的分组 |
Credentials rejected额度不足 预扣费 | 账户余额不够这次请求。长对话一次请求可能要几毛到几元 | 到控制台「钱包」充值;如果给密钥设了额度上限,也检查一下是不是用完了 |
401 无效的令牌invalid token | 密钥复制错了、少复制了几位,或者密钥已经删除、禁用、过期 | 到「API 密钥」页重新复制完整的密钥(sk- 开头),重新填一遍 |
413 request_too_large超过 10MB | 对话太长,单次请求超过 10MB,对话里的图片最占空间 | 在 Claude Code 里输入 /compact 压缩对话,或者开一个新对话 |
429 rate limit | 上游繁忙,或者短时间内请求太多 | 等几秒再试,大多数工具会自动重试 |
500 502 503 | 上游临时故障 | 稍后再试;一直出现的话,点页面右下角「反馈」告诉我们 |
404“接口地址或模型名称不正确” | 接口地址或模型名填错了 | 接口地址填 https://queqiaoapi.com/v1(个别工具要求不带 /v1);模型名照模型与价格里的写,注意大小写和连字符 |
无法加载文件 禁止运行脚本(Windows PowerShell) | Windows 默认不允许运行脚本,Claude Code、Codex 的启动命令被拦了 | 在 PowerShell 里运行 Set-ExecutionPolicy -Scope CurrentUser RemoteSigned,提示时输入 Y 回车,然后关掉终端重新打开 |
Unable to verify if domainClaude Code 抓取网页(WebFetch)时 | Claude Code 抓网页前会先连 api.anthropic.com 检查域名,国内网络连不上 | 在 ~/.claude/settings.json 最外层加 "skipWebFetchPreflight": true;用 CC Switch 导入的,运行一次导入页下方的命令 |
不是内部或外部命令command not found | 没装成功,或者装完没有重新打开终端 | 关掉终端重新打开再试;还不行就重新运行安装命令,看看有没有报错 |
安装很慢、ETIMEDOUT | 连国外的 npm 源慢 | 安装命令后面加上 --registry=https://registry.npmmirror.com(从零开始里的命令已经带了) |
遇到问题
先看控制台的使用日志,每次请求的扣费和报错都在里面。