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

# 在 Claude Code 中配置 Sub2API

> 将 Sub2API 设置为 Claude Code 的 API 后端，通过环境变量或 CC-Switch 工具快速完成配置。

Claude Code 是 Anthropic 推出的终端 AI 编程助手。你可以将 Sub2API 配置为 Claude Code 的 API 后端，从而通过 Sub2API 访问 Claude 模型以及其他支持的模型。本文介绍两种配置方式：环境变量法和 CC-Switch 工具法。

## 前置条件

* 已安装 Claude Code
* 已获取 Sub2API API Key（详见 [创建 API Key](/getting-started/create-api-key)）

## 配置方式

<Tabs>
  <Tab title="环境变量配置">
    通过设置环境变量将 Sub2API 指定为 Claude Code 的 API 后端：

    ```bash theme={null}
    export ANTHROPIC_API_KEY="your_sub2api_key"
    export ANTHROPIC_BASE_URL="https://sub2api.ruilinlu.com"
    ```

    设置完成后，直接运行 `claude` 命令即可使用 Sub2API：

    ```bash theme={null}
    # 检查版本
    claude --version

    # 进入交互模式
    claude
    ```

    <Warning>
      Claude Code 调用的是 Claude 模型。在 Sub2API 中，Claude 模型的名称可能与官方名称不同。
    </Warning>

    <Tip>
      建议先查看 [Claude 模型列表](/models/claude) 了解 Sub2API 中可用的 Claude 模型名称及对应关系。
    </Tip>
  </Tab>

  <Tab title="CC-Switch 工具配置">
    如果你使用 CC-Switch 工具管理 Claude Code 配置，可以参考 [CC-Switch 配置指南](/configuration/cc-switch) 快速完成设置。

    CC-Switch 可以帮你：

    * 一键切换不同的 API 后端
    * 管理多个 API Key
    * 快速测试连接状态
  </Tab>
</Tabs>

## 验证连接

配置完成后，执行以下命令验证是否正常工作：

```bash theme={null}
# 检查 Claude Code 版本
claude --version

# 发送简单提示词测试
claude "你好，请介绍一下自己"
```

## 故障排查

<Accordion title="提示 401 认证失败">
  * 确认 ANTHROPIC\_API\_KEY 已正确设置为 Sub2API API Key
  * 参考 [401 错误排查](/troubleshooting/401)
</Accordion>

<Accordion title="模型不可用错误">
  * 确认请求的 Claude 模型名称在 Sub2API 中可用
  * 查看 [Claude 模型列表](/models/claude) 获取正确的模型名称
</Accordion>

<Accordion title="提示无法连接 API">
  * 确认 ANTHROPIC\_BASE\_URL 已设置为 `https://sub2api.ruilinlu.com`
  * 参考 [Base URL 配置](/configuration/base-url)
</Accordion>