VS Code 是最多人写代码的地方，但官方插件默认只认自己的登录态或固定的云端地址。想把它接到 CCSub 中转上，核心其实只有三件事：换 Base URL、填 API Key、选对模型 ID。这篇教程按真实操作顺序走一遍，并把容易踩的坑提前说清楚。开始前建议先读一遍 安装配置 与 新手入门，把账号和密钥准备好。
一、先准备好 API Key 和 Base URL
在 CCSub 创建一把 API 密钥后，你会拿到形如 sk-你的CCSub密钥 的字符串。请把它当作密码保管，不要写进会被提交到 Git 的配置文件里。
接下来记住三个地址，后面所有插件都围绕它们配置：
- OpenAI 兼容接口：
https://ccsub.xyz/v1，对话请求发往https://ccsub.xyz/v1/chat/completions - Anthropic 原生接口：
https://ccsub.xyz/api，客户端会自动请求/v1/messages - Codex 原生接口：
https://ccsub.xyz/openai，走 Responses 协议，请求/responses
不确定某把 Key 能用哪些模型？先查一次列表，比在插件里反复试要快：GET https://ccsub.xyz/v1/models二、在 VS Code 里挑选合适的插件
VS Code 本身不带模型能力，需要借助扩展。按协议分成三类，你对号入座即可：
1. 兼容 OpenAI 协议的编程助手
这类插件在设置里通常有 Base URL / API Base / 自定义端点 和 API Key 两个字段。把 Base URL 填成 https://ccsub.xyz/v1，Key 填你的 sk- 密钥，再在模型下拉或手填框里写入模型 ID。
2. 支持 Anthropic 协议的插件
少数插件允许选择 Anthropic 作为提供方。此时 Base URL 要填 https://ccsub.xyz/api，插件会自行拼出 /v1/messages 请求。注意 Anthropic 协议与 OpenAI 协议的地址不是同一个，填错是最常见的 404 来源。
3. 直接对接 Codex 的扩展
如果你用的是 Codex 风格的客户端或集成，把地址设为 https://ccsub.xyz/openai，请求方式选择 wire_api = responses。这类客户端会自动请求 /responses，不需要你手动改路径。
三、填模型 ID：写全名，别写别名
很多 401 之外的报错，其实是模型名写错。插件里请填完整 ID，例如：
- 写代码、日常补全：
claude-sonnet-4-6、gpt-5.6-sol - 复杂重构、长链路推理：
claude-opus-4-8、claude-opus-4-7 - 轻量任务、快速问答：
claude-haiku-4-5、gpt-5.4-mini - Codex 场景：
gpt-5.3-codex
如果插件只提供固定下拉框、没有自定义输入，那它多半不支持自填模型，只能选它内置的列表，这种插件接入意义有限，换一个更省时间。
四、用一条命令验证配置是否真的通了
在插件里点半天不如先跑一条命令。打开终端，用你的 Key 发一次最小请求：
curl https://ccsub.xyz/v1/chat/completions \
-H "Authorization: Bearer sk-你的CCSub密钥" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-5.6-sol",
"messages": [{"role": "user", "content": "say hi"}]
}'能返回内容，说明 Key、地址、模型三者都没问题，剩下的就纯粹是插件配置问题。若这一步就报错，先别改插件，直接去 故障排查 按症状对照。
五、和 Cursor、Cherry Studio 共用同一把 Key 有什么差别
三者的差别不在 Key，而在协议偏好和上下文管理：
- VS Code：插件生态最杂，同一把 Key 在不同插件里可能一个走 OpenAI 协议、一个走 Anthropic 协议，所以你必须分别核对 Base URL，不能复制粘贴了事。
- Cursor：内置了模型选择和联网流程，改动点集中在设置页的地址与 Key，配置项更少、更省心，但自定义空间也小。
- Cherry Studio：偏对话与知识库场景，同样支持填地址和 Key，更适合把 CCSub 当通用对话入口，而不是编辑器内补全。
一句话总结：Key 只需要一把，但每换一个客户端，都要重新确认它用的是哪套协议、该填哪个地址。
六、插件侧常见错误自查清单
- 401 / 未授权：先看 Key 是否完整复制（首尾空格、换行是高频杀手），再确认请求头是
Authorization: Bearer sk-...而不是别的字段名。 - 404 / 路径不存在：检查是否把 Anthropic 协议配到了
/v1，或把 OpenAI 协议配到了/api。两者不可混用。 - 连接失败 / 超时：多为本地网络与代理设置问题。如果你的代理规则把请求拦在本地，插件就会直接超时，处理方式见故障排查文档。
- 模型不可用：先用
GET https://ccsub.xyz/v1/models核对模型 ID 是否存在，再检查是否拼错大小写或漏了版本号。 - 返回空内容：有时是插件对响应格式解析过于严格。先用上面的 curl 确认服务端有正常返回，再判断是不是插件兼容问题。
七、成本提醒与下一步
编程类插件的消耗比聊天高得多，补全和自动改写会持续产生输入 Token。以编程场景的常见用量看，先用中等价位模型试跑，确认体验和花费都符合预期后再考虑更强的模型，是更稳妥的做法。密钥余额与充值方式见 注册与充值，参数与推理能力细节见 API 参数与推理能力。
配置顺序再回顾一遍：创建密钥 → 按插件协议填 https://ccsub.xyz/v1 或 https://ccsub.xyz/api → 填入完整模型 ID → 用 curl 验证一次。跑通之后，VS Code 就能和其他客户端共用同一把 Key，不需要为每个工具单独申请账号。遇到卡住的地方，欢迎对照 常见问题 继续排查。
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、余额和模型是否正常。