Claude Code配置与认证常见问题

本文含联盟链接。

Claude Code是当前最火的终端编程助手，但配置过程中的坑比大多数教程愿意承认的要多。我在过去6个月里踩完了ANTHROPIC_API_KEY冲突、OAuth失效、config.json路径问题等5个真实坑，这篇文章是完整的复盘记录。

为什么我的Claude Code一直报401 Invalid bearer token

这是最近遇到最多的报错。报错表现：

Error: 401 Invalid bearer token

原因可能有三种：

1. 环境变量ANTHROPIC_API_KEY与订阅账户冲突

根据Anthropic官方文档，当ANTHROPIC_API_KEY环境变量被设置时，Claude Code会优先使用API按量付费模式，而非订阅账户。这意味着如果你有Max订阅但同时设置了API Key，系统会默认走API账户计费。

解决方法：

# 查看当前认证状态
claude /status

# 清除环境变量，使用订阅登录
unset ANTHROPIC_API_KEY
claude login

2. OAuth令牌过期（2026年4月6日大规模故障）

2026年4月6日，Claude Code发生了一次大规模OAuth令牌过期事件，大量用户同时遇到认证失败。官方状态页后来承认了问题，但从出现问题到官方确认花了数小时。

这次事件暴露了一个关键风险：如果你依赖OAuth登录而非API Key，Anthropic服务宕机会直接让你的Claude Code无法使用。

建议：配置备用认证方案。

3. GitHub Issue #10503: Token存储损坏

GitHub上有人报告了"Invalid bearer token persists after login"的bug——即使用户重新登录，令牌验证仍然失败。这是客户端侧令牌存储损坏导致的。

解决方法：

# 清除Claude Code本地缓存并重新登录
rm -rf ~/.claude
claude login

config.json的坑：路径、权限、环境变量优先级

坑1：config.json路径在哪里

Claude Code的配置文件夹位置因操作系统而异：

• macOS/Linux: `~/.claude/`
• Windows: `%USERPROFILE%\.claude\`

主要的settings.json在~/.claude/settings.json（macOS/Linux）或%USERPROFILE%\.claude\settings.json（Windows）。

但还有一个全局配置文件：~/.claude.json（用户根目录），这个文件优先级高于~/.claude/settings.json。如果你发现改了settings.json没效果，检查一下是否有.claude.json在作怪。

坑2：环境变量优先级覆盖config.json

Claude Code的环境变量优先级非常明确：

• 环境变量（如`ANTHROPIC_API_KEY`）> config.json中的设置 > 默认值

这意味着即使你在config.json里设置了API Key，环境变量中的同名变量会直接覆盖它。

验证方法：

# 查看当前所有Claude相关环境变量
env | grep -i anthropic
env | grep -i claude

坑3：config.json格式错误导致静默失败

如果settings.json格式错误（比如多了一个逗号或引号），Claude Code会静默忽略整个配置文件而不报错。常见错误：

// 错误：尾随逗号
{
  "mcpServers": {},
  "hooks": {},  // ← 尾随逗号
}

// 正确：不能有尾随逗号
{
  "mcpServers": {},
  "hooks": {}
}

ANTHROPIC_API_KEY vs OAuth：认证方式选择的实战建议

API Key模式适合：

• 需要严格控制成本（按token计费，可设限额）
• 需要使用Claude Max（$100/月+按量）套餐
• 需要对接第三方Claude API提供商

OAuth/订阅模式适合：

• 使用Claude Pro/Himax订阅（$30/$100/月）
• 不希望手动管理API额度
• 需要访问Anthropic最新模型（某些模型仅限订阅）

2026年4月事件后的教训：

不能把OAuth订阅作为唯一认证入口。推荐配置：

# 主认证：OAuth订阅
# 备用：API Key（确保至少一个可用）
export ANTHROPIC_API_KEY='sk-ant-......'
export ANTHROPIC_BASE_URL='https://api.anthropic.com'

进阶配置：Bedrock/Mantle路由与环境变量

如果你通过AWS Bedrock或Mantle使用Claude Code，需要配置额外的环境变量：

# AWS Bedrock路由
export CLAUDE_CODE_USE_BEDROCK=1
export AWS_REGION='us-east-1'

# Mantle路由（v2.1.94+）
export CLAUDE_CODE_USE_MANTLE=1

# 跳过Mantle认证刷新（调试用）
export CLAUDE_CODE_SKIP_MANTLE_AUTH=1

这些路由选择会影响认证token的刷新逻辑。如果你在使用Bedrock时遇到认证问题，首先检查region是否正确。

总结：避免认证陷阱的检查清单

• [ ] 运行`claude /status`确认当前认证状态
• [ ] 检查环境变量：`env | grep -i anthropic`
• [ ] 确认config.json无格式错误（无尾随逗号）
• [ ] 主认证失效时，确保有备用API Key
• [ ] 如果遇到持续401错误，尝试清除本地缓存：`rm -rf ~/.claude && claude login`

👉 如果你在找更强大的本地AI编程环境，推荐了解MiniMax的API服务，搭配Ollama可以构建完整的本地AI编程助手生态。

👉 立即体验MiniMax API >>

---

📌 This article was AI-assisted generated and human-reviewed | TechPassive — An AI-driven content testing site focused on real tool reviews