小工具

Claude Code 配置生成器:按系统生成环境变量与 settings.json

填入端点地址和 Key,选择 macOS、Linux、Windows PowerShell 或 CMD,自动生成 Claude Code 的临时配置、永久配置、settings.json 片段和一条 curl 验证命令。会检查地址里多写的 /v1、Key 首尾混入的空格换行等常见错误。全部在浏览器本地计算,不上传。

核实于 2026-11-03 · 更新于 2026-11-03
一句话结论

Claude Code 接第三方端点只需要两个值:ANTHROPIC_BASE_URL(端点根地址)和 ANTHROPIC_AUTH_TOKEN(Key)。先用「临时生效」那段在当前窗口验证,能用了再选「永久生效」或写进 settings.json。

生成的变量名与请求头对应关系已在 Claude Code 2.1.312 实测(2026-11-03):ANTHROPIC_AUTH_TOKEN 发 Authorization: Bearer,ANTHROPIC_API_KEY 发 x-api-key;Claude Code 会在 Base URL 后自动拼接 /v1/messages。

填服务方给的根地址,不要带 /v1 或 /v1/messages,Claude Code 会自己补上。
① 临时生效(只对当前窗口,先用它验证)

          
② 永久生效(之后新开的窗口都能读到)

          
③ 或者写进 settings.json(所有入口通用,含 IDE 插件)

          
④ 验证命令(绕过 Claude Code,直接看服务端返回)

        

四段输出分别什么时候用

输出 作用范围 适合
① 临时生效 只对当前终端窗口,关掉就没了 第一次配置,先确认能用
② 永久生效 之后新开的终端都能读到 确认能用之后,只在终端里用 Claude Code
③ settings.json Claude Code 所有入口,包括 VS Code、JetBrains 插件 在 IDE 里用,或者不想改系统环境变量
④ 验证命令 不经过 Claude Code,直接请求端点 Claude Code 报错时,判断问题出在本地配置还是端点、Key

②和③选一个就够了。两处都写而且值不一样时,排查起来很麻烦。

生成器会帮你检查的几个错误

  • 地址多写了 /v1:Claude Code 实测会在 Base URL 后面自己拼 /v1/messages。地址写成 https://xxx/v1,实际请求就变成 /v1/v1/messages,结果是 404。
  • Key 首尾有空格或换行:从网页或聊天软件复制时最常见。Claude Code 会把它原样发出去,服务端判定为无效 Key。
  • Windows 用 setx 后当前窗口不生效:setx 只影响之后新开的窗口,生成的命令里加了提醒。
  • zsh 和 bash 写错文件:macOS 默认是 zsh,配置要写进 ~/.zshrc,写进 ~/.bashrc 不会生效。

两个变量选哪个

生成器默认用 ANTHROPIC_AUTH_TOKEN。实测两者的区别只在请求头:前者发 Authorization: Bearer,后者发 x-api-key。服务方文档写哪个就用哪个;两种都支持的话,选哪个都可以,但只设一个。

Key 会不会泄露

不会离开你的浏览器。这个页面没有任何把输入发往服务器的代码,所有拼接都在本地 JavaScript 里完成。不放心可以把 Key 留空,生成后再手动替换占位符。

常见问题

配好之后 Claude Code 还提示 Not logged in?

先看报错出现得快不快。1 秒内出现说明变量没被读到,检查是不是在同一个窗口、是不是写错了配置文件;等了几分钟才出现说明 Key 被服务端拒绝,用第④段命令看具体原因。详见 Not logged in 排查。

settings.json 已经有内容了怎么办?

只把 env 里的几行合并进去,不要整个覆盖。文件里如果已经有 env 对象,就把这几个键加到原有的 env 里。

API_TIMEOUT_MS 要不要设?

网络稳定时不用设。经常在长任务中途报超时,可以适当调大。这个值只影响等待单次响应的时长,不会让请求变快。