指南目录(34 篇)
通用
Claude Code 接入 OpenRouter 与第三方 API 教程
Claude Code 采用 Anthropic Messages 协议。OpenRouter 已原生提供 Anthropic 兼容入口,配置环境变量即可直连调用免费模型;仅支持 OpenAI Chat Completions 的平台可通过本机网关转换协议接入。
- 适用对象
- 已安装 Claude Code、希望使用 OpenRouter 或其他第三方免费额度的开发者
- 预计用时
- 约 5 分钟
- 更新时间
准备
- 已安装 Claude Code(首次无订阅启动可在
~/.claude.json写入"hasCompletedOnboarding": true) - OpenRouter 的 API Key(在 openrouter.ai/settings/keys 创建,免绑卡)
步骤
挑选支持工具调用的免费模型,注意根地址无 /v1
Claude Code 读写文件与执行命令依赖模型的工具调用(Tool Calling)能力。OpenRouter 上免充值可用、且支持工具调用的
:free模型当前可选:thinkingmachines/inkling-2-small:free(100 万上下文推理模型)xingchen-agi/xing4.0-29b-a4b:free(256K 上下文,默认开启推理)minimax/minimax-m3.1-flash:free(100 万上下文多模态)
注意 OpenRouter 面向 Claude Code 的 Anthropic 兼容根地址是
https://openrouter.ai/api(末尾不要加/v1),与常规 OpenAI 兼容地址不同。设置鉴权与模型映射环境变量
按 OpenRouter 官方接入规则,密钥放在
ANTHROPIC_AUTH_TOKEN,同时必须显式将ANTHROPIC_API_KEY设为空字符串""(否则 Claude Code 可能回退尝试官方原生鉴权)。建议连内部默认小模型变量一并指向所选免费模型,避免后台子任务请求不存在的官方 Haiku 报错:export ANTHROPIC_BASE_URL="https://openrouter.ai/api" export ANTHROPIC_AUTH_TOKEN="sk-or-v1-你的OpenRouter密钥" export ANTHROPIC_API_KEY="" export ANTHROPIC_MODEL="thinkingmachines/inkling-2-small:free" export ANTHROPIC_DEFAULT_HAIKU_MODEL="thinkingmachines/inkling-2-small:free" export ANTHROPIC_DEFAULT_SONNET_MODEL="thinkingmachines/inkling-2-small:free" claude执行 /status 确认连接并接入其他平台
进入交互界面后先输入
/status,确认显示Auth token: ANTHROPIC_AUTH_TOKEN与Anthropic base URL: https://openrouter.ai/api,再测试一次读取和修改本地文件。如果是接入其他免费平台:
- 阿里云百炼与硅基流动:两家均自带原生 Anthropic 兼容地址,配置写法见 Claude Code 接入百炼与硅基流动教程;
- 仅提供 OpenAI Chat Completions 的平台(如火山方舟、Groq、百度千帆):在本机启动 Magpie 网关,在网关里添加该平台,再从 Agent 页指派给 Claude Code 即可完成协议转换。
注意事项
- OpenRouter 未累计充值满
$10的账号,调用:free模型限额为每分钟 20 次、每天 50 次;Claude Code 连续执行多步工具调用时较容易触及分钟限流(返回429)。 - 需要持久化配置时,可将上述变量写进用户目录
~/.claude/settings.json的"env": { ... }中(不要写进项目仓库内会被提交的.claude/settings.json)。
常见问题
为什么填了 https://openrouter.ai/api/v1 会返回 404?
多写了 /v1。Claude Code 自己会在基础地址后拼接 /v1/messages,填 https://openrouter.ai/api 才能拼出正确路径。
只设置了 ANTHROPIC_MODEL,为什么刚聊两句就提示模型不存在?
Claude Code 会在后台用 ANTHROPIC_DEFAULT_HAIKU_MODEL 生成会话标题或执行轻量检索,未覆盖该变量时会去请求官方 Haiku 模型,把默认三档模型变量都指过去即可解决。
相关优惠
- 模型OpenRouterOpenRouter 免费开放星辰 Xing4.0 29B:256K 上下文智能体模型Xing4.0-29B-A4B 输入输出全免费,262,144 上下文,支持工具调用
- 模型OpenRouterOpenRouter 免费开放 Liquid LFM3-1.7B:256K 上下文智能体小模型LFM3-1.7B 输入输出全免费,262,144 上下文,支持工具调用与结构化输出
- 模型OpenRouterRecraft V4.1 Flash V2 在 OpenRouter 限时免费:快速文生图,11 月 28 日截止Recraft V4.1 Flash V2 免费版,文生图不收费,11 月 28 日截止
- 模型OpenRouterInkling 2 Small 在 OpenRouter 和 OpenCode Zen 限时免费:Thinking Machines 推理模型,1M 上下文Inkling 2 Small 免费版,输入输出都免费,1M 上下文,OpenRouter 与 OpenCode Zen 双路由
- 模型OpenRouterParticle-1 在 OpenRouter 和 Kilo Code 限时免费:DeepSeek V4.1 Flash 强化版编码模型,1M 上下文Particle-1 免费版,OpenRouter 与 Kilo Code 双路由,输入输出都免费,1M 上下文
- 模型OpenRouterOpenRouter 免费不限量 Crouton Alpha:1M 上下文,对标 Opus 5免费不限量调用,1M 上下文
参考链接
- OpenRouter 官方 Claude Code 接入指南openrouter.ai/docs/cookbook/coding-agents/claude-code-integration
- OpenRouter 模型列表openrouter.ai/models
- Claude Code 网关配置文档code.claude.com/docs/en/llm-gateway-connect