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

# 通过 Flatkey 以优惠价格使用 Claude Code

> 修改两个环境变量，将 Claude Code CLI 流量路由到 Flatkey，低至 Anthropic 官方价格的 5 折使用 Claude 模型。

Anthropic Claude Code 是一款在终端中运行的智能体式 AI 编程助手。设置 `ANTHROPIC_BASE_URL` 环境变量，即可将 Claude Code 的全部请求路由到 Flatkey，并按 Flatkey 的优惠价格使用 Claude 模型。

## 前置条件

* 已安装 Claude Code：`npm install -g @anthropic-ai/claude-code`
* 拥有 Flatkey 账号和 API 密钥——[在此获取](https://console.flatkey.ai/sign-up?lng=zh)

## 配置

设置以下两个环境变量：

```bash theme={null}
export ANTHROPIC_BASE_URL="https://router.flatkey.ai"
export ANTHROPIC_API_KEY="sk-fk-your-flatkey-key"
```

若要让设置永久生效，请将它们添加到 shell 配置文件：

```bash ~/.zshrc theme={null}
export ANTHROPIC_BASE_URL="https://router.flatkey.ai"
export ANTHROPIC_API_KEY="sk-fk-your-flatkey-key"
```

<Warning>
  将 `ANTHROPIC_BASE_URL` 设为 `https://router.flatkey.ai`，末尾不要添加 `/v1`。Claude Code CLI 会自动追加正确的路径。
</Warning>

## 使用 CC Switch 配置

[CC Switch](https://ccswitch.io) 是面向编程助手的第三方桌面配置管理器，也可以从其[官方 GitHub 仓库](https://github.com/farion1231/cc-switch)下载。

1. 打开 CC Switch 并选择 **Claude Code**。
2. 添加名为 `Flatkey` 的**自定义供应商**。
3. 将基础 URL 设为 `https://router.flatkey.ai`，末尾不要添加 `/v1`。
4. 输入 Flatkey API 密钥（`sk-fk-...`）并启用该供应商。
5. 完全退出并重新打开 Claude Code，使其重新加载供应商设置。
6. 发送一条简单请求，然后在 [Flatkey 控制台](https://console.flatkey.ai/usage-logs/common?lng=zh)的**用量日志**中确认记录。

<Note>
  如果你的 CC Switch 版本没有 Flatkey 预设，请使用**自定义供应商**。CC Switch 不是 Flatkey 产品。
</Note>

## 运行 Claude Code

照常使用 Claude Code：

```bash theme={null}
claude "Fix the bug in this file"
```

或进入交互模式：

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

所有请求都会路由到 Flatkey，并按优惠价格从预付余额中扣费。

## 验证配置

运行一条简单请求，然后查看 [Flatkey 控制台](https://console.flatkey.ai/usage-logs/common?lng=zh)中的**用量日志**。你应当能看到包含模型 ID、token 数量和费用的 Claude 请求记录。

## 节省费用估算

通过 Flatkey 使用 Claude Sonnet（Claude Code 的热门选择）：

|                                | 官方价格               | Flatkey（\$200 奖励后）      |
| ------------------------------ | ------------------ | ----------------------- |
| `claude-sonnet-4-5` 输入         | \$3 / 100 万 tokens | 约 \$1.6 / 100 万 tokens  |
| `claude-haiku-4-5-20251001` 输入 | \$1 / 100 万 tokens | 约 \$0.53 / 100 万 tokens |

以使用 Sonnet、输入 5 万 tokens 的典型 Claude Code 会话为例：

* 官方：每次会话约 \$0.15
* Flatkey：每次会话约 \$0.08

<Tip>
  重度 Claude Code 用户选择 \$200 充值档位最为划算。奖励额度相当于在模型折扣之外额外获得约一个月用量。
</Tip>

## 故障排查

| 问题                      | 解决方法                                                         |
| ----------------------- | ------------------------------------------------------------ |
| `Authentication failed` | 确认 `ANTHROPIC_API_KEY` 是你的 Flatkey 密钥（`sk-fk-...`）           |
| `Could not connect`     | 确认 `ANTHROPIC_BASE_URL` 已设为 `https://router.flatkey.ai`      |
| `Insufficient balance`  | 前往 [console.flatkey.ai](https://console.flatkey.ai?lng=zh)充值 |
| 控制台中没有请求                | 检查当前 shell 是否已导出环境变量                                         |