Claude Code
在 Claude Code(Anthropic 终端编程助手)中接入 AI Router 网关 —— 通过设置 Anthropic 兼容的 Base URL 与 API Key,即可用一套密钥调用多家模型供应商。
本页说明
Claude Code 是 Anthropic 推出的终端编程助手。它通过环境变量读取接入点地址与密钥,因此可以将其指向 AI Router —— 一个 OpenAI / Anthropic 兼容的统一 AI 网关。配置完成后,你只需一个 AI Router API Key 和一个 Base URL,即可在 Claude Code 中调用网关后端接入的各家模型。
- Claude Code 官方文档:https://www.anthropic.com/claude-code
- AI Router 源码仓库:https://github.com/ssgzy/Router-new-api
工作原理
Claude Code 默认调用 Anthropic 官方接口。它支持通过两个环境变量改写请求目标:
ANTHROPIC_BASE_URL—— Anthropic 兼容接口的基础地址。指向 AI Router 后即由网关接管转发。ANTHROPIC_AUTH_TOKEN—— 鉴权令牌。填入你在 AI Router 中创建的 API Key(形如sk-...)。
重要:改写 Base URL 后的行为
设置 ANTHROPIC_BASE_URL 后,Claude Code 的全部请求(包括其默认/预设模型)都会改走你配置的接入点,
而不再消耗 Anthropic 官方账号额度。用量与计费以 AI Router 一侧的记录为准。
准备工作
在配置 Claude Code 之前,请先在 AI Router 控制台准备好两样东西:
获取 Base URL。 使用你的 AI Router 部署地址。本文档统一以演示占位地址
https://ai.sammier.com 表示;OpenAI 兼容端点为 https://ai.sammier.com/v1。
请替换为你实际的部署域名。
创建 API Key。 在 AI Router 控制台的令牌(Token)管理中新建一个密钥,复制形如 sk-...
的字符串。该密钥用于鉴权,并关联到对应的模型分组与配额。
安装 Claude Code
Claude Code 跨平台支持 Windows、macOS 与 Linux。
在终端运行官方安装脚本:
curl -fsSL https://claude.ai/install.sh | bash如果安装后提示需要把可执行目录加入 PATH,按提示执行类似命令(按你的 shell 选择 .bashrc 或 .zshrc):
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc && source ~/.zshrcClaude Code 依赖 Node.js 环境,且在 Windows 上建议通过 Git Bash 安装。
-
安装 Node.js LTS 版本(保持默认设置即可)。
-
安装 Git for Windows(提供 Git Bash)。
-
打开 PowerShell,执行:
npm install -g @anthropic-ai/claude-code
Windows 注意事项
- 建议使用 PowerShell 而非 CMD。
- 遇到权限问题时,尝试以管理员身份运行。
- 个别杀毒软件可能误报,必要时将其加入白名单。
安装完成后,验证版本:
claude --version显示版本号即表示安装成功。
接入 AI Router
把 Claude Code 的接入点指向 AI Router,只需设置两个环境变量。将下面的占位值替换为你自己的 Base URL 与 API Key。
临时生效(仅当前终端会话):
export ANTHROPIC_BASE_URL="https://ai.sammier.com"
export ANTHROPIC_AUTH_TOKEN="sk-..."持久生效(写入 shell 配置文件,按你的 shell 选择 .zshrc 或 .bashrc):
echo 'export ANTHROPIC_BASE_URL="https://ai.sammier.com"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="sk-..."' >> ~/.zshrc
source ~/.zshrc临时生效(仅当前 PowerShell 会话):
$env:ANTHROPIC_BASE_URL = "https://ai.sammier.com"
$env:ANTHROPIC_AUTH_TOKEN = "sk-..."持久写入用户环境变量:
[Environment]::SetEnvironmentVariable('ANTHROPIC_BASE_URL', 'https://ai.sammier.com', 'User')
[Environment]::SetEnvironmentVariable('ANTHROPIC_AUTH_TOKEN', 'sk-...', 'User')设置后请重新打开 PowerShell,使变量生效。
验证变量已生效
echo $ANTHROPIC_BASE_URL # macOS / Linux$env:ANTHROPIC_BASE_URL # Windows PowerShell应输出你配置的 AI Router Base URL。
开始使用
在任意项目目录下启动 Claude Code:
# 进入你的项目目录
cd /path/to/your/project
# 启动
claude如需切换模型,在交互界面中输入:
/model按回车进入选择列表。可用模型取决于你的 AI Router 部署所接入的供应商及当前 API Key 所属模型分组——请以控制台中的模型列表为准。
常见问题
反馈渠道
使用中遇到问题或有改进建议,可在源码仓库提交 Issue: https://github.com/ssgzy/Router-new-api/issues。 (其他官方联系方式与定价等信息待补 / TODO)
这篇文档对您有帮助吗?
最后更新于