已安装 Claude Code
从官方来源安装 Claude Code，并确认可以在终端中用 claude 命令运行。
Claude Code
Claude Code API Key 配置
Claude Code 读取两个环境变量来路由请求：ANTHROPIC_BASE_URL 和 ANTHROPIC_API_KEY。将它们指向 RunAPI，即可以官方价格的一半运行所有 Claude 模型。本指南提供具体命令。
更新于 June 18, 2026
RunAPI 编辑团队
概览
如何在 Claude Code 中设置自定义 API key？
Claude Code 使用两个环境变量来决定请求的去向和认证方式。将它们设置为 RunAPI 的值，所有请求将以 50% 折扣通过 RunAPI 路由。以下卡片在完整说明前涵盖关键要点。
两个变量
ANTHROPIC_BASE_URL 设置接入点。ANTHROPIC_API_KEY 设置密钥。这就是全部配置。
接入点值
将 ANTHROPIC_BASE_URL 设置为 https://api.runapi.ai，让 Claude Code 通过 RunAPI 路由。
持久化配置
将两个导出添加到 shell profile 或 .claude.json，避免每次会话重新设置。
50% 折扣
所有 Claude 模型以官方 Anthropic 价格的一半计费。无需订阅，无上限。
开始之前
配置 Claude Code 前需要准备什么？
配置只需几分钟。你需要已安装 Claude Code、一个 RunAPI 账户和一个终端。以下清单涵盖第一条命令前所需的全部准备工作。
RunAPI 账户
在 runapi.ai 注册。免费套餐包含测试所有 Claude 模型的额度。
API key
从 Dashboard → API Keys 创建密钥。只复制一次——密钥仅在创建时完整显示。
终端访问
需要 shell 来设置环境变量。macOS、Linux 和 Windows 上的 WSL 操作方式相同。
分步操作
如何使用 RunAPI 配置 Claude Code API key
按顺序运行以下命令。它们设置接入点和密钥，将其持久化到 shell profile，并确认 Claude Code 已正确读取。将占位符替换为你真实的 RunAPI 密钥。
1
设置基础 URL
这告诉 Claude Code 将请求发送到 RunAPI 而不是默认的 Anthropic 接入点。
export ANTHROPIC_BASE_URL=https://api.runapi.ai
2
设置 API key
将占位符替换为你的 RunAPI 密钥。Claude Code 使用它来验证每个请求。
export ANTHROPIC_API_KEY=sk-your-runapi-key
3
持久化两个变量
将两个导出追加到 ~/.zshrc（或 ~/.bashrc），以便在新终端会话中保持有效。用 source ~/.zshrc 重新加载。
echo 'export ANTHROPIC_BASE_URL=https://api.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_BASE_URL | Claude Code 发送请求的自定义接入点 | https://api.runapi.ai |
| ANTHROPIC_API_KEY | 用于验证请求的密钥 | sk-your-runapi-key |
| ANTHROPIC_MODEL | 新会话的默认模型 | claude-sonnet-4-6 |
| CLAUDE_CODE_MAX_OUTPUT_TOKENS | 每次响应返回的 token 上限 | 8192 |
也可以将这些变量保存在主目录或项目目录的 .claude.json 配置文件中，无需每次导出。
选择模型
在 Claude Code 中应该运行哪个 Claude 模型？
Claude Code 通过 RunAPI 支持所有 Claude 模型 ID。按任务选择：日常编辑用快速廉价的模型，日常编码用均衡型，复杂问题用最强模型。
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 不起作用？
大多数配置问题来自变量未设置、shell 过期或密钥拼写错误。下表列出常见错误及其解决方法。
| 错误或症状 | 可能原因 | 解决方法 |
|---|---|---|
| 401 未授权 | API key 错误或已过期 | 检查 ANTHROPIC_API_KEY，如需要在 RunAPI 控制台创建新密钥 |
| 请求仍访问 Anthropic | 当前 shell 中未设置 ANTHROPIC_BASE_URL | 运行 echo $ANTHROPIC_BASE_URL；如为空，重新加载 profile 或打开新终端 |
| 404 未找到 | 基础 URL 末尾有斜杠或路径错误 | 将基础 URL 精确设置为 https://api.runapi.ai，末尾无路径 |
| 找不到模型 | 模型 ID 无效或拼写错误 | 使用有效 ID，如 claude-sonnet-4-6 或 claude-opus-4-7 |
| 重启后变量丢失 | 导出未写入 shell profile | 将两个导出追加到 ~/.zshrc 或 ~/.bashrc 并重新加载 |
快速版本
四步完成 Claude Code API key 配置
1
设置基础 URL
导出 ANTHROPIC_BASE_URL=https://api.runapi.ai 以将请求路由到 RunAPI。
2
设置 API key
使用 Dashboard → API Keys 中的 RunAPI 密钥导出 ANTHROPIC_API_KEY。
3
持久化两个变量
将两个导出追加到 ~/.zshrc 或 ~/.bashrc 并重新加载，以便在新会话中保持有效。
4
运行 Claude Code
在项目中启动 claude。请求现在通过 RunAPI 以官方价格 50% 的价格路由。
常见问题
Claude Code API Key 常见问题
如何为 Claude Code 添加 API key？
设置两个环境变量。将 ANTHROPIC_BASE_URL 导出为 https://api.runapi.ai，将 ANTHROPIC_API_KEY 导出为你的 RunAPI 密钥。将两者追加到 shell profile 以持久保存。Claude Code 在启动时读取这两个变量，并将所有请求路由到 RunAPI。
在哪里获取 Claude Code API key？
在 runapi.ai 创建一个。注册后打开 Dashboard → API Keys，生成密钥。请立即复制，因为完整密钥仅在创建时显示一次。免费套餐包含测试所有 Claude 模型的额度。
ANTHROPIC_BASE_URL 有什么用？
它告诉 Claude Code 将请求发送到哪个接入点。默认情况下，Claude Code 直接调用 Anthropic。将其设置为 https://api.runapi.ai 后，所有请求都会通过 RunAPI 路由，以官方价格的 50% 计费相同模型。
为什么 Claude Code 仍按全价计费？
基础 URL 可能未在当前 shell 中设置。运行 echo $ANTHROPIC_BASE_URL——如果为空，说明导出未持久化。将其追加到 ~/.zshrc 或 ~/.bashrc，用 source 重新加载，然后打开新终端再次检查。
可以将密钥存储在配置文件中吗？
可以。将值放在主目录或项目目录的 .claude.json 文件中，而不是每次导出。两种方式均可；文件更适合按项目设置密钥，而导出更适合单一全局配置。
配置后如何监控费用？
打开 RunAPI 控制台。它实时显示每个密钥和每次请求的消费。要控制输出成本，设置 CLAUDE_CODE_MAX_OUTPUT_TOKENS 来限制每次响应的 token 数，并在日常编辑中选择更便宜的模型，如 Haiku。
这会改变 Claude Code 的行为吗？
不会。RunAPI 直接代理请求到底层 Claude 模型。输出、工具调用和行为与默认配置完全相同。你只是改变了请求的去向和计费方式——编码体验保持不变。
应该将哪个模型设为默认？
大多数开发者将 ANTHROPIC_MODEL 设置为 claude-sonnet-4-6 用于日常编码。快速廉价的编辑用 claude-haiku-4-5，复杂重构用 claude-opus-4-7。可以随时在 Claude Code 内切换模型，计费跟随实际调用的模型。
两条命令将 Claude Code 接入 RunAPI。
创建免费 RunAPI 账户，设置 ANTHROPIC_BASE_URL 和 ANTHROPIC_API_KEY，以官方 Anthropic 定价 50% 的价格在 Claude Code 中运行所有 Claude 模型。