文档中心阅读博客
文档中心使用者指南

接入 Claude Code:Base URL 与本地 Token

区分 Claude Code 的消费端连接和官方账号供号同步,配置根地址并验证工具执行。

不要把两种“登录 Claude”混在一起

消费端接入:Claude Code 使用 PrimeRouter 的本地入口和本地 Key 调模型。

供号端同步:Partner Client 从官方 Claude Code 登录读取访问凭证,把你的账号作为上游供给。这要求官方来源与相应授权,不能把消费端 Key 当成官方 OAuth 凭证。

两种角色可以并存,但建议使用独立配置环境,尤其是你正在售卖本机账号的时候。

桌面导入步骤

在 User Client 的“本地 Key”找到供 Claude Code 使用的 Key,打开“导入本机 Agent”,选择 Claude Code。核对模型、目标配置文件和将写入的环境字段,确认后应用并重启 Claude Code。

Client 会备份原配置。Claude Code 可能同时受到环境变量和设置文件影响,旧的其他提供商配置不一定因为关闭一个终端而消失。

本地 Key 的工具接入入口

手动环境配置

下面是 Bash 例子。地址填根入口,不额外添加 /v1;Token 填本地 Key:

export ANTHROPIC_BASE_URL="http://127.0.0.1:18000"
export ANTHROPIC_AUTH_TOKEN="YOUR_LOCAL_KEY"
unset ANTHROPIC_API_KEY
claude

这里只是展示消费端连接。把占位符替换为本地 Key,并确认同一启动环境没有冲突的 Bedrock、Vertex、其他网关或自定义授权配置。Windows PowerShell 使用对应环境语法:

$env:ANTHROPIC_BASE_URL = "http://127.0.0.1:18000"
$env:ANTHROPIC_AUTH_TOKEN = "YOUR_LOCAL_KEY"
Remove-Item Env:ANTHROPIC_API_KEY -ErrorAction SilentlyContinue
claude

环境变量改变只影响相应终端及之后启动的进程。已有 Claude Code 会话需要重新启动。若用设置文件导入,以 Client 预览展示的目标文件为准,避免同时维护多份互相覆盖的设置。

同时售卖官方账号怎么办

可以为消费端单独设置 CLAUDE_CONFIG_DIR,保持供号用的官方 Claude Code 配置、登录和 Partner 检测范围独立。不要在不了解来源优先级时删除官方凭证文件或钥匙串条目。

Partner 提示“非官方提供商”时,先检查消费端网关设置是否影响了供号端的官方来源,而不是反复上传相同凭证。

确认连接和模型

选择本地 Key 允许的模型,先发短请求。再让 Claude Code 在临时项目里读一个小文件,确认返回的工具调用能被本机执行。记录中的来源可以因 CLI、IDE、SDK 或桌面形态不同而不同。

如果提示模型不可用或输入超限,以当前渠道和最终套餐容量为准,不要只在工具端勾选扩展上下文。相关问题见定价策略与排障。