Claude Code 接入 JarlessAPI 指南¶
本文档介绍如何安装 Claude Code 并将其配置为通过 JarlessAPI 提供服务。
本页覆盖 Claude Code 终端版。不熟悉命令行时，先按 准备工作 打开终端并创建练习文件夹。
前置条件¶
- 已安装 Node.js 22 或更高版本（可执行
node --version确认） - 已在 JarlessAPI 控制台创建 API Key，并确认该分组支持的模型 ID（参见 获取 API Key）
第一步：安装 Claude Code¶
在终端中执行以下命令，全局安装 Claude Code：
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
若终端输出版本号，则安装成功。
npm 12 提示安装脚本被阻止
如果安装时出现 install scripts blocked 或 allowScripts 提示，并且 claude --version 无法运行，重新执行以下命令，只允许 Claude Code 的安装脚本：
npm install -g @anthropic-ai/claude-code --allow-scripts=@anthropic-ai/claude-code --registry=https://registry.npmmirror.com
完成后再次执行 claude --version。
第二步：配置环境变量¶
Claude Code 通过 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN 两个环境变量确定服务地址与鉴权密钥。建议将这两个变量写入系统配置文件，以确保重启后持续生效。
打开 PowerShell，执行以下命令：
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://jarlessapi.com", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "你所选分组的 API Key", [System.EnvironmentVariableTarget]::User)
配置完成后，关闭并重新打开一个新的 PowerShell 窗口，变量方可生效。
打开终端（Terminal），执行以下命令将变量追加至 Shell 配置文件：
echo 'export ANTHROPIC_BASE_URL="https://jarlessapi.com"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="你所选分组的 API Key"' >> ~/.zshrc
source ~/.zshrc
打开终端，执行以下命令将变量追加至 Shell 配置文件：
echo 'export ANTHROPIC_BASE_URL="https://jarlessapi.com"' >> ~/.bashrc
echo 'export ANTHROPIC_AUTH_TOKEN="你所选分组的 API Key"' >> ~/.bashrc
source ~/.bashrc
Claude Code 可以使用其他分组的 API Key。使用时需指定该分组支持的模型 ID，不能只换密钥而沿用不受支持的默认模型。
第三步：启动 Claude Code¶
在终端中切换至你的项目目录，执行以下命令启动 Claude Code：
claude
Claude Code 将自动读取已配置的环境变量并连接至 JarlessAPI 服务。
需要换模型时，在 Claude Code 对话中输入 /model 即可。使用其他分组时，也可以直接输入下面这条指令，把占位文字替换成该分组支持的完整模型 ID：
/model 该分组支持的模型ID
模型选择方式见 Claude Code 官方说明，可用的模型 ID 以 JarlessAPI 控制台中该分组的列表为准。
验证配置是否生效¶
若启动后遇到连接或鉴权错误，可执行以下命令检查当前窗口中的服务地址和密钥是否已配置：
echo $ANTHROPIC_BASE_URL
if [ -n "$ANTHROPIC_AUTH_TOKEN" ]; then echo "已配置"; else echo "未配置"; fi
echo $env:ANTHROPIC_BASE_URL
-not [string]::IsNullOrWhiteSpace($env:ANTHROPIC_AUTH_TOKEN)
密钥检查应显示“已配置”（PowerShell 为 True），地址应与上方一致。若不符，请重新执行 source 命令或重启终端窗口。
更多排错方法，参见 常见错误排查。
接通以后，做第一个任务¶
从 个人作品集、汇报 PPT 或 知识图卡 选择一个练习。想复用工作方法，可以继续查看 Skill 安装与第一次使用。