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

# 在 Claude Code 中配置 即刻API作为 API 后端

> 三种方式配置 Claude Code 连接 即刻API：settings.json、环境变量或 .env 文件，使用 Claude Opus/Sonnet 编写代码。

Claude Code 是 Anthropic 推出的 AI 编程助手 CLI 工具，能够读取和修改项目文件、审查代码、生成代码并协助调试。通过将 即刻API 配置为后端，您可以在 Claude Code 中使用 Claude Opus、Claude Sonnet 等模型。

## 准备工作

在开始之前，请确保：

1. **已安装 Claude Code** — 通过 npm 或 pnpm 安装 Claude Code CLI：
   ```bash theme={null}
   # npm
   npm install -g @anthropic-ai/claude-code
   # pnpm
   pnpm install -g @anthropic-ai/claude-code
   ```
   或访问 [Claude Code 官方文档](https://docs.anthropic.com/claude-code) 获取最新安装方式
2. **已获取 即刻API API 密钥** — 登录 [即刻API 控制台](https://geekapis.com/dashboard/overview) 获取您的 API 密钥（以 `sk-` 开头）

<Tip>
  如果还没有 即刻API 账户，请先在 [即刻API](https://geekapis.com) 注册并获取 API 密钥。
</Tip>

## 配置方式

Claude Code 支持多种方式配置自定义 API 端点，您可以将 即刻API 作为 Anthropic API 的替代后端。Claude Code 使用两个不同的 JSON 文件：**onboarding 状态** 与 **环境变量** 需分别写入对应文件才能生效。

### 先确认 onboarding 已完成

在用户主目录下的 `~/.claude.json` 中设置已完成引导（若文件不存在可创建）：

```json theme={null}
{
  "hasCompletedOnboarding": true
}
```

该文件仅用于 CLI 状态位；API 密钥与 base URL 请写在下面的 `settings.json` 中。

<Tabs>
  <Tab title="settings.json（推荐）">
    在 `~/.claude/settings.json`（全局）或项目根目录的 `.claude/settings.json`（项目级）中配置环境变量，无需修改 shell 配置文件：

    ```json theme={null}
    {
      "env": {
        "ANTHROPIC_AUTH_TOKEN": "sk-xxxxxxxx",
        "ANTHROPIC_BASE_URL": "https://geekapis.com"
      }
    }
    ```

    **全局配置**（推荐，对所有项目生效）：

    ```bash theme={null}
    # 创建目录（如不存在）
    mkdir -p ~/.claude
    # 然后将上述 JSON 写入 ~/.claude/settings.json
    ```

    **项目级配置**（仅对当前项目生效）：

    在项目根目录创建 `.claude/settings.json`。项目级文件中不要包含 API Key，建议只在全局配置中写 `ANTHROPIC_AUTH_TOKEN`，项目配置中只写 `ANTHROPIC_BASE_URL`：

    ```json theme={null}
    {
      "env": {
        "ANTHROPIC_BASE_URL": "https://geekapis.com"
      }
    }
    ```

    | 配置项                        | 填写内容                               |
    | -------------------------- | ---------------------------------- |
    | **ANTHROPIC\_AUTH\_TOKEN** | 您的 即刻API API 密钥（`sk-xxxxxxxxxxxx`） |
    | **ANTHROPIC\_BASE\_URL**   | `https://geekapis.com`             |
  </Tab>

  <Tab title="环境变量">
    适用于临时使用或 CI/CD 环境。

    **macOS / Linux**

    在终端中临时设置（当前会话有效）：

    ```bash theme={null}
    export ANTHROPIC_AUTH_TOKEN="sk-xxxxxxxxxxxx"
    export ANTHROPIC_BASE_URL="https://geekapis.com"
    claude
    ```

    永久配置，将以下内容添加到 `~/.bashrc` 或 `~/.zshrc`：

    ```bash theme={null}
    export ANTHROPIC_AUTH_TOKEN="sk-xxxxxxxxxxxx"
    export ANTHROPIC_BASE_URL="https://geekapis.com"
    ```

    然后执行：

    ```bash theme={null}
    source ~/.zshrc  # 或 source ~/.bashrc
    ```

    **Windows**

    在 PowerShell 中临时设置：

    ```powershell theme={null}
    $env:ANTHROPIC_AUTH_TOKEN = "sk-xxxxxxxxxxxx"
    $env:ANTHROPIC_BASE_URL = "https://geekapis.com"
    claude
    ```

    永久配置（系统级）：

    ```powershell theme={null}
    [System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk-xxxxxxxxxxxx", "User")
    [System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://geekapis.com", "User")
    ```
  </Tab>

  <Tab title=".env 文件">
    在您的项目根目录创建 `.env` 文件：

    ```env theme={null}
    ANTHROPIC_AUTH_TOKEN=sk-xxxxxxxxxxxx
    ANTHROPIC_BASE_URL=https://geekapis.com
    ```

    <Warning>
      请将 `.env` 添加到 `.gitignore`，避免泄露 API 密钥。
    </Warning>
  </Tab>
</Tabs>

<Warning>
  `hasCompletedOnboarding` 放在 `~/.claude.json`，`env` 放在 `~/.claude/settings.json` 或 `.claude/settings.json`，不要混写到同一个文件中。
</Warning>

## 验证配置

配置完成后，运行以下命令验证连接是否正常：

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

然后启动 Claude Code：

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

如果配置正确，Claude Code 将通过 即刻API 连接到 Claude 模型并正常响应。

## 推荐模型

通过 即刻API 您可以使用以下 Claude 模型：

| 模型名称              | 模型 ID                       | 特点             |
| ----------------- | --------------------------- | -------------- |
| Claude Opus 4.6   | `claude-opus-4-6`           | 最强大，适合复杂任务     |
| Claude Sonnet 4.6 | `claude-sonnet-4-6`         | 性能与速度平衡，推荐日常使用 |
| Claude Haiku 4.5  | `claude-haiku-4-5-20251001` | 快速响应，适合简单任务    |

切换模型可使用 `/model` 命令，或在启动时通过 `--model` 参数指定：

```bash theme={null}
claude --model claude-sonnet-4-6
```

## 使用技巧

### 1. 在项目中快速启动

进入项目目录后直接运行 `claude`，Claude Code 会自动读取项目上下文：

```bash theme={null}
cd /your/project
claude
```

### 2. 常用命令

| 命令                 | 说明             |
| ------------------ | -------------- |
| `/help`            | 查看帮助信息         |
| `/model`           | 切换模型           |
| `/clear`           | 清空当前对话         |
| `/exit` 或 `Ctrl+C` | 退出 Claude Code |

### 3. 与代码协作

Claude Code 能够读取和修改项目文件，常用场景：

* **代码审查** — 让 Claude Code 审查您的代码并提出改进建议
* **生成代码** — 描述需求，Claude Code 直接生成并写入文件
* **调试错误** — 粘贴错误信息，获取调试建议
* **重构代码** — 让 Claude Code 优化代码结构

## 完整配置示例

`~/.claude/settings.json` 完整示例：

```json theme={null}
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-xxxxxxxx",
    "ANTHROPIC_BASE_URL": "https://geekapis.com"
  }
}
```

## 常见问题

<AccordionGroup>
  <Accordion title="出现 Authentication error 或 401 Unauthorized？">
    **解决方案：**

    1. 检查 `ANTHROPIC_AUTH_TOKEN` 是否正确设置，确认以 `sk-` 开头
    2. 在 [即刻API 控制台](https://geekapis.com/console/token) 确认密钥未过期
    3. 确认账户余额充足
  </Accordion>

  <Accordion title="出现 Connection refused 或无法连接？">
    **解决方案：**

    1. 确认 `ANTHROPIC_BASE_URL` 设置为 [https://geekapis.com](https://geekapis.com)
    2. 检查网络连接，确保能访问 [https://geekapis.com](https://geekapis.com)
    3. 如在国内，可能需要配置代理
  </Accordion>

  <Accordion title="如何查看当前环境变量配置？">
    在终端中运行以下命令查看当前配置：

    ```bash theme={null}
    echo $ANTHROPIC_AUTH_TOKEN
    echo $ANTHROPIC_BASE_URL
    ```
  </Accordion>

  <Accordion title="错误码说明">
    | 错误信息                        | 原因          | 解决方法        |
    | --------------------------- | ----------- | ----------- |
    | `401 Unauthorized`          | API 密钥无效或过期 | 重新获取 API 密钥 |
    | `429 Too Many Requests`     | 请求频率超限      | 稍等片刻后重试     |
    | `500 Internal Server Error` | 服务器临时故障     | 等待几分钟后重试    |
    | `insufficient_quota`        | 账户余额不足      | 前往控制台充值     |
  </Accordion>
</AccordionGroup>

## 支持与帮助

如果您在使用过程中遇到任何问题：

* 📚 [Claude Code ](https://docs.anthropic.com/claude-code)官方文档