本文用于排查 Claude Code、Codex 和其他客户端在使用卡特 Token 站 API Key 时遇到的认证问题。
不要把完整 API Key 发到聊天、截图、工单或公开仓库。排查时只提供前后几位，例如 sk-abc...xyz。

​
先确认两个基础地址

不同客户端的 Base URL 不一样：
客户端Base URL
Claude Codehttps://api.cutaihub.com
Codexhttps://api.cutaihub.com/v1
如果 Claude Code 加了 /v1，或 Codex 没加 /v1，都可能出现认证失败、404 或请求格式错误。

​
401 Invalid API Key / 无效令牌

常见现象： 
401 invalid api key
401 invalid x-api-key
Unauthorized
Invalid API key
优先检查：
  • API Key 是否复制完整。
  • API Key 是否来自卡特 Token 站。
  • Base URL 是否按客户端要求填写。
  • 是否选错令牌分组。
  • 是否把旧平台的 Key 留在了环境变量或配置文件里。

​
Claude Code 的认证配置

Claude Code 使用 Claude 兼容接口，环境变量应为： 
ANTHROPIC_BASE_URL=https://api.cutaihub.com
ANTHROPIC_AUTH_TOKEN=你的完整API Key
macOS / Linux 检查： 
echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_AUTH_TOKEN
Windows PowerShell 检查： 
echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_AUTH_TOKEN
如果你使用的是配置文件，也要检查 ~/.claude/settings.json 或相关工具写入的配置中是否仍然指向旧地址。
部分教程会使用 ANTHROPIC_API_KEY。如果你的客户端版本或配置工具使用这个变量，请确保它和 ANTHROPIC_AUTH_TOKEN 不互相冲突。

​
Codex 的认证配置

Codex 使用 OpenAI 兼容接口，检查 ~/.codex/config.toml： 
model_provider = "cutai_codex"

[model_providers.cutai_codex]
name = "cutai_codex"
base_url = "https://api.cutaihub.com/v1"
requires_openai_auth = true
再检查 ~/.codex/auth.json： 
{
  "OPENAI_API_KEY": "你的完整API Key"
}
Windows 路径通常是： 
C:\Users\用户名\.codex\config.toml
C:\Users\用户名\.codex\auth.json
macOS / Linux 路径通常是： 
~/.codex/config.toml
~/.codex/auth.json

​
Key 看起来正确但仍然 401

这类问题常见于从网页、PDF、聊天记录或截图 OCR 复制 Key，混入了不可见字符。 macOS / Linux 可以检查是否有异常字符： 
printf '%s' "$ANTHROPIC_AUTH_TOKEN" | cat -A
printf '%s' "$OPENAI_API_KEY" | cat -A
如果结尾出现 ^M、多余空格或其他奇怪字符，请回到卡特 Token 站 API Keys 页面，用复制按钮重新复制完整 Key。 建议：
  • 不要手动输入 Key。
  • 不要从截图 OCR 识别 Key。
  • 不要把 Key 经过富文本、PDF 或翻译工具中转。
  • 环境变量赋值时注意不要带多余空格。

​
403 Missing API Key

常见现象： 
403 Missing API Key
missing authentication
No API key provided
一般说明请求没有带上 Key，或者配置文件被覆盖。 检查方向：
  • Claude Code 是否能读到 ANTHROPIC_AUTH_TOKEN 或实际使用的 Key 变量。
  • Codex 的 auth.json 是否在正确的 .codex 目录。
  • auth.json 是否是合法 JSON。
  • 是否打开了新终端让环境变量生效。
  • IDE 插件、MCP 或配置管理工具是否覆盖了配置。

​
IDE 插件或 MCP 覆盖配置

如果你安装了 Cursor、Continue、MCP 服务器或其他 AI 插件，可能会把 apiKey、baseURL、ANTHROPIC_*、OPENAI_* 配置改回旧值。 排查方式：
  • 暂停相关插件后重试。
  • 重新打开 Claude Code 或 Codex 的配置文件确认地址和 Key。
  • 用「创建和使用 APIKEY」中的配置方式重新写入。
  • 修改配置后关闭整个终端窗口，再重新打开。

​
切换过其他中转服务后持续 401

如果你曾经使用其他中转服务，旧环境变量可能优先级更高，导致新配置不生效。 macOS / Linux 检查： 
env | grep -E 'ANTHROPIC|OPENAI'
检查 ~/.zshrc、~/.bashrc、~/.bash_profile 中是否有旧配置： 
grep -nE 'ANTHROPIC|OPENAI' ~/.zshrc ~/.bashrc ~/.bash_profile 2>/dev/null
Windows 可以在「系统属性 -> 高级 -> 环境变量」里检查用户变量和系统变量，重点看： 
ANTHROPIC_BASE_URL
ANTHROPIC_AUTH_TOKEN
ANTHROPIC_API_KEY
OPENAI_API_KEY
OPENAI_BASE_URL
删除旧配置后，关闭并重新打开终端。

​
OAuth 登录残留导致 API Key 被忽略

Claude Code 如果曾经通过官方 OAuth 登录，可能在本地配置里保留了官方登录令牌，导致请求不走卡特 Token 站。 可以先退出官方登录： 
claude auth logout
然后重新确认： 
echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_AUTH_TOKEN
如果你手动编辑 ~/.claude.json，请先备份，不要直接删除不理解的字段。

​
令牌分组选错

卡特 Token 站创建 API Key 时需要选择分组。分组选错会导致认证通过但请求不可用，或返回权限、模型不可用类错误。 常见规则：
  • Claude Code 请选择支持 Claude Code 或 Claude 兼容请求的分组。
  • Codex 请选择支持 OpenAI 兼容对话或 Codex 的分组。
  • 「GPT生图专用」只用于 GPT 图片生成，不适合 Claude、Codex、GPT 对话或普通聊天请求。
如果不确定，建议新建一个 Key，选择对应客户端可用的分组后重新配置。

​
启动时仍要求登录

如果 Claude Code 或 Codex 启动后仍弹出登录或认证提示：
  • 确认 Key 配置已经写入。
  • 关闭整个终端窗口并重新打开。
  • 确认没有旧 OAuth 登录状态覆盖配置。
  • 确认环境变量没有写到错误的 shell 配置文件。
  • 确认当前终端和你编辑配置的用户是同一个系统用户。

​
排障时提供什么

联系客服时请提供：
  • 客户端：Claude Code、Codex 或其他。
  • 操作系统。
  • 使用的 Base URL。
  • 令牌分组名称。
  • 报错截图或终端文本。
  • API Key 前后几位，例如 sk-abc...xyz。
不要发送完整 API Key。