赛博鸡蛋
指南目录(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 创建,免绑卡)

步骤

  1. 挑选支持工具调用的免费模型,注意根地址无 /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 兼容地址不同。

  2. 设置鉴权与模型映射环境变量

    按 OpenRouter 官方接入规则,密钥放在 ANTHROPIC_AUTH_TOKEN,同时必须显式将 ANTHROPIC_API_KEY 设为空字符串 ""(否则 Claude Code 可能回退尝试官方原生鉴权)。建议连内部默认小模型变量一并指向所选免费模型,避免后台子任务请求不存在的官方 Haiku 报错:

    bash
    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
  3. 执行 /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 模型,把默认三档模型变量都指过去即可解决。

相关优惠

参考链接

相关指南

搜索优惠

提交优惠线索

粘贴官方活动页、定价页或文档链接,每日定时核验通过后发布。

无需注册,提交后可查看审核进度