如果你在 CCSub 上跑过一段时间的代码任务，大概率见过 gpt-5.5 这个名字。它的调用量排在站内第二位，仅次 gpt-5.6-sol，说明已经有一批用户在真实工作流里用它。但很多人第一次配置时会卡在同一个地方：模型名到底写什么、Base URL 填哪个、为什么 Codex 和 Claude Code 的地址不一样。这篇教程把这些问题一次讲清，并顺便说明它和 GPT-5.6 Sol 该怎么分工。
先搞清三套地址：OpenAI 兼容、Codex 原生、Claude Code 原生
CCSub 同时提供三种接入方式，最容易出错的就是把 OpenAI 兼容地址填到 Codex 里，或者反过来。先记住下面这张对照表：
- OpenAI 兼容（Chat Completions）：Base URL 用
https://ccsub.xyz/v1，实际请求端点https://ccsub.xyz/v1/chat/completions。适合 Cherry Studio、Cursor、VS Code、Windsurf、OpenCode 这类按 OpenAI 协议配置的工具。 - Codex 原生（Responses）：Base URL 用
https://ccsub.xyz/openai，协议写wire_api = responses，Codex 会自动请求https://ccsub.xyz/openai/responses。 - Claude Code 原生（Messages）：环境变量
ANTHROPIC_BASE_URL=https://ccsub.xyz/api，客户端会自动请求https://ccsub.xyz/api/v1/messages。
三套地址互不通用。Base URL 填错最典型的表现是 404 或 connect_error，而不是模型不存在。
第一步：确认 gpt-5.5 在你的账号可用
动手配置前，先用一次请求确认模型清单。任何 Bearer Token 都能调这个接口：
curl https://ccsub.xyz/v1/models \
-H "Authorization: Bearer sk-你的CCSub密钥"返回列表里能看到当前可用的模型 ID，包括 gpt-5.5、gpt-5.6-sol、gpt-5.6-terra、gpt-5.6-luna、gpt-5.3-codex 以及 Anthropic 系列。如果你需要 Claude Code 侧的模型，也能在这里看到 claude-sonnet-5、claude-opus-4-8 等 ID。
如果这一步就返回 401，说明密钥写错或没创建成功，先去注册与充值页确认密钥状态，再继续后面的步骤。
第二步：在 Cherry Studio / Cursor 等 OpenAI 兼容工具中接入
这类客户端只需要三个字段：
- API Key：
sk-你的CCSub密钥 - Base URL：
https://ccsub.xyz/v1 - 模型名：
gpt-5.5
保存后发一条简单消息测试。若客户端支持自定义请求路径，注意保持默认，不要手写 /chat/completions 之外的路径。想快速验证的话，也可以直接用命令行：
curl https://ccsub.xyz/v1/chat/completions \
-H "Authorization: Bearer sk-你的CCSub密钥" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-5.5",
"messages": [{"role": "user", "content": "用一句话说明什么是幂等性"}]
}'第三步：在 Codex 中接入
Codex 用的是 Responses 协议，配置里要把 Base URL 指向 https://ccsub.xyz/openai，并显式声明协议类型：
base_url = "https://ccsub.xyz/openai"
wire_api = "responses"
model = "gpt-5.5"
env_key = "OPENAI_API_KEY"配置完成后，Codex 会自动把请求发到 https://ccsub.xyz/openai/responses，你不需要自己拼这个路径。这是新手最容易踩的坑：把 https://ccsub.xyz/v1 填进 Codex，结果一直报 404。
第四步：在 Claude Code 中接入
Claude Code 走的是 Anthropic Messages 协议，配置方式是设置环境变量：
export ANTHROPIC_BASE_URL=https://ccsub.xyz/api
export ANTHROPIC_API_KEY=sk-你的CCSub密钥客户端会自动请求 https://ccsub.xyz/api/v1/messages。Claude Code 场景下模型名一般选 claude-sonnet-5 或 claude-opus-4-8；如果你想在 Claude Code 里用 GPT 系列，需要确认你的客户端版本是否支持跨协议模型映射，不确定时以默认 Anthropic 模型为主。
第五步：常用工具速查
- Claude Code：
ANTHROPIC_BASE_URL=https://ccsub.xyz/api - Codex：
https://ccsub.xyz/openai+wire_api = responses - OpenCode / OpenClaw / Cursor / VS Code / Windsurf / CherryStudio：
OPENAI_BASE_URL=https://ccsub.xyz/v1
把这张表贴在配置文件夹旁边，基本能避免 90% 的接入报错。
GPT-5.5 和 GPT-5.6 Sol 怎么分工
两者在定价表上是同一档：输入 56、输出 168、缓存读取 5.6。价格一样，但这不代表任务该混着用。观察近 30 天的调用结构可以发现，gpt-5.6-sol 承担了绝大部分任务量，而 gpt-5.5 被用得少但更聚焦——这恰好说明用户在按任务类型分工。
实际使用中可以这样划分：
- 日常改写、注释补全、单文件小修：交给
gpt-5.5。这类任务上下文短、期望输出直接，用大模型处理反而增加噪声和等待时间。 - 复杂重构、跨文件推理、长链路调试：用
gpt-5.6-sol。它的定位更适合需要多轮工具调用和全局判断的场景。 - 极致性能任务：如果确实需要更强能力，再考虑
gpt-6-astra，但它的单价明显更高，建议只在关键节点使用。
换句话说，GPT-5.5 不是“低配版 Sol”，而是同价位下的另一条分支。把简单任务分流过去，既能让 Sol 的额度留给真正需要推理的环节，也能降低单次请求的等待时间。
成本与充值提醒
CCSub 采用 1 元对应 1 美元额度的计费方式，模型定价页有分组说明。按当前价格，gpt-5.5 的输出侧开销是输入侧的 3 倍，意味着长输出任务省钱的杠杆在“控制回复长度”而不是“换模型”。几个实用习惯：
- 在提示里明确要求精简输出，避免模型自发生成长篇解释。
- 重复的系统提示尽量利用缓存读取，成本远低于重新输入。
- 大任务先用小模型试跑，确认思路可行再上重模型，避免一次烧掉大量额度。
充值前建议先按自己的调用频率估算一下：如果每天几十次小任务，一次小额充值就能用很久；如果是高频长上下文任务，则需要留出更充足的余额。具体档位可参考注册与充值说明。
常见错误排查
近一周的高频错误类型集中在连接和上游可用性上，对应到配置层面通常是这样几类：
- connect_error：大多发生在 Codex 或 Claude Code 场景。先确认三套地址没有混用，再检查本地代理是否把请求拦掉。
https://ccsub.xyz/openai和https://ccsub.xyz/api是不同协议，地址写错会直接连不上。 - upstream_unavailable：通常是瞬时波动，稍等重试即可；如果连续多次出现，换个模型 ID 测试能帮助判断是模型侧还是网络侧的问题。
- upstream_client_error：多数是请求格式问题，比如
model字段拼错、messages 结构不合法、或把 Responses 格式发给了 Chat Completions 端点。 - 404 Not Found：几乎可以确定是 Base URL 用错，回上面第二节对照表逐项核对。
- 401 Unauthorized：密钥无效或额度耗尽，先在
/v1/models上验证密钥能否通过。
更多按症状排查的流程可以看故障排查文档，里面有一张速查表。
接下来做什么
如果你还没配置过环境，建议按这个顺序走：先读安装配置把 Node.js 和客户端装好，再用本文的地址表完成接入，最后拿一个真实的小任务跑通。配置过程中如果对参数支持范围有疑问，API 参数与推理能力那一页写得比较细。
GPT-5.5 的价值不在于它多强，而在于它让日常任务有一个价格可控、响应稳定的默认选项。把它接好，你的主力模型才能真正用在刀刃上。