发布时间：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。

---

验证

三步全过 = 接入成功：

1. 八行环境变量设好，无报错
2. claude 能正常进入交互界面
3. 问一句"底层模型是什么"，回复确认走的是 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: 了，那是正式方案。