# Claude Agent Kit API URL 配置指南
## 环境变量配置
Claude Agent Kit 基于 `@anthropic-ai/claude-agent-sdk`, 该 SDK 支持通过环境变量配置自定义 API URL。
### 支持的环境变量
1. **ANTHROPIC_API_KEY** - API 密钥 (必需)
2. **ANTHROPIC_BASE_URL** - 自定义 API 基础 URL (可选)
### 配置方法
#### 方法一: 直接设置环境变量
```bash
export ANTHROPIC_API_KEY=your-key-here
export ANTHROPIC_BASE_URL=https://ai-router.plugins-world.cn
方法二: 使用 .env 文件
在项目根目录创建 .env 文件:
ANTHROPIC_API_KEY=your-key-here
ANTHROPIC_BASE_URL=https://ai-router.plugins-world.cn
项目已经配置了 dotenv, 会自动加载 .env 文件 (见 server/server.ts:1)。
验证配置
检查当前环境变量:
你当前的配置:
注意事项
-
环境变量名称: Anthropic SDK 标准使用 ANTHROPIC_API_KEY, 但你当前使用的是 ANTHROPIC_AUTH_TOKEN。建议统一使用标准名称。
-
优先级: 环境变量 > .env 文件
-
URL 格式: SDK 会自动添加 /v1/messages 等路径后缀, 所以 BASE_URL 只需要提供域名部分。
推荐配置
# .env 文件
ANTHROPIC_API_KEY=your-key-here
ANTHROPIC_BASE_URL=https://ai-router.plugins-world.cn
启动服务
配置完成后, 启动开发服务器:
服务会自动读取环境变量并使用配置的 API URL。
参考资料
- Anthropic SDK 支持通过
ANTHROPIC_BASE_URL 或 ANTHROPIC_API_BASE 环境变量配置自定义端点
- SDK 会自动处理路径拼接, 无需手动添加
/v1/messages 等后缀
- 项目已通过
dotenv/config 加载环境变量 (server/server.ts:1)
方法二: 使用 .env 文件
在项目根目录创建
.env文件:项目已经配置了
dotenv, 会自动加载.env文件 (见server/server.ts:1)。验证配置
检查当前环境变量:
env | grep -i anthropic你当前的配置:
注意事项
环境变量名称: Anthropic SDK 标准使用
ANTHROPIC_API_KEY, 但你当前使用的是ANTHROPIC_AUTH_TOKEN。建议统一使用标准名称。优先级: 环境变量 > .env 文件
URL 格式: SDK 会自动添加
/v1/messages等路径后缀, 所以 BASE_URL 只需要提供域名部分。推荐配置
# .env 文件 ANTHROPIC_API_KEY=your-key-here ANTHROPIC_BASE_URL=https://ai-router.plugins-world.cn启动服务
配置完成后, 启动开发服务器:
服务会自动读取环境变量并使用配置的 API URL。
参考资料
ANTHROPIC_BASE_URL或ANTHROPIC_API_BASE环境变量配置自定义端点/v1/messages等后缀dotenv/config加载环境变量 (server/server.ts:1)