一个 Base URL，接通你已有的编程工具
CodeBridge API 把 Claude Code、Kilo Code、Cursor 和本地 CLI 的接入收敛成一份可逐项核对的配置清单：先确认协议，再确认 Base URL 和模型名，最后发一条真实请求确认通路，而不是反复换参数碰运气。
建议顺序：注册 → 建 Key → 请求 /v1/models 核对模型名 → 填入工具 → 发首个请求。账号和额度都记在本站。
先按工具选协议入口
最常见的接入失败，是把 Anthropic 协议的工具填成了 OpenAI 兼容地址，或反过来。先在这张表里定位你的工具，再去填配置。
| 工具 | 协议 / 接口 | Base URL 填法 | 模型名来源 |
|---|---|---|---|
| Claude Code | Anthropic 兼容 | 根域名（不带 /v1） | /v1/models 实际返回 |
| Kilo Code | OpenAI 兼容 | 根域名 + /v1 | /v1/models 实际返回 |
| Cursor | OpenAI 兼容（自定义 endpoint） | 根域名 + /v1 | /v1/models 实际返回 |
| 本地 CLI / 脚本 | OpenAI 兼容 | 根域名 + /v1 | /v1/models 实际返回 |
五步接通
注册并验证邮箱
用邮箱验证码完成注册；验证码未到时请检查垃圾邮件目录后间隔重试。忘记密码可用已验证邮箱自助恢复。
为这次接入单独建 Key
本地试用、团队项目和自动化任务分别创建 Key，不共用一把凭证，方便随时回收。
请求模型列表核对模型名
先查 /v1/models，把返回里的真实模型 ID 复制到工具配置，不要照抄文档里的示例名。
按上表填入工具
Claude Code 用根域名 + Anthropic 协议；OpenAI 兼容工具用根域名 + /v1。协议和 Base URL 要成对匹配。
发一条真实请求确认通路
先用一句短 prompt 验证能正常返回，再接入项目里的真实任务。
# 第 3 步：核对模型名
curl https://codebridgeapi.top/v1/models \
-H "Authorization: Bearer YOUR_API_KEY"
# 第 5 步：发首个请求
curl https://codebridgeapi.top/v1/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"<从 /v1/models 复制>","messages":[{"role":"user","content":"ping"}]}'接不通时按症状排查
大多数问题不用换 Key、也不用重装工具，按下面的对应关系逐项检查即可。
| 症状 | 常见原因 | 检查项 |
|---|---|---|
| 401 未授权 | Key 缺失、写错或带了多余空格 | 确认 Authorization: Bearer 后是完整 Key，且 Key 属于当前站点账号 |
| 404 / 路径不存在 | 协议与 Base URL 不匹配 | OpenAI 兼容工具要带 /v1；Claude Code 用根域名不带 /v1 |
| 模型不存在 / model not found | 照抄了文档示例模型名 | 以 /v1/models 的实际返回为准，复制真实 ID |
| 能列模型但对话报错 | 工具用了错误的协议格式 | 确认工具选的是 Anthropic 还是 OpenAI 兼容，与上表一致 |
| 额度异常 / 扣费看不懂 | 混淆了充值兑换率和调用倍率 | 调用扣费 = 模型基准价 × 来源倍率，与充值兑换率是两回事 |
额度与计费
充值 ¥1 到账 $1 API 额度。充值兑换率与调用倍率是分开的两件事。
- 低价来源倍率：default 0.18x、Kiro Pro 0.18x、特惠 0.18x、GPT Team 0.18x。
- 官转档为独立计费分组（特惠来源），倍率 1.4x，不代表模型厂商官方服务。
- 调用扣费 = 模型基准价 × 来源倍率。
- 当前域名的账号、API Key、订单和余额独立记录。
- 本站由 CodeBridge API 运营团队运营，是第三方兼容 API 服务，不是模型厂商官方服务。
符合最新活动资格的用户，累计前 ¥50 实付享 1:1 API 额度赠送，最多赠送 $50；超过部分及达到上限后的充值不再赠送。资格与口径以本站公告和后台核验为准。
常见问题
Claude Code 和 Cursor 的 Base URL 填法一样吗？
不一样。Claude Code 走 Anthropic 兼容协议，填根域名、不带 /v1；Cursor 等 OpenAI 兼容工具填根域名 + /v1。协议和地址必须成对匹配。
能直接照着教程填模型名吗？
不建议。模型名必须以 /v1/models 的实际返回为准，文档示例可能与当前可用模型不一致。
一定要为每个工具单独建 Key 吗？
建议这样做。本地试用、团队项目和自动化任务分开建 Key，某一把泄露或需要回收时不影响其他用途。
接入报 401，是不是要重新买额度？
通常不是。401 是鉴权问题，先确认 Key 完整无空格、且属于当前站点账号，与额度无关。
CodeBridge API 是官方服务吗？
不是。它是第三方兼容 API 服务，通过兼容网关路由 Claude / GPT 模型请求，不是 Anthropic、OpenAI 或其他厂商的官方站点。
下一步
在本站完成注册、建 Key、充值
账号、额度、API Key 都记在 codebridgeapi.top。Claude Code 填根域名；Cursor / Cline / Kilo Code 填根域名 + /v1。