Claude Code + OpenRouter：真正把原理讲明白的配置指南
你可能听人盛赞过 Claude Code，也可能听到有人同时提到 OpenRouter，紧接着通常就是一堆环境变量、一张终端截图。如果你刚接触这些，难免觉得大家都跳过了铺垫，直接甩专业术语。这篇文章正是补上那缺失的一步——该展开的地方我们会展开，把容易卡住的概念讲透，读完你会真正理解每一步在做什么，而不是照着复制命令、心里没底。
先快速认识这两样东西。Claude Code 是 Anthropic 推出的终端编码代理：它能读你的文件、改代码、跑命令，默认直接跟 Anthropic 服务器对话。OpenRouter 则是一个“模型调度台”——专门给各种 AI 模型做路由的中间层。它用不着每一款应用都分别对接各家 AI 服务商，而是居中转发，你只要用一个账号、一个控制面板，就能把请求发给不同的模型，花费也能在一个地方看清（免费和开源模型也支持）。OpenRouter 支持的所有模型可以在这里查看。
有个诚实的提醒：OpenRouter 自己的文档写明，这个组合仅保证在 Anthropic 自家模型上工作正常。你其实没有换掉 Claude 的大脑，只是让对话通道改走了别的线路。
顺便做个术语澄清：“OpenAI 兼容”。Claude Code 发出的是 Anthropic 格式的请求，而有些服务端只认 OpenAI 格式。要是你把 Claude Code 误指到这种服务端，就会收到一堆乱码报错，好比给只懂西班牙语的人寄去了一封法语信。OpenRouter 有一个本身就说 Anthropic “语言”的接口，省掉了翻译环节，也不需要额外搭代理。
等等，那我用的是 zsh 还是 bash？我怎么会知道？这是本指南里最劝退新手的问题，而且完全问得合理。十秒就能查出来：打开终端，输入下面这行，然后回车：
echo $SHELL
输出会对应两种情况：以 /zsh 结尾（比如 /bin/zsh），说明你在用 zsh，现代 Mac 设备默认就是这个；以 /bash 结尾（比如 /bin/bash），说明你在用 bash。
这在老款 Mac、许多 Linux 环境以及适用于 Linux 的 Windows 子系统（WSL）中很常见。就这些。看显示的是哪个，你就知道稍后该编辑哪个文件：zsh 用户编辑 ~/.zshrc，bash 用户编辑 ~/.bashrc。
1. 安装 Claude Code
curl -fsSL https://claude.ai/install.sh | bash
2. 获取 OpenRouter API 密钥
在 openrouter.ai 上申请一个 OpenRouter API 密钥，并给账户充一些额度。
3. 配置环境变量
把下面这些内容加到你的 shell 配置文件（就是上面找到的那个）里，然后重启终端：
export OPENROUTER_API_KEY = "your-openrouter-api-key"
export ANTHROPIC_BASE_URL = "https://openrouter.ai/api"
export ANTHROPIC_AUTH_TOKEN = " $OPENROUTER_API_KEY "
export ANTHROPIC_API_KEY = ""
最后一行是故意留空的，不是笔误。那里如果残留旧值，可能引发让人摸不着头脑的认证错误。另外，这些行最好放在文件末尾，否则后面如果重新定义了 OPENROUTER_API_KEY，token 会悄悄变成空值。
如果希望按项目单独配置，可以改用 settings 文件：
{
"env": {
"ANTHROPIC_BASE_URL": "https://openrouter.ai/api",
"ANTHROPIC_AUTH_TOKEN": "<your-openrouter-api-key>",
"ANTHROPIC_API_KEY": ""
}
}
4. 清除旧的登录状态
然后完全重启 Claude Code。
5. 启动 Claude Code
cd /path/to/your/project
第 6 步：确认配置生效
运行 /status，应该能看到 ANTHROPIC_AUTH_TOKEN 和 OpenRouter 的 base URL 都正确显示。再去 OpenRouter 的 activity dashboard 看一眼——看着请求一条条冒出来，还挺有成就感的。到这里，准备工作就全部完成了，一批模型正排队等着 Claude Code 来调用。
总结
整个流程其实很简单：安装 Claude Code，申请一个 OpenRouter API key，把四个环境变量写进正确的配置文件，执行 /logout，重新启动，最后用 /status 确认一切正常。十分钟搞定。
建议从 Claude 系列模型开始用，等熟悉了「正常跑起来」是什么感觉，再去探索其他模型。