Claude Code 配置

Claude Code 直连接入 pragma 时，通常走 Anthropic Messages 协议。

第一次配置前，先完成：

如果你还不确定该选哪个客户端，先看客户端配置总览。

开始前准备

你需要准备：

一个可用的 pragma 账号。
一个你自己创建的 API Key。
已安装的 Claude Code。
当前终端能访问 Pragma 主站。

建议先在创建 API Key 页面完成 /v1/models 最小验证。这个验证只是确认 Key 和基础网络可用；Claude Code 正式请求不会让你手动填写 /v1/models。

关键规则

Base URL 不要带 /v1：

Claude Code 直连配置

Claude Code 会自己拼接 /v1/messages，Base URL 不要带 /v1。

ANTHROPIC_BASE_URLhttps://pragma.academic-ruc.cc

ANTHROPIC_AUTH_TOKENsk-your-key

ANTHROPIC_MODEL以当前可用模型为准

验证任务请只回复 OK

text

正确：https://pragma.academic-ruc.cc
错误：https://pragma.academic-ruc.cc/v1

Claude Code 会自动在后面拼接 /v1/messages。如果你手动填了 /v1，实际请求可能变成 /v1/v1/messages，导致 404。

基本配置

配置项	值
`ANTHROPIC_BASE_URL`	`https://pragma.academic-ruc.cc`
`ANTHROPIC_AUTH_TOKEN`	你在 pragma 创建的 `sk-...`
`ANTHROPIC_MODEL`	以当前可用模型为准

PowerShell 示例

powershell

$env:ANTHROPIC_BASE_URL = "https://pragma.academic-ruc.cc"
$env:ANTHROPIC_AUTH_TOKEN = "sk-your-key"
$env:ANTHROPIC_MODEL = "gpt-5.5"

然后重新启动 Claude Code。

macOS / Linux 示例

bash

export ANTHROPIC_BASE_URL="https://pragma.academic-ruc.cc"
export ANTHROPIC_AUTH_TOKEN="sk-your-key"
export ANTHROPIC_MODEL="gpt-5.5"

设置后关闭旧的 Claude Code 进程，再从同一个终端重新启动 Claude Code。

验证方式

配置后验收先短测，再长任务

Base URL
ANTHROPIC_BASE_URL 不带 /v1。
重启进程
设置变量后关闭旧 Claude Code。
短问题
先确认短问题能正常返回。

先发一个短问题，例如：

text

请只回复 OK

如果短问题可用，但复杂任务失败，可能是长上下文、工具调用或客户端协议细节导致。先新开会话或降低任务复杂度。

常见错误

错误	可能原因	处理
401	Key 错误或已删除	重新创建 API Key
403	Key 所属权限不足	联系管理员确认权限
404	Base URL 多写了 `/v1`	改成 `https://pragma.academic-ruc.cc`
首 Token 很慢	长上下文或高 reasoning	清理上下文、降低 reasoning

与 OpenAI-compatible 客户端的区别

客户端类型	Base URL
Claude Code 直连	`https://pragma.academic-ruc.cc`
Codex / Cherry / OpenAI SDK	`https://pragma.academic-ruc.cc/v1`

下一步

我想做什么	下一页
确认其他客户端怎么填	客户端配置总览
排查 401 / 403 / 404	故障排查
判断是不是服务故障	服务状态
配 Codex CLI	Codex CLI
配 RTK 省 token	RTK 省 token 配置
在 OAuth、API、RTK、cache-fix 之间选择	省 token 决策中心

Claude Code 配置 ​

开始前准备 ​

关键规则 ​

基本配置 ​

PowerShell 示例 ​

macOS / Linux 示例 ​

验证方式 ​

常见错误 ​

与 OpenAI-compatible 客户端的区别 ​

下一步 ​