> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pipellm.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Claude Code

> 通过 Anthropic 兼容路由将 Claude Code 接到 PipeLLM

路由规则请参考 [路由与协议](/guides/routing-protocols.zh)。模型 ID 请参考
[列出模型](/api-reference/list-models.zh)。

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`。

<Warning>
  开始测试前，先清理可能冲突的 shell 环境变量，尤其是
  `ANTHROPIC_BASE_URL`、`ANTHROPIC_API_KEY`、`ANTHROPIC_AUTH_TOKEN`。
</Warning>

## 推荐配置

<Tabs>
  <Tab title="Claude 模型">
    ```json theme={null}
    {
      "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"
      }
    }
    ```
  </Tab>

  <Tab title="GPT 或 Gemini 模型">
    ```json theme={null}
    {
      "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`。
  </Tab>
</Tabs>

## 运行 Claude Code

```bash theme={null}
claude
```

如果你希望用项目级配置，而不是修改全局设置，也可以把同样的 `env` 配置放到
Claude Code 当前读取的设置文件里。

## 说明

* Claude Code 需要 Anthropic Messages 兼容端点，例如 `/v1/messages`。
* 调 Claude 模型时，PipeLLM 原生路由最直接。
* 想保留 Claude Code 协议格式，同时切换到 OpenAI 或 Gemini 模型时，优先使用
  PipeLLM 的 `/anthropic` converter 路由。

## 相关文档

<Columns cols={3}>
  <Card title="开发工具" icon="terminal" href="/integrations/overview.zh">
    对比 Claude Code、OpenCode、OpenClaw
  </Card>

  <Card title="Anthropic 转换器" icon="shuffle" href="/converter/anthropic-format.zh">
    保留 Anthropic 格式，跨 provider 调用模型
  </Card>

  <Card title="Claude Code Gateway 文档" icon="book" href="https://code.claude.com/docs/en/llm-gateway">
    官方 Claude Code gateway 要求
  </Card>
</Columns>