路由规则请参考 路由与协议。模型 ID 请参考
列出模型。
Claude Code 使用 Anthropic Messages 兼容协议。PipeLLM 提供两种接法:
| 场景 | Base URL | 原因 |
|---|
| 调 Claude 模型 | https://api.pipellm.ai | 使用 PipeLLM 原生 Anthropic 兼容路由 |
| 保留 Claude Code,调用 GPT 或 Gemini | https://api.pipellm.ai/anthropic | 使用 Anthropic converter 路由 |
配置文件
Claude Code 的配置文件是 ~/.claude/settings.json。
开始测试前,先清理可能冲突的 shell 环境变量,尤其是
ANTHROPIC_BASE_URL、ANTHROPIC_API_KEY、ANTHROPIC_AUTH_TOKEN。
推荐配置
Claude 模型
GPT 或 Gemini 模型
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.pipellm.ai",
"ANTHROPIC_AUTH_TOKEN": "your-pipellm-api-key",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-6",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5-latest"
}
}
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.pipellm.ai/anthropic",
"ANTHROPIC_AUTH_TOKEN": "your-pipellm-api-key",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "gpt-4o",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "gpt-4o-mini"
}
}
你也可以把这些模型 ID 换成 PipeLLM 上的其他模型,例如 gemini-2.5-pro
或 gemini-2.5-flash。
运行 Claude Code
如果你希望用项目级配置,而不是修改全局设置,也可以把同样的 env 配置放到
Claude Code 当前读取的设置文件里。
- Claude Code 需要 Anthropic Messages 兼容端点,例如
/v1/messages。
- 调 Claude 模型时,PipeLLM 原生路由最直接。
- 想保留 Claude Code 协议格式,同时切换到 OpenAI 或 Gemini 模型时,优先使用
PipeLLM 的
/anthropic converter 路由。
相关文档
开发工具
对比 Claude Code、OpenCode、OpenClaw
Anthropic 转换器
保留 Anthropic 格式,跨 provider 调用模型
Claude Code Gateway 文档
官方 Claude Code gateway 要求