博客

用 API key 接入 Claude Code

Claude Code 默认直接连 Anthropic。设两个环境变量，它就改用你给的地址和 key，其余用法都不变。

RoamAI 团队发布于 2026年10月16日

准备什么

  • 装好 Claude Code。运行 claude --version 能看到版本号。
  • 一把 API key，在控制台的「API key」页创建。完整的 key 只在创建时显示一次。
  • Base URL：https://relay.roamai.cloud:18443

方法一：环境变量

在终端里设两个变量再启动 claude，只对这个终端生效。macOS 和 Linux：

export ANTHROPIC_BASE_URL=https://relay.roamai.cloud:18443
export ANTHROPIC_AUTH_TOKEN=rak1_你的key
claude

要一直生效，把两行 export 加进 ~/.zshrc 或 ~/.bashrc。

Windows PowerShell：

$env:ANTHROPIC_BASE_URL = 'https://relay.roamai.cloud:18443'
$env:ANTHROPIC_AUTH_TOKEN = 'rak1_你的key'
claude

要让之后新开的窗口也生效，用 setx 存成用户环境变量。存完要新开一个窗口，当前窗口读不到。

setx ANTHROPIC_BASE_URL 'https://relay.roamai.cloud:18443'
setx ANTHROPIC_AUTH_TOKEN 'rak1_你的key'

Windows 命令提示符（CMD）：

set "ANTHROPIC_BASE_URL=https://relay.roamai.cloud:18443"
set "ANTHROPIC_AUTH_TOKEN=rak1_你的key"
claude

方法二：写进 settings.json

这台电脑上的 Claude Code 都会用它，不用每次设变量。文件在 ~/.claude/settings.json，Windows 上是 %USERPROFILE%\.claude\settings.json：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://relay.roamai.cloud:18443",
    "ANTHROPIC_AUTH_TOKEN": "rak1_你的key"
  }
}
文件里已经有内容的话，只把 env 这一段合并进去，别整个覆盖。

为什么用 ANTHROPIC_AUTH_TOKEN

用 ANTHROPIC_API_KEY 也能连上，但交互式的 claude 第一次会问要不要用这把 key；这台电脑如果登录过 claude.ai，还会提示两种认证冲突。ANTHROPIC_AUTH_TOKEN 没有这两个问题。

确认接上了

  1. 在 claude 里随便问一句。
  2. 回到控制台，「接通 RoamAI」里 API key 那一步会变绿，「用量」里能看到这条请求和它的费用。

常见报错

  • invalid api key (create one in the RoamAI console)：key 写错了，或者已经停用。到控制台核对，或者新建一把。
  • this API key has been suspended…：这把 key 的请求触发了 Claude 的安全拦截，被暂停了。联系我们复核。
  • Your RoamAI credit balance has run out…：预付余额用完了，到控制台充值后恢复。
  • no server online for this workspace：你的空间还没开通好。控制台首页能看到进度，等了很久的话联系我们。

一人一把 key，接上 Claude Code

RoamAI 是给团队用的 Claude API：在控制台签一把 key，填进 Claude Code、Claude Desktop 或 SDK 就能用。不收月费，用量按 token 计。

开始使用

← 全部文章