Routic

在 Claude Code 中使用 Routic

通过 Routic 的 Anthropic 兼容接口，在 Claude Code CLI 里以更低成本使用 Claude 系列模型。

原理

Routic 同时提供 OpenAI 兼容 和 Anthropic 兼容 两种消息格式。Claude Code 默认走 Anthropic API 的 /v1/messages 路径，Routic 支持代理并路由到后端 Claude 模型。

前置条件

  • 已安装 Claude Code CLI（npm install -g @anthropic-ai/claude-code）
  • 已获取 Routic 的 Base URL 和 API Key

方式一：让 AI 帮你配（最快）

告诉你的 AI Agent：

帮我配置 Claude Code 使用 Routic 作为 Anthropic API 后端。

把以下信息发给它：

需要设置的环境变量（写入 ~/.bashrc、~/.zshrc 或对应 shell 配置文件）：

变量值
ANTHROPIC_BASE_URLhttps://api.routic.ai
ANTHROPIC_API_KEY你的 Routic API Key（sk- 开头）

ANTHROPIC_BASE_URL 填到主机名为止，不带 /v1——Claude Code 会自动拼接。

或者写入配置文件 ~/.claude/settings.json（合并，不要覆盖其他条目）：

{
  "api": {
    "baseURL": "https://api.routic.ai",
    "apiKey": "sk-YOUR_KEY_HERE"
  }
}

Agent 配好后，把 sk-YOUR_KEY_HERE 替换成你的实际密钥，重启终端。

方式二：手动配置

通过环境变量（推荐）

在 ~/.bashrc、~/.zshrc 中添加：

export ANTHROPIC_BASE_URL="https://api.routic.ai"
export ANTHROPIC_API_KEY="sk-YOUR_KEY_HERE"

执行 source ~/.zshrc 或重启终端，然后正常使用 claude 命令。

每次命令传入

ANTHROPIC_BASE_URL="https://api.routic.ai" \
ANTHROPIC_API_KEY="sk-YOUR_KEY_HERE" \
claude "帮我审查这个函数"

写入配置文件

编辑 ~/.claude/settings.json（合并，不要覆盖其他条目）：

{
  "api": {
    "baseURL": "https://api.routic.ai",
    "apiKey": "sk-YOUR_KEY_HERE"
  }
}

配置格式可能随版本变化，以 Claude Code 官方文档 为准。

验证

claude "你好，请回复 pong"

看到正常响应即成功。401 或 authentication_error 说明 API Key 不对。

指定模型

claude --model claude-3-5-sonnet-20241022 "你的提问"

模型名需与 Routic 模型目录 中的在售名称一致。

常见问题

invalid_api_key
API Key 格式不对或已过期，前往控制台重新生成。

设了 ANTHROPIC_BASE_URL 还是走官方接口
echo $ANTHROPIC_BASE_URL 确认变量已生效，可能需要重启终端。

响应内容异常
可能指定了不存在的模型名，检查模型目录。

相关文档