Claude Code 配置

把 Claude Code 指向 FluxToken：装工具、配两个环境变量、验证连通。

📌

先记住这条，能省掉一半的报错

ANTHROPIC_BASE_URL 要填不带 /v1 的根地址。

要 https://cn.fluxtoken.ai，不要 https://cn.fluxtoken.ai/v1。

客户端会自己在后面拼 /v1/messages。多写一个 /v1 会拼成 /v1/v1/messages，表现是 404 或「认证失败」，很多人会误以为是令牌的问题。

前置的端点选择、创建令牌、Node 环境检查都在通用准备里，这里不重复。本页默认你已经有一个带分组的令牌。

一、安装

Claude Code 通过 npm 分发，全局装一次：

全局安装 Claude Code

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

装完确认命令在 PATH 里：

确认安装成功

claude --version

装不上怎么办

Unsupported engine / EBADENGINE → Node 版本过低，升级 Node 后重装。
EACCES 权限错误 → 是 npm 全局目录的权限问题，不要用 sudo 硬装，改用版本管理器（nvm / fnm）接管 Node，或配置 npm 的用户级全局目录。
具体的最低 Node 版本与安装方式，以 Claude Code 官方文档为准，它会随版本变化，写死在文档里必然过期。

二、配置方式一：环境变量

最直接的方式。在 shell 的启动文件（~/.bashrc、~/.zshrc 等）里加两行：

写入环境变量（加到 shell 配置文件）

export ANTHROPIC_BASE_URL=https://cn.fluxtoken.aiexport ANTHROPIC_AUTH_TOKEN=sk-你的令牌

生效并验证：

生效并检查变量

source ~/.zshrcecho $ANTHROPIC_BASE_URLecho $ANTHROPIC_AUTH_TOKEN

两条 echo 都应该打印出你刚写的值。打印为空说明写错了文件（比如用了 zsh 却改的 .bashrc）。

关于变量名

端点是 ANTHROPIC_BASE_URL。
令牌用 ANTHROPIC_AUTH_TOKEN。
两个变量名都要拼对，拼错的表现是客户端仍然去连官方地址，你会看到跟官方相关的报错。

如果你之前配过 Anthropic 官方的 key（ANTHROPIC_API_KEY），建议先把它清掉再试，避免两个变量同时存在时客户端挑了另一个。

三、配置方式二：settings.json

不想污染全局环境变量、或者想让配置跟着项目走，用 settings.json。它接受一个 env 字段，写进去的键值对等价于环境变量：

~/.claude/settings.json

{  "env": {    "ANTHROPIC_BASE_URL": "https://cn.fluxtoken.ai",    "ANTHROPIC_AUTH_TOKEN": "sk-你的令牌"  }}

两种方式怎么选：

方式	特点	适合
环境变量	全局生效，所有 shell 会话都带	只有一个中转站配置，图简单
`settings.json`	跟着用户或项目走，不动 shell	需要按项目切不同端点 / 分组

文件位置与字段名以官方文档为准

settings.json 的路径、作用域（用户级 / 项目级）和字段名由 Claude Code 定义，可能随版本调整。上面给的是常见形态，以 Claude Code 官方文档为准。如果配置不生效，优先怀疑是路径放错或字段名不对，而不是令牌的问题。

四、分组建议

Claude Code 是长会话、高频请求的工具，分组选得对不对直接影响成本。两个推荐：

场景	分组	理由
日常写代码（推荐）	`【Claude】Max · 稳享（主）`	稳定优先线路，适合持续对话与复杂任务
想省钱	`【Claude】Max · 惠享`	性价比线路，倍率更低

关于 惠享 有一条必须知道：控制台的官方说明原文写的是 「cursor、kiro性价比线路 · 缓存可能会有浮动，若有异常请立即切换稳享分组。」

这不是免责声明，是使用说明。遇到缓存浮动、响应异常，按它说的做——立刻切回 稳享，不要等它自己恢复。

Claude Code 里缓存命中尤其重要

Claude Code 每次请求都会带上完整的对话历史与系统提示，缓存命中率直接决定账单。 惠享 的说明点名了缓存会浮动，而 稳享 是稳定优先线路。省钱和稳定在这里是可量化的取舍，原理见缓存优化。

如果你要在 Claude Desktop 里用（不是 Claude Code），分组规则完全不同，见 Claude Desktop。

五、连通性验证

按顺序跑，能精确定位是服务端问题还是客户端配置问题。

第一步：不带令牌打端点，期望 401

端点连通性（期望 401）

curl -s -o /dev/null -w '%{http_code}' https://cn.fluxtoken.ai/v1/models; echo

401 是正确结果——端点通，只是拒绝了没带凭证的请求。

第二步：带令牌打一次，期望 200

令牌有效性（期望 200 与模型清单）

curl -s https://cn.fluxtoken.ai/v1/models -H "Authorization: Bearer sk-你的令牌"

返回的模型清单就是你这个令牌所在分组的可用模型。

第三步：启动 Claude Code

启动

claude

随便发一句话。能正常回复就说明整条链路通了。

六、验证不通过时的排查顺序

你看到的	先查这里
连不上 / 超时	端点选错了？国内加速异常可回退全球站 · 源站直连https://api.fluxtoken.ai港澳台及境外用户请用此地址；国内加速异常时也可回退到这里。
401 / 认证失败	`ANTHROPIC_AUTH_TOKEN` 是否写全、有无多余引号空格；是否残留了 `ANTHROPIC_API_KEY`
404	`ANTHROPIC_BASE_URL` 是不是多写了 `/v1`，这是本页开头提醒的那一条
`模型不存在`	令牌分组不含该模型，或模型名拼错
改了分组没反应	完全退出 Claude Code 进程再启动

还不行的话：先看服务状态页确认分组是否在上游波动，再按报错原文索引自查，或去 Claude Code 专题。

Claude Code 配置 ​

一、安装 ​

二、配置方式一：环境变量 ​

三、配置方式二：settings.json ​

四、分组建议 ​

五、连通性验证 ​

第一步：不带令牌打端点，期望 401 ​

第二步：带令牌打一次，期望 200 ​

第三步：启动 Claude Code ​

六、验证不通过时的排查顺序 ​

相关页面 ​