文档故障排查API 密钥配置错误

API 密钥配置错误

常见表现包括 401、权限拒绝、或“已设置密钥但请求仍失败”。

快速排查

  1. 检查环境变量是否正确:ANTHROPIC_API_KEY
  2. 检查是否被 shell 配置覆盖。
  3. 检查是否在错误环境(本机/容器/CI)中执行。

常见修复

# 当前会话设置
export ANTHROPIC_API_KEY="sk-..."
 
# 验证是否生效
echo $ANTHROPIC_API_KEY | wc -c

预防建议

  • 不把密钥写入仓库
  • 团队统一通过密钥管理平台分发
  • CI 使用专用最小权限 token

相关页面

核心阅读路径

故障页要和配置页、入口页一起看才更完整

很多排错页本身较短,适合把用户自然带回核心配置和入门页,让故障处理路径更完整。

关于我