如果你刚在 CCSub 的模型列表里看到 claude-sonnet-5，但不确定怎么写进 Claude Code、Cursor 或 Cherry Studio，这篇就是给你的。下面会按「先确认模型 ID → 再填三个客户端的配置 → 对价格 → 判断何时降级」的顺序走一遍，全部基于 CCSub 实际开放的接口地址与计价口径。
一句话结论：Sonnet 5 的模型 ID 是claude-sonnet-5，Anthropic 协议走https://ccsub.xyz/api，OpenAI 兼容协议走https://ccsub.xyz/v1，单价与 Sonnet 4.6 相同，输入 33.6、输出 168（单位：元/百万 Token）。
第一步：确认 CCSub 上的 Sonnet 5 模型 ID
CCSub 的模型列表是动态查询的，不要凭记忆猜 ID。任何客户端接入前，先跑一次模型查询：
curl https://ccsub.xyz/v1/models \
-H "Authorization: Bearer sk-你的CCSub密钥"返回结果里 Anthropic 系列的命名是「小写、连字符、版本号无小数点」的格式，比如 claude-opus-4-8、claude-sonnet-4-6、claude-haiku-4-5。Sonnet 5 对应的 ID 是：
claude-sonnet-5—— Claude Sonnet 5，本文主角claude-sonnet-4-6—— Claude Sonnet 4.6，降级首选claude-opus-4-8—— Claude Opus 4.8，难度最高的任务再用
注意不要写成 claude-sonnet-5.0 或 claude-5-sonnet，这两种写法都不会命中模型，客户端一般会直接报 404 或 model_not_found。写错的时候，报错信息里通常能看到「模型不存在」，这时候回头对着 /v1/models 的输出复制一遍就行。
第二步：三种客户端的具体配置写法
Claude Code：走 Anthropic 原生协议
Claude Code 是 Anthropic 原生客户端，它自动请求 /v1/messages，所以你只需要把 Base URL 指到 CCSub 的 Anthropic 入口：
ANTHROPIC_BASE_URL=https://ccsub.xyz/api
ANTHROPIC_API_KEY=sk-你的CCSub密钥把模型选择改成 claude-sonnet-5。如果你是通过 CC Switch 管理多套配置，切换配置后建议先执行一次简单提问验证连通性，再进入正式工作目录。相关安装步骤可对照站内 安装配置 一文。
Cursor / Cherry Studio：走 OpenAI 兼容协议
这两个客户端更习惯 OpenAI 格式，填入 CCSub 的 OpenAI 兼容入口，请求会打到 /v1/chat/completions：
OPENAI_BASE_URL=https://ccsub.xyz/v1
OPENAI_API_KEY=sk-你的CCSub密钥
模型 ID：claude-sonnet-5Cherry Studio 在「模型服务」里手动新增一个模型条目，把上方的 ID 原样粘贴。Cursor 则在自定义模型配置中填入同一个 Base URL 和密钥。站内已有 Cherry Studio / Cursor / VS Code 共用同一把 Key 的教程，Sonnet 5 只是把模型 ID 换掉，其余字段不变。
Codex：走 Responses 协议
Codex 不用 OpenAI Chat 格式，它自动请求 /responses，所以 Base URL 要写成：
base_url = https://ccsub.xyz/openai
wire_api = responses
model = claude-sonnet-5把 Codex 指向 /openai 之后，密钥仍然是同一把 CCSub Key 直接复用，不需要单独申请。参数支持范围（哪些字段 Chat、Responses、Messages 各自接受）参考 API 参数与推理能力，尤其是做结构化输出或工具调用时，先核对参数差异能省掉很多试错。
第三步：Sonnet 5 到底多少钱
CCSub 的 Anthropic 系列计价口径是「按百万 Token 计」，下面的数值直接来自平台价格表：
- Claude Sonnet 5：输入 33.6，输出 168，缓存读取 3.36，缓存写入 42
- Claude Sonnet 4.6：输入 33.6，输出 168，缓存读取 3.36，缓存写入 42
- Claude Fable 5：输入 33.6，输出 168，缓存读取 3.36，缓存写入 42
- Claude Opus 4.8：输入 56，输出 280，缓存读取 5.6，缓存写入 70
- Claude Opus 4.7 / 4.6 / 4.5 / 4：与 Opus 4.8 同价，输入 56、输出 280
换算一下更直观：Sonnet 5 的输出价格大约是 Opus 4.8 的六成，而输入价格只有 Opus 的 60%。也就是说，日常写代码、改文档、跑中等复杂度的 Agent 流程，用 Sonnet 5 能明显压低账单；只有真正卡住的硬骨头再切 Opus。
另外一点容易被忽略：缓存读取价格只有输入价的十分之一（3.36 对 33.6）。如果你的工作流是「大段固定上下文 + 反复追问」，命中缓存的收益比换模型还大。充值前建议先看 注册与充值 了解账单口径，避免一次充太多。
第四步：什么时候用 Sonnet 5，什么时候降级到 Sonnet 4.6
很多人看到新模型就想全量切过去，其实更省钱的做法是分场景：
- 用 Sonnet 5：多文件重构、需要更长的推理链、复杂工具调用、代码 Review 里要理解跨模块依赖。
- 降级到 Sonnet 4.6：单文件改写、格式化、批量生成注释、简单的日志问答。两者单价一致，但 4.6 在简单任务上响应往往更干脆。
- 升级到 Opus 4.8：线上故障定位、架构级设计讨论、Sonnet 5 连续两轮答偏的情况。用之前先算一下：输入 56 对 33.6，一次长对话的成本差异会累积得很快。
实际操作里，不用改代码就能切换——Claude Code 改配置里的模型名，Cherry Studio 换下拉里的模型条目，Cursor 改自定义模型项。切换本身不涉及重新申请密钥。
常见错误排查
接新模型时踩坑集中在这几类，对照站内 故障排查 可以更快定位：
- 连接失败（connect_error）：先确认 Base URL 没有多写或少写
/v1。Anthropic 协议是https://ccsub.xyz/api，OpenAI 兼容是https://ccsub.xyz/v1，两者不能混用。本地代理或公司网络也可能拦截，先换网络环境试一次。 - 模型不存在：把
claude-sonnet-5写成了claude-sonnet-5.0之类的变体。直接复制/v1/models返回的 ID。 - 上游暂时不可用：这类错误通常是瞬时的，隔几秒重试即可；如果持续出现，注意是不是把 Codex 的
/openai地址填进了 Chat 类客户端。 - 密钥无效：确认密钥是
sk-开头，且没有多余空格或换行；多客户端共用同一把 Key 是支持的。
成本与充值提醒
Sonnet 5 的单价虽然和 4.6 一样，但新模型常常会让人不自觉地跑更长的对话。建议：先用小金额充值跑一轮真实任务，看清 Token 明细里的输入/输出/缓存分布，再决定主力模型。如果发现缓存写入偏高，说明上下文结构在频繁变化，把固定部分前置可以降低缓存写入成本。
看懂 Token 明细的方法在 入门使用手册 里有说明。还没注册或还没创建密钥的，先走一遍 新手入门。基础疑问（能不能直连、支持图片识别吗、能建几个 Key）集中在 常见问题。
现在就可以做的事
如果你已经装好客户端，按下面顺序走一遍，五分钟内就能用上 Sonnet 5：
- 用
curl查一次/v1/models，确认claude-sonnet-5在列表里。 - 把对应客户端的 Base URL 和密钥填对（Anthropic 用
/api，OpenAI 兼容用/v1，Codex 用/openai）。 - 模型名填
claude-sonnet-5，发一句简单提问验证连通。 - 跑一个真实的中等任务，去账单里看一次 Token 明细。
- 把简单任务切回
claude-sonnet-4-6，对比一下响应和成本，形成自己的切换习惯。
Sonnet 5 已经在 CCSub 开放，同一把 Key 就能在 Claude Code、Cursor、Cherry Studio、Codex 之间复用。先把模型 ID 写对，剩下的事情交给模型。
CCSub API 调用方法
如果你使用 OpenAI 兼容客户端，把 Base URL 设置为 https://ccsub.xyz/v1，API Key 使用控制台创建的 sk-你的CCSub密钥。
export OPENAI_BASE_URL=https://ccsub.xyz/v1
export OPENAI_API_KEY=sk-你的CCSub密钥Codex 请使用原生 Responses 专用地址。先设置密钥：
export CCSUB_API_KEY=sk-你的CCSub密钥再在 ~/.codex/config.toml 配置自定义 provider：
model = "gpt-5.6-sol"
model_provider = "ccsub"
[model_providers.ccsub]
name = "CCSub"
base_url = "https://ccsub.xyz/openai"
env_key = "CCSUB_API_KEY"
wire_api = "responses"Claude Code 使用专用 Messages Base URL：
export ANTHROPIC_BASE_URL=https://ccsub.xyz/api
export ANTHROPIC_AUTH_TOKEN=sk-你的CCSub密钥需要确认当前可用模型时，可以请求 GET https://ccsub.xyz/v1/models。正式长任务前，建议先用短请求验证 Key、余额和模型是否正常。