已安装 Claude Code
从官方来源安装 Claude Code，并在终端运行 claude --version 确认其正常运行。如果该命令报错，请先修复安装问题，再设置任何 API key。
Claude Code
Claude Code API Key 配置
Claude Code 读取两个环境变量来将请求路由到任意位置：ANTHROPIC_BASE_URL 和 ANTHROPIC_API_KEY。将它们指向 RunAPI，以官方价格一半运行所有 Claude 模型。本指南提供 Mac、Linux 和 Windows 的精确命令。
更新于 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 正常运行。
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 实际读取的变量。
1
设置 base URL
这告诉 Claude Code 将请求发送到 RunAPI，而非默认的 Anthropic 端点。
export ANTHROPIC_BASE_URL=https://runapi.ai
2
设置 API key
将占位符替换为你的 RunAPI 密钥。Claude Code 使用它来认证每次请求。
export ANTHROPIC_API_KEY=sk-your-runapi-key
3
持久化两个变量
将两个 export 语句追加到 ~/.zshrc（或 ~/.bashrc），使其在新终端会话中保持生效。通过 source ~/.zshrc 重新加载。Windows 用户在 PowerShell 中设置，并打开新终端窗口使更改生效。
echo 'export ANTHROPIC_BASE_URL=https://runapi.ai' >> ~/.zshrc
4
验证配置
确认变量打印出 RunAPI URL。如果为空，请重新加载 shell profile 或打开新终端——在一个会话中设置的变量不会自动传递到其他会话。
echo $ANTHROPIC_BASE_URL
5
运行 Claude Code
在项目中启动 Claude Code。它现在以官方价格 50% 通过 RunAPI 路由。
claude环境变量
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.json 配置文件中，而无需每次会话都 export。
选择模型
在 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 并重新加载 |
快速版本
四步完成 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 完全相同。你只改变了请求的目的地和计费方式——编码体验保持不变。
相关内容
继续探索
用两条命令将 Claude Code 指向 RunAPI。
创建免费 RunAPI 账号，在 shell profile 中设置 ANTHROPIC_BASE_URL 和 ANTHROPIC_API_KEY，以 Anthropic 官方定价 50% 在 Claude Code 中运行所有 Claude 模型。