先确认变量是否存在
很多问题来自 shell 配置文件未加载、变量写错或 VS Code 内置终端未重启。先确认 ANTHROPIC_BASE_URL 指向团队指定的 UUcode 网关地址。
Claude Doctor Fix
用 UUcode 清单修复 ANTHROPIC_BASE_URL 未设置问题
doc.uucode.top 的疑难排查页包含 claude doctor 报 ANTHROPIC_BASE_URL 未设置的场景。这个页面把修复流程整理成适合团队复用的 UUcode 网关检查清单。
- Claude doctor
- Base URL 检查
- 网关排障
再确认 Key 与模型
Base URL 正确后，还要检查 API Key 是否来自 uucode.top、模型名称是否在团队允许列表内，以及 Key 是否仍有额度。
最后查看请求记录
如果本地 claude doctor 通过但调用失败，可以在 UUcode 控制台查看是否有请求进入、是否鉴权失败或是否出现模型路由问题。
01
打印环境变量
在当前终端查看 ANTHROPIC_BASE_URL 和 API Key 是否为预期的 UUcode 配置。
02
重启运行环境
修改 shell 配置后重启终端、Claude Code 或 VS Code 内置终端，避免读取旧变量。
03
对照请求日志
发起一次最小请求，并在 uucode.top 控制台确认请求记录与错误类型。
常见问题
ANTHROPIC_BASE_URL 是什么？
它是 Claude Code 读取的网关地址变量。使用 UUcode 时，应指向团队配置的 UUcode API 中转入口。
为什么重启后才生效？
终端和编辑器通常在启动时读取环境变量，修改 shell 文件后需要重新打开会话。