AI RouterAI Router
使用指南API 参考AI 应用帮助支持商务合作合规与使用政策
⚠️合规提示:本项目仅用于合法授权的 API 网关、内部管理和私有化部署场景。请遵守上游服务条款、平台规则、监管要求和内容安全要求。

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 默认调用 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 ~/.zshrc

Claude Code 依赖 Node.js 环境,且在 Windows 上建议通过 Git Bash 安装。

  1. 安装 Node.js LTS 版本(保持默认设置即可)。

  2. 安装 Git for Windows(提供 Git Bash)。

  3. 打开 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)

这篇文档对您有帮助吗?

最后更新于