发布时间:2026-07-14
标签:AI Agent|实战|Claude Code|OpenRouter|操作指南
目标
让 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/anthropic,Claude 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 = "max"Mac / 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_LEVEL | max强制最强推理 |
💡这就是中转站的优势:想换模型,只改
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,直接跑 claude
Claude 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 开发实战(04):CCSwitch 配置
第 04 篇用CCSwitch 一个配置搞定所有模型切换——写完就再也不用敲$env:了,那是正式方案。