首页 / 指南 / 把免费 Key 接入 Claude Code / Codex / Cline / OpenCode
把免费 Key 接入 Claude Code / Codex / Cline / OpenCode
接不上的最常见原因是协议不匹配:Claude Code 要求 Anthropic 协议,Codex CLI 要求 Responses API,Cline、OpenCode 多用 OpenAI 兼容格式;密钥的协议与工具要求的协议不一致是失败的第一原因。配置细节以各工具官方文档为准。
先看协议:工具要什么,密钥给什么
接不上的最常见原因是协议不匹配。不同工具要求的协议不同(以各工具官方文档为准,工具版本更新可能改变支持的协议):
| 工具 | 要求的协议 |
|---|---|
| Claude Code | Anthropic 协议 |
| Codex CLI | Responses API |
| Cline | 多协议,含 OpenAI 兼容格式 |
| OpenCode | 多协议,含 OpenAI 兼容格式 |
一条只提供 OpenAI Chat Completions 格式的免费密钥,无法直接插进要求 Anthropic 协议或 Responses API 的工具。接之前先确认两点:工具支持的协议,以及你的密钥提供的是哪种协议。
通用接入步骤
- 在工具的官方文档里找到配置入口与配置项(Base URL、API Key、模型名的填写位置);不要凭记忆拼配置项名称。
- 按厂商官方文档填写 Base URL 与模型名;本站数据未注明 Base URL 与模型 ID 的额度,以厂商官方页面为准。
- 先用一个小请求验证:能返回结果再接正式任务。
- 检查模型是否支持工具调用(function calling):编程工具依赖工具调用执行命令、读写文件;有的免费模型不支持或支持得不可靠,接上后会报错或行为异常。
两个常见坑
- Base URL 路径重复:有的工具要求填到
/v1,工具自己拼/chat/completions;两边都加会 404。见 常见问题 Q6。 - 客户端内额度不能外接:Qoder、WorkBuddy、CodeBuddy、TRAE、Kiro 的注意事项都写明「仅限自家客户端内使用」,积分不能导出成 API Key 接入其他工具。
本站哪些额度是 OpenAI 兼容的
本站在架 43 条里,标注 OpenAI 兼容的有 23 条:
- Spark-X2.6 免费体验额度(科大讯飞 · 星辰 MaaS)——见首页总览
- 新人免费额度(多模型合计超 7000 万)(阿里云百炼)
- 新用户 Token 礼包(智谱 BigModel)
- GLM-4.5-Flash / GLM-4.7-Flash 免费模型(智谱 BigModel)
- 新人每模型 100 万 Token 体验包(腾讯云 TokenHub)——见首页总览
- 新用户全模型通用资源包(七牛云 AI 推理)——见首页总览
- 注册免费额度 + 实名代金券(硅基流动 SiliconFlow)
- 新用户免费测试权益(Kimi 开放平台)——见首页总览
- 公测通用积分池(商汤 SenseNova)——见首页总览
- API-Inference 每日免费额度(ModelScope 魔搭)——见首页总览
- 每日免费 Token(蚂蚁百灵 Ling Studio)——见首页总览
- 促销模型每日免费 Token(华为云码道 CodeArts)——见首页总览
- Token Factory 免费模型 API(AMD Radeon Cloud)——见首页总览
- K2-Horizon 每日免费额度(IFM)——见首页总览
- :free 免费模型(OpenRouter)
- Free Plan 高速推理(Groq)
- Gemini API 免费层(Google AI Studio)
- 每日免费 Neurons(Cloudflare Workers AI)
- Inference 试用额度(Cerebras)——见首页总览
- 新用户 Sandbox 促销额度(Novita AI)——见首页总览
- 免费层月度额度(Vercel AI Gateway)——见首页总览
- 免费公网翻译 API(哔哩哔哩 Index-Translate)——见首页总览
- Builder 组合额度包(Nebius AI Builder Program)——见首页总览
协议转换网关
市面上有把一种协议转成另一种的网关工具(例如 Magpie、CLIProxyAPI,见社区整理)。网关能解协议不匹配的问题,但也带来额外一跳、信任与维护成本;是否使用、如何配置,以各工具官方文档为准。本站不提供中转站/公益站的搭建与使用方法。
提醒:各厂商的控制台入口、Key 创建位置、Base URL 与模型 ID 以厂商官方文档为准;各工具的配置方式以各工具官方文档为准。本站不提供绕过地区或支付规则的方法。