Claude Code 接入 JarlessAPI 指南¶

本文档介绍如何安装 Claude Code 并将其配置为通过 JarlessAPI 提供服务。

前置条件¶

已安装 Node.js（建议版本 18 及以上）
已在 JarlessAPI 控制台获取 Claude Code 分组对应的 API Key（参见获取 API Key）

第一步：安装 Claude Code¶

在终端中执行以下命令，全局安装 Claude Code：

Windows / macOS / LinuxmacOS / Linux（权限不足时）网络受限时（使用国内镜像）

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

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

npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

安装完成后，执行以下命令验证安装是否成功：

claude --version

若终端输出版本号，则安装成功。

第二步：配置环境变量¶

Claude Code 通过 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN 两个环境变量确定服务地址与鉴权密钥。建议将这两个变量写入系统配置文件，以确保重启后持续生效。

WindowsmacOSLinux

以管理员身份打开 PowerShell（按 Win + X，选择"终端管理员"），执行以下命令：

[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://jarlessapi.com", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "你的 Claude Code 分组 API Key", [System.EnvironmentVariableTarget]::User)

配置完成后，关闭并重新打开一个新的 PowerShell 窗口，变量方可生效。

打开终端（Terminal），执行以下命令将变量追加至 Shell 配置文件：

echo 'export ANTHROPIC_BASE_URL="https://jarlessapi.com"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="你的 Claude Code 分组 API Key"' >> ~/.zshrc
source ~/.zshrc

打开终端，执行以下命令将变量追加至 Shell 配置文件：

echo 'export ANTHROPIC_BASE_URL="https://jarlessapi.com"' >> ~/.bashrc
echo 'export ANTHROPIC_AUTH_TOKEN="你的 Claude Code 分组 API Key"' >> ~/.bashrc
source ~/.bashrc

使用正确分组的密钥

ANTHROPIC_AUTH_TOKEN 必须填写 Claude Code 专属分组的 API Key，不可使用其他客户端分组的密钥，否则请求将返回鉴权错误。

第三步：启动 Claude Code¶

在终端中切换至你的项目目录，执行以下命令启动 Claude Code：

claude

Claude Code 将自动读取已配置的环境变量并连接至 JarlessAPI 服务。

验证配置是否生效¶

若启动后遇到连接或鉴权错误，可执行以下命令确认当前终端窗口中的环境变量值：

macOS / LinuxWindows PowerShell

echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_AUTH_TOKEN

echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_AUTH_TOKEN

若输出为空或显示旧值，说明当前窗口未加载最新配置，请重新执行 source 命令或重启终端窗口。

更多排错方法，参见常见错误排查。