# Claude Code API Key 配置

Claude Code 读取两个环境变量来将请求路由到任意位置：ANTHROPIC_BASE_URL 和 ANTHROPIC_API_KEY。将它们指向 RunAPI，以官方价格一半运行所有 Claude 模型。本指南提供 Mac、Linux 和 Windows 的精确命令。

*Updated June 18, 2026 · RunAPI 编辑团队*

## 如何在 Claude Code 中设置自定义 API key？

Claude Code 使用两个环境变量来决定请求的目的地和认证方式。将 ANTHROPIC_BASE_URL 和 ANTHROPIC_API_KEY 设置为 RunAPI 的值，所有请求就会以官方价格 50% 通过 RunAPI 路由。想要使用完全不同的服务商？RunAPI 也可作为直接替换的网关，让你无需直接 Anthropic 账号即可运行 Claude 模型。

- **两个变量**: ANTHROPIC_BASE_URL 设置端点，ANTHROPIC_API_KEY 设置密钥。这就是全部配置——两个变量，无需其他更改。
- **端点值**: 将 ANTHROPIC_BASE_URL 设置为 https://runapi.ai，使 Claude Code 通过 RunAPI 路由。
- **持久化**: 将两个 export 语句添加到 shell profile（.zshrc 或 .bashrc），避免每次会话重新设置。Windows 用户在 PowerShell 中设置后打开新窗口。
- **50% 折扣**: 所有 Claude 模型以 Anthropic 官方价格一半计费。无订阅，无上限。

## 配置 Claude Code 前需要准备什么？

配置只需几分钟。你需要已安装的 Claude Code、一个 RunAPI 账号和一个终端。在修改任何 API key 配置前，先运行 claude --version 确认 Claude Code 正常运行。

### 已安装 Claude Code

从官方来源安装 Claude Code，并在终端运行 claude --version 确认其正常运行。如果该命令报错，请先修复安装问题，再设置任何 API key。

### RunAPI 账号

在 runapi.ai 注册。免费套餐包含额度，可在充值余额前测试任意 Claude 模型。

### API key

从控制台 → API Keys 创建密钥。只复制一次——密钥仅在创建时完整显示。不要将其粘贴到公开仓库或在截图中分享。

### 终端访问权限

你需要一个 shell 来设置环境变量。macOS 和 Linux 使用 .zshrc 或 .bashrc。Windows 用户可以使用 PowerShell——设置变量后，打开新终端窗口使其生效。


## 如何通过 RunAPI 配置 Claude Code API key

按顺序运行这些命令。它们设置端点和密钥，将其持久化到 shell profile，并确认 Claude Code 已正确读取。将占位符替换为你的真实 RunAPI 密钥。使用 ANTHROPIC_API_KEY（而非 CLAUDE_API_KEY）——这才是 Claude Code 实际读取的变量。

## Claude Code 读取哪些环境变量？

Claude Code 读取少量变量来控制端点、认证、模型和输出长度。下表列出了自定义端点配置中重要的变量及其作用。注意：使用 ANTHROPIC_API_KEY（而非 CLAUDE_API_KEY）——这才是 Claude Code 实际读取的变量。

| 变量 | 用途 | 示例值 |
|---|---|---|
| ANTHROPIC_BASE_URL | Claude Code 发送请求的自定义端点 | https://runapi.ai |
| ANTHROPIC_API_KEY | 用于认证请求的密钥 | sk-your-runapi-key |
| ANTHROPIC_MODEL | 新会话的默认模型 | claude-sonnet-4-6 |
| CLAUDE_CODE_MAX_OUTPUT_TOKENS | 每次响应返回 token 数量的上限 | '8192' |

## 在 Claude Code 中应该运行哪个 Claude 模型？

Claude Code 通过 RunAPI 支持任意 Claude 模型 ID。按任务选择：日常编辑用快速低价模型，日常编码用均衡模型，难题用最强模型。设置 ANTHROPIC_MODEL 更改默认值，或在 Claude Code 内切换模型——计费跟随你实际调用的模型。

### claude-haiku-4-5

通过 RunAPI 最快最便宜，输入 $1/M，输出 $5/M。最适合日常编辑和快速查询。

### claude-sonnet-4-6

日常编码的均衡默认选择，通过 RunAPI 输入 $3/M，输出 $15/M。大多数开发者使用此模型。

### claude-opus-4-7

处理难题的最强选择，通过 RunAPI 输入 $5/M，输出 $25/M。用于复杂重构和代码审查。

### 随时切换

随时设置 ANTHROPIC_MODEL 或在 Claude Code 内切换模型。计费跟随你实际调用的模型，全部享受 50% 折扣。


## 为什么我的 Claude Code API key 不起作用？

大多数配置问题源于以下三点之一：错误的环境变量名（使用 ANTHROPIC_API_KEY，而非 CLAUDE_API_KEY）、未获取 profile 更改的过时 shell 会话，或密钥中的拼写错误。下表列出了常见错误及解决方法。

| 错误或症状 | 可能原因 | 解决方法 |
|---|---|---|
| 401 Unauthorized | 错误或过期的 API key | 重新检查 ANTHROPIC_API_KEY，如有需要在 RunAPI 控制台创建新密钥 |
| 请求仍发送到 Anthropic | 此 shell 中未设置 ANTHROPIC_BASE_URL | 运行 echo $ANTHROPIC_BASE_URL；如果为空，重新加载 profile 或打开新终端 |
| 404 Not Found | base URL 中有尾部斜杠或错误路径 | 将 base URL 精确设置为 https://runapi.ai，无尾部路径 |
| Model not found | 无效或拼写错误的模型 ID | 使用有效 ID，如 claude-sonnet-4-6 或 claude-opus-4-7 |
| 重启后变量丢失 | export 语句未写入 shell profile | 将两个 export 语句追加到 ~/.zshrc 或 ~/.bashrc 并重新加载 |

## 如何通过 RunAPI 配置 Claude Code API key

1. **设置 base URL** — export ANTHROPIC_BASE_URL=https://runapi.ai，将请求路由到 RunAPI。
2. **设置 API key** — 将 ANTHROPIC_API_KEY export 为控制台 → API Keys 中的 RunAPI 密钥。
3. **持久化两个变量** — 将两个 export 语句追加到 ~/.zshrc 或 ~/.bashrc，并通过 source ~/.zshrc 重新加载，使其在新会话中保持生效。Windows 用户在 PowerShell 中设置后需打开新终端窗口。
4. **运行 Claude Code** — 运行 claude --version 确认安装，然后在项目中启动 claude。请求现在以官方价格 50% 通过 RunAPI 路由。

## Claude Code API Key FAQ

### 如何向 Claude Code 添加 API key？

设置两个环境变量。将 ANTHROPIC_BASE_URL export 为 https://runapi.ai，将 ANTHROPIC_API_KEY export 为你的 RunAPI 密钥。将两者追加到你的 shell profile（.zshrc 或 .bashrc）以在会话间保持生效。Claude Code 在启动时读取它们，并将所有请求路由到 RunAPI。

### 去哪里获取 Claude Code API key？

在 runapi.ai 创建一个。注册后，打开控制台 → API Keys，生成密钥。立即复制——完整密钥仅在创建时显示一次。免费套餐包含额度，可在充值余额前测试任意 Claude 模型。

### ANTHROPIC_BASE_URL 有什么用？

它告诉 Claude Code 将请求发送到哪个端点。默认情况下 Claude Code 直接调用 Anthropic。将其设置为 https://runapi.ai 后，所有请求都会路由到 RunAPI，以官方价格 50% 为相同模型计费。

### 我可以通过 Claude Code 使用 OpenAI 等其他 API 服务商吗？

有。Claude Code 通过 ANTHROPIC_BASE_URL 支持任何兼容 OpenAI 的端点。RunAPI 暴露兼容的网关，让你无需修改代码即可切换服务商，用一个密钥访问 Claude、GPT 和其他模型。

### 为什么 Claude Code 仍然按全价计费？

在终端运行 echo $ANTHROPIC_BASE_URL。如果没有输出，说明 export 未持久化。将两个 export 语句追加到 ~/.zshrc 或 ~/.bashrc，运行 source ~/.zshrc，然后打开新终端重新检查。Windows 用户需要在设置环境变量后打开新的 PowerShell 窗口。

### 我可以将密钥存储在配置文件中吗？

可以。将值放在家目录或项目目录下的 .claude.json 文件中，而无需每次会话都 export。两种方式均可使用——文件适合按项目配置密钥，export 语句对单一全局配置更简单。

### 配置完成后如何监控费用？

打开 RunAPI 控制台。它实时显示每个密钥和每次请求的消费。要限制输出费用，设置 CLAUDE_CODE_MAX_OUTPUT_TOKENS 以限制每次响应长度，并对日常编辑使用 claude-haiku-4-5。

### 这会改变 Claude Code 的行为吗？

不会。RunAPI 将请求直接代理到底层 Claude 模型。输出、工具调用和行为与直接调用 Anthropic 完全相同。你只改变了请求的目的地和计费方式——编码体验保持不变。