> ## 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.

# CC Switch（多工具一键切换）

> 用 CC Switch 一键把 Claude Code / Codex / OpenClaw 等命令行工具切换到 FortAPI

[CC Switch](https://github.com/farion1231/cc-switch) 是一个跨平台桌面 App，专门用来给 **Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw** 这些 AI 命令行工具做配置切换。一个图形界面，多端口一键切到 FortAPI，不用手改 `~/.claude/settings.json`、`~/.codex/config.toml`、`~/.openclaw/openclaw.json`。

<Note>
  如果你只用一个 CLI 工具（比如只有 Claude Code），可以直接看 [Claude Code 直连](/zh/integrations/claude-code) 这一页，不一定要装 CC Switch。CC Switch 的价值在于 **多工具 + 多服务商** 之间快速切换。
</Note>

## 前置条件

<Steps>
  <Step title="创建一把 API key">
    控制台 → **令牌** → **创建令牌**。复制以 `sk-...` 开头的字符串。详见 [API key 与安全](/zh/authentication)。
  </Step>

  <Step title="先装好至少一个 CLI 工具">
    CC Switch 本身不安装 Claude Code / Codex 等工具，只负责切换它们的配置。请先按 [Claude Code](/zh/integrations/claude-code) 或 [Codex](/zh/integrations/codex) 装好对应 CLI。
  </Step>
</Steps>

## 安装 CC Switch

到 [Releases 页](https://github.com/farion1231/cc-switch/releases/latest) 按平台下载：

<Tabs>
  <Tab title="macOS">
    下载 `cc-switch-x.y.z-arm64.dmg`（Apple Silicon）或 `cc-switch-x.y.z-x64.dmg`（Intel）→ 双击挂载 → 把 `CC Switch.app` 拖进 **应用程序** 文件夹。

    <Note>
      首次打开提示 "无法验证开发者" 时，去 **系统设置 → 隐私与安全性** 拉到底 → 点 **仍要打开**。
    </Note>
  </Tab>

  <Tab title="Windows">
    下载 `cc-switch-x.y.z-x64-setup.exe` → 双击安装 → 桌面会出现 CC Switch 图标。
  </Tab>

  <Tab title="Linux">
    下载 `cc-switch_x.y.z_amd64.deb`（Debian/Ubuntu）或 `cc-switch-x.y.z.AppImage`（其他发行版）。

    ```bash theme={null}
    # Debian / Ubuntu
    sudo dpkg -i cc-switch_*_amd64.deb

    # 其他发行版 (AppImage)
    chmod +x cc-switch-*.AppImage
    ./cc-switch-*.AppImage
    ```
  </Tab>
</Tabs>

## 把 FortAPI 加进 CC Switch（Claude Code）

打开 CC Switch，左侧选择 **Claude Code** 这一栏，开始添加 FortAPI：

<Steps>
  <Step title="点『添加供应商』">
    主界面右上角的 **+ 添加供应商**（Add Provider）按钮。
  </Step>

  <Step title="选『自定义』">
    在弹出的预设列表里下拉到底，选 **自定义供应商**（Custom Provider）。如果列表里有 "FortAPI" 预设可直接选，配置字段会自动填好，只用填 API key。
  </Step>

  <Step title="填基础信息">
    | 字段              | 填什么                       |
    | --------------- | ------------------------- |
    | **名称（Name）**    | `FortAPI`                 |
    | **网站（Website）** | `https://www.fortapi.com` |
    | **图标（Icon）**    | 可选，不填走默认                  |
  </Step>

  <Step title="填环境变量">
    切到 **环境变量（Environment Variables）** 或 **Endpoint 配置** Tab：

    | 变量                               | 值                         |
    | -------------------------------- | ------------------------- |
    | `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>
  </Step>

  <Step title="保存并启用">
    点 **保存** → 回到主界面，点 FortAPI 这一栏右侧的 **启用（Enable）** 按钮。状态变成绿色 = 当前 Claude Code 已经切到 FortAPI。
  </Step>
</Steps>

## 把 FortAPI 加进 CC Switch（Codex）

左侧切到 **Codex** 栏，重复上面的添加流程，但环境变量改成：

| 变量                 | 值                            |
| ------------------ | ---------------------------- |
| `OPENAI_BASE_URL`  | `https://www.fortapi.com/v1` |
| `OPENAI_API_KEY`   | `sk-你的KEY`（同一把 key 即可）       |
| `OPENAI_MODEL`（可选） | `你的模型名`（见主站价格页面）             |

<Note>
  Codex 走 OpenAI 兼容协议，`OPENAI_BASE_URL` 末尾**要**带 `/v1`。
</Note>

## 验证切换是否生效

CC Switch 切换完之后，需要根据工具不同做不同处理：

<CardGroup cols={2}>
  <Card title="Claude Code" icon="terminal">
    **不用重启**，CC Switch 会热切换。直接在已开着的 `claude` 会话里继续提问即可。
  </Card>

  <Card title="Codex / OpenClaw / Gemini CLI" icon="rotate">
    需要 **关掉再重开终端**（或重启对应 CLI），让新的环境变量生效。
  </Card>
</CardGroup>

简单跑一句验证：

```bash theme={null}
# Claude Code
claude "用一句话说一下你在哪个 API 上"

# Codex
codex "用一句话说一下你在哪个 API 上"
```

回复正常 + 没有报 401 / 网络错误 = 切换成功。

## 切回官方 / 其他服务商

在 CC Switch 主界面，选中其他 provider → 点 **启用**。CC Switch 会自动把 `~/.claude/settings.json` 等配置文件改回去。

<Tip>
  你可以同时保留多个 provider（FortAPI、官方、其他中转），随时一键切换。这是 CC Switch 最大的便利点。
</Tip>

## 常见问题

<AccordionGroup>
  <Accordion title="切换后 Claude Code 仍然走官方 / 老的 endpoint">
    1. 关掉当前 `claude` 会话，新开一个终端窗口重试。
    2. 检查终端环境里是否手工 `export` 过 `ANTHROPIC_BASE_URL` —— 手工设置的环境变量优先级最高，会覆盖 CC Switch 改的 settings 文件。
    3. 运行 `cat ~/.claude/settings.json`，确认 `env` 部分有 FortAPI 的配置。
  </Accordion>

  <Accordion title="提示 401 Unauthorized">
    * 检查 `ANTHROPIC_API_KEY` 是否复制完整（包括前缀 `sk-` 和所有结尾字符）。
    * 在 FortAPI 控制台 → **令牌** 里确认这把 key 没被禁用，也没设置「可访问模型」白名单把当前模型排除。
    * 检查余额是否充足（控制台首页查看 USD 余额）。
  </Accordion>

  <Accordion title="提示 404 / model not found">
    * 模型名拼写错误。Claude Code 默认模型 ID 在 FortAPI 主站「价格」页可查，常用：`claude-sonnet`、`claude-opus`、`claude-haiku`。
    * 不要在 `ANTHROPIC_BASE_URL` 末尾加 `/v1`。
  </Accordion>

  <Accordion title="CC Switch 找不到 Claude Code 配置文件">
    确认 Claude Code 至少跑过一次 `claude` 命令（创建 `~/.claude/settings.json`）。完全没装 Claude Code 的话，CC Switch 也没东西可切。
  </Accordion>
</AccordionGroup>

## 下一步

* **想直接给 Claude Code 配 FortAPI（不用 CC Switch）？** 看 [Claude Code 直连](/zh/integrations/claude-code)
* **想给 Codex 配 FortAPI？** 看 [Codex 直连](/zh/integrations/codex)
* **想给 OpenClaw 配 FortAPI？** 看 [OpenClaw 直连](/zh/integrations/openclaw)