AI Agent 开发实战(03):Claude Code 接入 OpenRouter
2026/7/27 7:44:20 网站建设 项目流程

发布时间: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 控制台 →KeysCreate 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_LEVELmax强制最强推理

💡这就是中转站的优势:想换模型,只改ANTHROPIC_MODEL一个值。
比如改成openai/gpt-5anthropic/claude-opus-4google/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-proanthropic/claude-opus-4),不是官方那种点号格式。写错会直接 404。

3. 免费额度低、频繁 429 限流
OpenRouter 新账号免费额度较小,编码任务容易触发限流。可换更小的模型,或自备额度后再用。

4. 每次开终端都要重设环境变量(临时方案的痛点)
$env:设置只管当前终端。这也是为什么这只是"临时变量简单版"——简单但不持久。第 04 篇的 CCSwitch 就是来根治这个问题的:写一次配置,永久生效,一键切换模型。

5. OpenRouter 国内访问偶尔不稳
多数时候正常,少数时段延迟高。真要长期稳定,后面可以用中转站兜底,或等第 04 篇的 CCSwitch 做多源容灾。


下一步

现在 DeepSeek(官网)和 OpenRouter(中转站)都跑通了,两个模型随时能切。

但手动管环境变量终究不是长久之计:

→ AI Agent 开发实战(04):CCSwitch 配置

第 04 篇用CCSwitch 一个配置搞定所有模型切换——写完就再也不用敲$env:了,那是正式方案。

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询