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

# Claude Code

> Anthropic 官方 Claude Code CLI 直连 FortAPI

[Claude Code](https://docs.claude.com/en/docs/claude-code/overview) 是 Anthropic 官方的命令行编码助手。它默认连 `api.anthropic.com`，通过 **`ANTHROPIC_BASE_URL`** 环境变量可以直接改成 FortAPI 的端点，无需任何代理层。

<Note>
  本页讲 **直接配 FortAPI**。如果你想用图形界面管理多个 provider，看 [CC Switch](/zh/integrations/ccswitch)。
</Note>

## 前置条件

<Steps>
  <Step title="FortAPI API key">
    控制台 → **令牌** → **创建令牌** 拿到一把 `sk-...`。详见 [API key 与安全](/zh/authentication)。
  </Step>

  <Step title="Node.js ≥ 18">
    Claude Code 需要 Node.js 18 以上。检查：

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

    没装的话，去 [nodejs.org](https://nodejs.org) 下载 LTS 版本，或者 macOS 用 Homebrew：

    ```bash theme={null}
    brew install node
    ```
  </Step>
</Steps>

## 安装 Claude Code

<Tabs>
  <Tab title="macOS / Linux">
    ```bash theme={null}
    npm install -g @anthropic-ai/claude-code
    ```

    装完确认版本：

    ```bash theme={null}
    claude --version
    ```
  </Tab>

  <Tab title="Windows">
    在 **PowerShell** 里：

    ```powershell theme={null}
    npm install -g @anthropic-ai/claude-code
    claude --version
    ```

    <Warning>
      Claude Code 在原生 Windows 上有部分 shell 功能依赖类 Unix 环境。推荐用 **WSL2**（Windows Subsystem for Linux），按 macOS / Linux 的方式装。
    </Warning>
  </Tab>
</Tabs>

## 配置 FortAPI 端点

Claude Code 支持三种配置方式，按推荐度排列：

### 方法一：写入 `settings.json`（推荐）

编辑 `~/.claude/settings.json`（macOS / Linux）或 `%USERPROFILE%\.claude\settings.json`（Windows）。文件不存在就新建：

```json theme={null}
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://www.fortapi.com",
    "ANTHROPIC_API_KEY": "sk-你的KEY",
    "ANTHROPIC_MODEL": "你的模型名",
    "ANTHROPIC_SMALL_FAST_MODEL": "你的小模型名"
  }
}
```

把 `你的模型名` / `你的小模型名` 换成主站价格页面上的模型名。

<Warning>
  `ANTHROPIC_BASE_URL` 末尾 **不要** 加 `/v1`。Anthropic SDK 会自动拼接 `/v1/messages`，多写 `/v1` 会导致 404。
</Warning>

<AccordionGroup>
  <Accordion title="各字段含义">
    | 字段                           | 含义                                                   |
    | ---------------------------- | ---------------------------------------------------- |
    | `ANTHROPIC_BASE_URL`         | FortAPI 端点                                           |
    | `ANTHROPIC_API_KEY`          | 你的 FortAPI 令牌（注意：**不是** Anthropic 官方 key）            |
    | `ANTHROPIC_MODEL`            | 默认用哪个 Claude 模型；可用模型名见主站价格页面                         |
    | `ANTHROPIC_SMALL_FAST_MODEL` | Claude Code 内部一些轻量任务（标题生成、文件路径解析）走的小模型，建议设成更便宜的小模型省钱 |
  </Accordion>
</AccordionGroup>

### 方法二：环境变量

如果你只是临时试试，直接 export：

<Tabs>
  <Tab title="macOS / Linux (zsh / bash)">
    ```bash theme={null}
    export ANTHROPIC_BASE_URL="https://www.fortapi.com"
    export ANTHROPIC_API_KEY="sk-你的KEY"
    claude
    ```

    想永久生效，加进 `~/.zshrc` 或 `~/.bashrc`。
  </Tab>

  <Tab title="Windows (PowerShell)">
    ```powershell theme={null}
    $env:ANTHROPIC_BASE_URL = "https://www.fortapi.com"
    $env:ANTHROPIC_API_KEY  = "sk-你的KEY"
    claude
    ```

    永久生效用：

    ```powershell theme={null}
    [Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://www.fortapi.com", "User")
    [Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "sk-你的KEY", "User")
    ```
  </Tab>
</Tabs>

### 方法三：用 CC Switch

如果你需要在 FortAPI 和官方账号之间反复切换，装 [CC Switch](/zh/integrations/ccswitch) 用 GUI 管理。

## 第一次验证

新开一个终端窗口（让环境变量生效），随便进一个目录：

```bash theme={null}
cd ~/some-project
claude
```

进入交互界面后，问一句最简单的问题：

```
> 用一句中文回复：你好
```

正常应该立刻得到 Claude 的回复，并且 FortAPI 控制台 → **日志** 里能看到对应记录、扣了几个 token 的费用。

<Tip>
  如果你想确认调用真的走了 FortAPI，去 FortAPI 控制台 → **日志** 看时间戳最新的那条请求，模型名应该和你配置的一致。
</Tip>

## 切换模型

会话内随时切：

```
/model 你的模型名
```

可用模型列表见主站 [价格](https://www.fortapi.com) 页。

## 常见问题

<AccordionGroup>
  <Accordion title="401 Unauthorized / Invalid API key">
    * `ANTHROPIC_API_KEY` 应该是你的 **FortAPI** 令牌（`sk-...`），不是 Anthropic 官方的 `sk-ant-...`。
    * 复制时小心末尾的空格或换行。
    * 在 FortAPI 控制台 → **令牌** 确认这把 key 没被禁用，也没把当前模型从「可访问模型」白名单里漏掉。
  </Accordion>

  <Accordion title="404 / model not found">
    * 模型 ID 拼错。Claude 模型在 FortAPI 上的命名和 Anthropic 官方一致，常用：`claude-sonnet`、`claude-opus`、`claude-haiku`。
    * 不要给 `ANTHROPIC_BASE_URL` 加 `/v1`。
  </Accordion>

  <Accordion title="403 / 余额不足">
    控制台首页查看 USD 余额。Claude Code 默认对话有 token 消耗，长上下文 + 工具调用比较烧 token。
  </Accordion>

  <Accordion title="连不上 / 网络超时">
    * 检查能否 ping 通：`curl -I https://www.fortapi.com`
    * 如果你在公司内网或者使用代理，确认 `HTTPS_PROXY` 环境变量没把请求引到不通的地方。
    * 不需要 VPN，直接走国内网络即可。
  </Accordion>

  <Accordion title="想保留官方账号 + FortAPI 共存">
    用 [CC Switch](/zh/integrations/ccswitch) 一键切，或者用 [direnv](https://direnv.net/) 给不同项目目录绑定不同的环境变量。
  </Accordion>
</AccordionGroup>

## 进阶

* **MCP 服务器**：Claude Code 的 MCP 配置和后端 API 无关，照常用即可。
* **工具调用 / Function calling**：FortAPI 默认全部转发给上游 Anthropic，行为完全一致。
* **流式 / SSE**：默认开启，无需额外配置。

更多 Claude Code 玩法看 [官方文档](https://docs.claude.com/en/docs/claude-code/overview)。