RequestBeam

文档目录

RequestBeam 文档

Claude Code 接入

在 Claude Code 中使用 RequestBeam 的 Claude Messages 兼容接口。

Claude Code 使用 Anthropic Messages 协议调用模型。配置时把 ANTHROPIC_BASE_URL 设置为本页显示的 Anthropic 兼容 Base URL。

text
ANTHROPIC_BASE_URL=https://api.requestbeam.com/anthropic

准备工作

你需要先准备一个可用的 RequestBeam API Key。该 Key 会写入本机 shell 环境，请不要提交到仓库、日志或截图中。

安装 Claude Code

macOS / Linux 推荐使用 Claude Code 原生安装脚本：

bash
curl -fsSL https://claude.ai/install.sh | bash

如果终端提示安装位置是 ~/.local/bin/claude，但运行 claude 时提示找不到命令，请重新打开终端，或把 ~/.local/bin 加入 PATH。

需要兼容旧流程时，也可以使用 npm 包安装：

bash
npm install -g @anthropic-ai/claude-code

不要使用 sudo npm install -g @anthropic-ai/claude-code，否则后续升级和本地权限可能会出问题。

安装后可以先确认 CLI 可用：

bash
claude --version
claude doctor

Windows 建议优先使用 Git Bash 或 WSL 运行 Claude Code。PowerShell 也可以设置环境变量，但不同终端的持久化方式不同。

配置环境变量

临时配置只对当前终端会话生效，适合先验证：

bash
export ANTHROPIC_AUTH_TOKEN="YOUR_REQUESTBEAM_API_KEY"
export ANTHROPIC_BASE_URL="https://api.requestbeam.com/anthropic"
export ANTHROPIC_MODEL="claude-sonnet-4-6"

macOS 默认 shell 是 zsh。需要长期生效时，把配置写入 ~/.zshrc，写完后运行 source ~/.zshrc 让当前终端立即生效：

bash
printf '%s\n' \
  'export ANTHROPIC_AUTH_TOKEN="YOUR_REQUESTBEAM_API_KEY"' \
  'export ANTHROPIC_BASE_URL="https://api.requestbeam.com/anthropic"' \
  'export ANTHROPIC_MODEL="claude-sonnet-4-6"' \
  >> ~/.zshrc

source ~/.zshrc

Linux 如果使用 bash，通常写入 ~/.bashrc 并运行 source ~/.bashrc。

Windows PowerShell 临时配置：

powershell
$env:ANTHROPIC_AUTH_TOKEN="YOUR_REQUESTBEAM_API_KEY"
$env:ANTHROPIC_BASE_URL="https://api.requestbeam.com/anthropic"
$env:ANTHROPIC_MODEL="claude-sonnet-4-6"

PowerShell 用户级持久化：

powershell
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "YOUR_REQUESTBEAM_API_KEY", "User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.requestbeam.com/anthropic", "User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL", "claude-sonnet-4-6", "User")

设置后重新打开 PowerShell，再运行 claude。

配置文件方式

如果不想把变量写入 shell 配置，也可以创建或编辑 ~/.claude/settings.json。如果文件已存在，请把 env 和 model 合并到原有 JSON 中，不要覆盖其他设置：

json
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "YOUR_REQUESTBEAM_API_KEY",
    "ANTHROPIC_BASE_URL": "https://api.requestbeam.com/anthropic",
    "ANTHROPIC_MODEL": "claude-sonnet-4-6"
  },
  "model": "claude-sonnet-4-6"
}

可用模型：

  • claude-fable-5
  • claude-fable-5-1
  • claude-haiku-4-5
  • claude-opus-4-5
  • claude-opus-4-6
  • claude-opus-4-7
  • claude-opus-4-8
  • claude-opus-5
  • claude-opus-5-5
  • claude-sonnet-4-5
  • claude-sonnet-4-6
  • claude-sonnet-5

当前 API Key 的实际可用模型以 GET https://api.requestbeam.com/v1/models 返回结果为准。

启动并测试

设置环境变量后重新启动 Claude Code，并发起一次普通对话：

bash
claude "Reply exactly OK."

也可以进入交互模式：

bash
claude

首次启动可能会要求选择主题、确认安全提示、推荐终端设置或信任当前目录，按终端提示完成即可。

选择模型

可以通过环境变量设置默认模型，也可以在单次调用时用 --model 指定：

bash
claude --model claude-sonnet-4-6 "Review this PR"

接口说明

Claude Code 会使用配置里的 RequestBeam API Key 进行认证。服务端接受以下认证方式：

http
x-api-key: YOUR_REQUESTBEAM_API_KEY
anthropic-version: 2023-06-01
http
Authorization: Bearer YOUR_REQUESTBEAM_API_KEY
anthropic-version: 2023-06-01

响应保持 Anthropic Messages 原生 JSON 或 SSE 事件，不会转换成 OpenAI 格式。

常见问题

  • ANTHROPIC_BASE_URL 必须是本页显示的公开 API Base URL 加 /anthropic。
  • 不要把接口路径写进 ANTHROPIC_BASE_URL；这里只需要填写 Anthropic 兼容基础地址。
  • macOS 修改 ~/.zshrc 后，必须运行 source ~/.zshrc 或重新打开终端，当前会话才会读取新配置。
  • 如果运行 claude 提示 command not found，确认安装输出位置是否在 PATH 中，常见位置是 ~/.local/bin/claude。
  • 如果 claude doctor 报环境变量缺失，请在当前终端运行 echo $ANTHROPIC_BASE_URL 和 echo $ANTHROPIC_MODEL 检查配置是否已加载。
  • 如果返回 401，请确认 API Key 有效。
  • 如果返回模型不可用，请确认模型名来自上方可用模型列表。
  • 修改环境变量后，需要重新启动 Claude Code 进程。
  • POST https://api.requestbeam.com/anthropic/v1/messages：Anthropic Messages 兼容接口。