:Claude Code 接入 OpenRouter)
发布时间2026-07-14标签AI Agent实战Claude CodeOpenRouter操作指南目标让 Claude Code 用OpenRouter一个 Key 调用多个平台的模型Claude / DeepSeek / GPT 等随时切换不用为每个平台单独申请 Key。⚠️本文同样属于临时变量方案。每个新终端都要重设一遍变量简单但不持久。第 04 篇会用CCSwitch统一管理多模型配置永久生效、一键切换——那是正式方案。调大模型你有三个选择在动手之前先搞清楚大模型从哪来。现在接 Claude Code或其它 Agent 框架用模型主流就三条路方式代表优点缺点① 官网直连Anthropic、DeepSeek、OpenAI最稳、特性最新、官方支持、数据不过第三方一家一 Key 一账号、切换繁琐价格偏高国内直连 Anthropic 受限② 聚合平台火山引擎、阿里百炼、腾讯云国内访问友好、云生态整合、企业级合规接入流程偏重、生态绑定、模型选择远少于中转站③ 中转站OpenRouter、OneAPI 等一个 Key 调多个模型、最灵活、能绕区域限制偶发下架/限流非所有官方特性都支持数据过第三方有跑路风险本文以 ③ 中转站中的 OpenRouter 为例演示接入。上一篇 DeepSeek 直接连是 ① 官网② 聚合平台留作进阶了解新手先用 ①③ 足够。一句话理解三者关系官网是厂商自营店聚合平台是电商超市中转站是代购。环境准备已完成第 01 篇基础环境 Claude Code 已安装并能启动一个 OpenRouter 账号并拿到 API Key官网控制台 →Keys→ 创建形如sk-or-xxxx网络能正常访问 OpenRouter 服务步骤1. 拿到 OpenRouter API Key登录 OpenRouter 控制台 →Keys→Create Key复制形如sk-or-xxxx的密钥。只显示一次存好。2. 设置环境变量OpenRouter 提供 Anthropic 兼容端点https://openrouter.ai/api/anthropicClaude Code 可以直接对话不用架任何代理。在同一终端里依次执行Windows PowerShell$env:ANTHROPIC_BASE_URL https://openrouter.ai/api/anthropic $env:ANTHROPIC_AUTH_TOKEN sk-or-你的openrouter key $env:ANTHROPIC_MODEL deepseek/deepseek-v4-pro $env:ANTHROPIC_DEFAULT_OPUS_MODEL anthropic/claude-opus-4 $env:ANTHROPIC_DEFAULT_SONNET_MODEL deepseek/deepseek-v4-pro $env:ANTHROPIC_DEFAULT_HAIKU_MODEL deepseek/deepseek-v4-flash $env:CLAUDE_CODE_SUBAGENT_MODEL deepseek/deepseek-v4-flash $env:CLAUDE_CODE_EFFORT_LEVEL maxMac / Linux 把$env:换成export等号右边加引号即可。每个变量在做什么变量作用ANTHROPIC_BASE_URL把请求从 Anthropic 官方切到 OpenRouter 的兼容端点ANTHROPIC_AUTH_TOKEN用 OpenRouter Key 认证以sk-or-开头ANTHROPIC_MODEL默认模型OpenRouter 用厂商/模型斜杠格式ANTHROPIC_DEFAULT_*_MODEL覆盖 Claude Code 内的三档模型选择CLAUDE_CODE_SUBAGENT_MODEL子 Agent 用轻量模型省成本提速CLAUDE_CODE_EFFORT_LEVELmax强制最强推理这就是中转站的优势想换模型只改ANTHROPIC_MODEL一个值。比如改成openai/gpt-5、anthropic/claude-opus-4、google/gemini-2.5-pro都能直接试不用再申请任何 Key。建议把这八行存成or.ps1脚本每次新开终端跑一下即可不用手打。3. 进入项目目录并启动cd ~/ai-agent-lab # Windows 可能需要放开脚本执行策略只需第一次 Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass claude进入 Claude Code 后确认模型已经切换 你现在的底层模型是什么它应该告诉你用的是 OpenRouter 上的某个模型。回复里提到deepseek或你设置的模型名说明请求确实走到了 OpenRouter。验证三步全过 接入成功八行环境变量设好无报错claude能正常进入交互界面问一句底层模型是什么回复确认走的是 OpenRouter 上的模型做个最小编码测试确认能力无损 用 Python 写一个快速排序能正常生成代码 编码能力正常。踩坑记录1. 忘了设ANTHROPIC_AUTH_TOKEN直接跑 claudeClaude Code 会尝试用之前登录的 Anthropic 账号绕过 OpenRouter。确保这个变量以sk-or-开头是 OpenRouter 的 Key不是 Anthropic 或 DeepSeek 的。2. 模型名格式写错OpenRouter 用厂商/模型斜杠格式如deepseek/deepseek-v4-pro、anthropic/claude-opus-4不是官方那种点号格式。写错会直接 404。3. 免费额度低、频繁 429 限流OpenRouter 新账号免费额度较小编码任务容易触发限流。可换更小的模型或自备额度后再用。4. 每次开终端都要重设环境变量临时方案的痛点$env:设置只管当前终端。这也是为什么这只是临时变量简单版——简单但不持久。第 04 篇的 CCSwitch 就是来根治这个问题的写一次配置永久生效一键切换模型。5. OpenRouter 国内访问偶尔不稳多数时候正常少数时段延迟高。真要长期稳定后面可以用中转站兜底或等第 04 篇的 CCSwitch 做多源容灾。下一步现在 DeepSeek官网和 OpenRouter中转站都跑通了两个模型随时能切。但手动管环境变量终究不是长久之计→ AI Agent 开发实战04CCSwitch 配置第 04 篇用CCSwitch 一个配置搞定所有模型切换——写完就再也不用敲$env:了那是正式方案。