# 在 Claude Code 中使用 OAIRoute
> Claude Code 支持自定义 API 端点
> 通过环境变量指向 OAIRoute，即可用同一个 Key 跑通
> 适合统一账单与额度管理
## 第一步：获取 API Key
在 [OAIRoute 控制台](https://api.oairoute.com/keys) 创建。
## 第二步：设置环境变量
Claude Code 读取两个环境变量：
- `ANTHROPIC_BASE_URL` (string / 必填) — 填 `https://api.oairoute.com`。注意这里**不带** `/v1`，Claude Code 会自己拼 `/v1/messages`。
- `ANTHROPIC_AUTH_TOKEN` (string / 必填) — 填你的 OAIRoute API Key。
**macOS / Linux（写入 shell 配置）：**
```bash
echo 'export ANTHROPIC_BASE_URL="https://api.oairoute.com"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="sk-xxxxxxxx"' >> ~/.zshrc
source ~/.zshrc
```
**Windows PowerShell（写入用户环境变量）：**
```powershell
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.oairoute.com", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk-xxxxxxxx", "User")
```
改完后要重开终端，环境变量才会生效。
## 第三步：验证
```bash
claude --version
claude "你好，用一句话介绍你自己"
```
能正常回复就说明接通了。
## 模型选择
Claude Code 默认使用 Claude 系列模型。想指定具体模型，用 `--model`：
```bash
claude --model claude-sonnet-5-5 "帮我看看这段代码"
```
> **Note:** 
> 如果同时装了官方版和 OAIRoute 版，建议开两个终端窗口分别设置环境变量，或者用 `.env` 文件按项目隔离，避免串号。
## 常见问题
**提示 authentication_error**
`ANTHROPIC_AUTH_TOKEN` 没设上，或者设在了当前 shell 之外。用 `echo $ANTHROPIC_AUTH_TOKEN` 确认（Windows 用 `echo $env:ANTHROPIC_AUTH_TOKEN`）。
**提示 404**
`ANTHROPIC_BASE_URL` 多写了 `/v1`。正确值是 `https://api.oairoute.com`。
**可以正常对话但工具调用失败**
部分模型对 `tool_use` 的支持程度不同。换用 `claude-sonnet-5-5` 通常能解决。
**macOS / Linux**
```
export ANTHROPIC_BASE_URL="https://api.oairoute.com"
export ANTHROPIC_AUTH_TOKEN="sk-xxxxxxxx"
claude "你好"
```
**Windows PowerShell**
```
[Environment]::SetEnvironmentVariable(
  "ANTHROPIC_BASE_URL",
  "https://api.oairoute.com",
  "User"
)
[Environment]::SetEnvironmentVariable(
  "ANTHROPIC_AUTH_TOKEN",
  "sk-xxxxxxxx",
  "User"
)
```
**指定模型{Specify model}**
```
claude --model claude-sonnet-5-5 "帮我看看这段代码"
```
**验证连通性{Verify connectivity}**
```
curl https://api.oairoute.com/v1/messages \
  -H "Authorization: Bearer YOUR_OAIRoute_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5-5",
    "max_tokens": 64,
    "messages": [{"role":"user","content":"你好"}]
  }'
```