正在打开页面…
正在加载内容，请稍候。
Claude Code API Key 报错先保存完整错误正文，检查 CLI 当前读取的令牌、网关地址和登录状态。401 针对鉴权，模型权限与用量错误另行处理；更换 Key 后重新启动实际运行的进程再验证。
Claude Code API Key 报错通常是以下原因之一：API Key 未正确设置、Base URL 配置有误、环境变量未生效、网络连接问题或模型名称/权限不匹配。按本文提供的步骤逐一排查，大部分问题可以在几分钟内解决。
Claude Code 中最常见的报错包括：Invalid API Key · Please run /login（API Key 未检测到）、Authentication Failed（认证失败）、fetch failed（网络连接失败）、Model not found（模型不存在或无权限）。每种报错的原因不同，需要分别排查。
首先确认 API Key 是否以 sk- 开头。apizt 的 API Key 在控制台的 API 令牌页面创建。常见错误包括：复制时漏掉了前几位字符、多了空格、或者使用了其他平台的 Key。建议重新复制一次完整的 Key。
Claude Code 使用 apizt 时，ANTHROPIC_BASE_URL 应设置为 https://api.apizt.com（注意：不带 /v1，不带尾部斜杠）。如果 Base URL 配置错误（例如多加了 /v1），会导致请求发送到错误的地址。
环境变量设置后只在当前终端会话中生效。如果关闭终端后重新打开，需要重新设置。建议使用永久配置方式（如写入 .bashrc、.zshrc 或 Windows 系统环境变量）。可以在终端中运行 test -n "$ANTHROPIC_AUTH_TOKEN" && echo "ANTHROPIC_AUTH_TOKEN is set"（macOS/Linux）或 IF DEFINED ANTHROPIC_AUTH_TOKEN (echo ANTHROPIC_AUTH_TOKEN is set)（Windows CMD）来验证变量是否设置成功，此方式不会显示完整密钥。
三个系统的环境变量设置方式不同。macOS/Linux 使用 export 命令，Windows PowerShell 使用 $env: 前缀，Windows CMD 使用 set 命令。请确保使用正确的语法。另外，PowerShell 中字符串需要用双引号包裹，而 CMD 中不需要引号。
如果报错信息是 fetch failed 或连接超时，可能是网络问题。建议检查：1）网络是否正常；2）是否需要设置代理；3）设置 API_TIMEOUT_MS=300000 增加超时时间。使用 apizt 时，国内网络通常可以直接访问，无需额外代理。
确认使用的模型名称在 apizt 控制台中是否可用。创建令牌时，建议选择 Claude Code 专属分组或官转克劳德分组。如果模型名称拼写错误或令牌没有该模型权限，会返回 Model not found 或权限错误。
逐一运行以下命令验证：1）test -n "$ANTHROPIC_AUTH_TOKEN" && echo "ANTHROPIC_AUTH_TOKEN is set"（macOS/Linux）或 IF DEFINED ANTHROPIC_AUTH_TOKEN (echo ANTHROPIC_AUTH_TOKEN is set)（Windows CMD）— 确认变量已设置；2）echo $ANTHROPIC_BASE_URL — 确认输出为 https://api.apizt.com（不带 /v1）；3）echo $API_TIMEOUT_MS — 确认输出为 300000。如果任一命令输出为空，说明对应的环境变量未设置。
按以下顺序排查：1）确认 API Key 以 sk- 开头且完整复制；2）确认 ANTHROPIC_BASE_URL 为 https://api.apizt.com（不带 /v1）；3）确认环境变量在当前终端会话中已生效；4）设置 API_TIMEOUT_MS=300000；5）检查网络连接；6）确认模型名称和令牌分组权限正确。
根据目标协议与型号核对后使用。
# macOS / Linux
export ANTHROPIC_AUTH_TOKEN=sk-xxx
export ANTHROPIC_BASE_URL=https://api.apizt.com
export API_TIMEOUT_MS=300000
claude
# Windows PowerShell
$env:ANTHROPIC_AUTH_TOKEN="sk-xxx"
$env:ANTHROPIC_BASE_URL="https://api.apizt.com"
$env:API_TIMEOUT_MS="300000"
claude
# Windows CMD
set ANTHROPIC_AUTH_TOKEN=sk-xxx
set ANTHROPIC_BASE_URL=https://api.apizt.com
set API_TIMEOUT_MS=300000
claude记录状态码、错误正文和请求时间
按下方检查项逐个排除，不同时修改多项
用同一请求验证，再回到原工具测试
检查目标地址与令牌是否匹配、Key 是否已禁用，以及用户或项目配置和旧登录状态是否覆盖了环境设置。在同一 Shell 重启 CLI，再看平台对应请求记录。
通常先检查鉴权与配置，无需把重装作为第一步。记录 claude --version、失败时间、错误正文和脱敏设置，逐项修复；只有安装或版本问题才处理安装层。
检查 ANTHROPIC_AUTH_TOKEN 环境变量是否设置正确。在终端中运行 test -n "$ANTHROPIC_AUTH_TOKEN" && echo "ANTHROPIC_AUTH_TOKEN is set" 确认变量已设置。如果未输出提示，说明环境变量未生效，需要重新设置。
环境变量只在当前终端窗口生效。如果你在新的终端窗口运行 Claude Code，需要重新设置。建议将配置写入 .bashrc 或 .zshrc 实现永久生效。
记录版本与完整提示，区分 CLI 显示状态、网络检测和实际模型请求结果。用新会话的有效返回与平台记录验证，不能仅凭 offline 字样认定无影响或已经可用。
在终端中运行 echo $ANTHROPIC_BASE_URL 确认输出为 https://api.apizt.com。注意不要带 /v1 后缀，不要带尾部斜杠。
PowerShell 使用 $env: 前缀和双引号：$env:ANTHROPIC_AUTH_TOKEN="sk-xxx"。CMD 使用 set 命令且不需要引号：set ANTHROPIC_AUTH_TOKEN=sk-xxx。两者不要混用。
401 表示认证失败，请检查 API Key 是否正确、Authorization Header 格式是否为 Bearer sk-xxx。404 表示请求路径不存在，请确认 ANTHROPIC_BASE_URL 是否正确设置为 https://api.apizt.com（不带 /v1，不带尾部斜杠）。
先按上文检查地址、鉴权与协议，并完成复测。确认要使用 apizt 后，再创建 API Key、选择模型并配置工具；充值不能修复配置错误。
在控制台创建令牌，选择需要使用的模型权限。
按工具要求填写 API Key、接口地址与模型 ID。
确认收到有效结果，再到控制台查看用量与费用。