HTTP 401 表示请求没有通过认证。4AICode relay 只接受 Authorization: Bearer sk-4ai-... 形式的 Token。
先核对这几项
- 请求头是否存在且拼写正确
Authorization: Bearer sk-4ai-xxxxxxxxxxxxxxxx
不支持把 Key 放在 URL 查询参数，也不要把 Bearer 漏掉。
-
Token 是否完整
- 创建时只显示一次；复制时勿截断。
- 示例占位符
sk-4ai-<your-token>必须整段替换。
-
Token 是否已撤销
- 在控制台撤销后会立即失效，所有请求返回 401。
- 详见 Token 使用。
-
是否用错线路或环境
- Token 在
.com/.net通用，但客户端可能缓存了旧 Key。 - 改完环境变量后请新开终端 / 完全退出 IDE。
- Token 在
-
Claude Code 扩展是否用了错误变量名
- 扩展 2.0+ 更稳妥的是
ANTHROPIC_AUTH_TOKEN，而不是只配ANTHROPIC_API_KEY。 - 见 VS Code / Cursor 指南。
- 扩展 2.0+ 更稳妥的是
常见场景对照
| 场景 | 处理 |
|---|---|
| 刚创建 Token，本地仍 401 | 确认粘贴无空格/换行；重启客户端 |
| 以前可用突然 401 | 是否被撤销、是否换了组织后仍用旧 Token |
| Codex / 脚本 401 | 检查 config.toml / 环境变量是否指向正确 Key |
| 仅某个工具 401 | 该工具可能未读取到环境变量，检查其独立设置页 |
仍然失败时
联系 support@4aicode.com 时请提供：
- 大概时间与所用工具
- 是否新创建/撤销过 Token（不要发送完整 Token）
- 响应里的
trace_id（如有）
完整 Token、密码、验证码请勿发送。