跳转到主要内容
路由规则请参考 路由与协议。模型 ID 请参考 列出模型 Claude Code 使用 Anthropic Messages 兼容协议。PipeLLM 提供两种接法:
场景Base URL原因
调 Claude 模型https://api.pipellm.ai使用 PipeLLM 原生 Anthropic 兼容路由
保留 Claude Code,调用 GPT 或 Geminihttps://api.pipellm.ai/anthropic使用 Anthropic converter 路由

配置文件

Claude Code 的配置文件是 ~/.claude/settings.json
开始测试前,先清理可能冲突的 shell 环境变量,尤其是 ANTHROPIC_BASE_URLANTHROPIC_API_KEYANTHROPIC_AUTH_TOKEN

推荐配置

{
  "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"
  }
}

运行 Claude Code

claude
如果你希望用项目级配置,而不是修改全局设置,也可以把同样的 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 要求