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

# 选择接入方式

> 根据你的使用场景选择 OpenAI SDK、Claude Code、Codex CLI、CC-Switch 或原生兼容接口。

XRouter 同时提供 OpenAI、Anthropic Messages 和 Gemini 兼容入口。最稳妥的选择方式是先确认你使用的客户端或工具期望哪种 API 格式，再配置对应的服务地址和认证头。

## 快速判断

| 你要做什么                      | 推荐页面                                                   | Base URL                     |
| -------------------------- | ------------------------------------------------------ | ---------------------------- |
| 在应用代码里调用聊天模型               | [OpenAI SDK](/integrations/openai-sdk)                 | `https://api.xrouter.dev/v1` |
| 在 Claude Code 中写代码         | [Claude Code](/integrations/claude-code)               | `https://api.xrouter.dev`    |
| 在 Codex CLI 中写代码           | [Codex CLI](/integrations/codex-cli)                   | `https://api.xrouter.dev/v1` |
| 用图形界面切换 Provider           | [CC-Switch](/integrations/cc-switch)                   | 按工具自动或手动填写                   |
| 直接调用 Anthropic Messages 格式 | API 参考中的 `POST /v1/messages`                           | `https://api.xrouter.dev`    |
| 直接调用 Gemini 兼容格式           | API 参考中的 `POST /v1beta/models/{model}:generateContent` | `https://api.xrouter.dev`    |

<Info>
  表中的地址使用公共站默认值。如果控制台显示了不同 `server_address`，请以控制台为准。
</Info>

## OpenAI 兼容入口

如果你的代码已经使用 OpenAI SDK 或 OpenAI 兼容客户端，优先选择这个入口。

```text theme={null}
https://api.xrouter.dev/v1
```

适合：

* OpenAI SDK for Python、TypeScript、Go 等。
* 支持自定义 `base_url` 或 `baseURL` 的第三方工具。
* Chat Completions、Responses、Embeddings 等 OpenAI 兼容请求。

认证方式：

```text theme={null}
Authorization: Bearer sk-your-api-key
```

## Anthropic Messages 入口

如果客户端以 Anthropic Messages 格式发送请求，例如 Claude Code，使用这个入口。

```text theme={null}
https://api.xrouter.dev
```

Claude Code 会自行拼接 `/v1/messages`。如果你手写 HTTP 请求，完整端点是：

```text theme={null}
https://api.xrouter.dev/v1/messages
```

认证方式可以使用：

```text theme={null}
x-api-key: sk-your-api-key
```

也可以使用 Bearer token：

```text theme={null}
Authorization: Bearer sk-your-api-key
```

## Gemini 兼容入口

如果客户端期望 Google Gemini API 格式，使用 `/v1beta/models/...` 路径。

```text theme={null}
https://api.xrouter.dev/v1beta/models/{model}:generateContent
```

推荐使用请求头传递密钥：

```text theme={null}
x-goog-api-key: sk-your-api-key
```

部分 Gemini 客户端只支持 `key` 查询参数，XRouter 也兼容这种形式：

```text theme={null}
https://api.xrouter.dev/v1beta/models/{model}:generateContent?key=sk-your-api-key
```

<Warning>
  查询参数更容易出现在日志、浏览器历史或代理记录中。只在客户端无法设置请求头时使用 `key` 查询参数。
</Warning>

## 工具接入入口

<Columns cols={2}>
  <Card title="Claude Code" icon="bot" href="/integrations/claude-code">
    使用 Anthropic Messages 兼容格式，适合 Claude Code 用户。
  </Card>

  <Card title="Codex CLI" icon="terminal" href="/integrations/codex-cli">
    使用 OpenAI Responses API，适合终端智能体式编码。
  </Card>

  <Card title="CC-Switch" icon="repeat-2" href="/integrations/cc-switch">
    用桌面图形界面管理 Claude、Codex 和 Gemini Provider。
  </Card>

  <Card title="OpenAI SDK" icon="code" href="/integrations/openai-sdk">
    应用代码里最通用的接入方式。
  </Card>
</Columns>