401 Invalid Authentication - Claude Code

Quick fix

检查当前供应商要求的认证变量和 API Key，并确认 Claude Code 实际读取的认证字段已填入正确密钥。

Symptom

报错原文复制

API Error: 401 {"error":{"type":"authentication_error","message":"Invalid Authentication"},"type":"error"}

Cause

这些 issue 都表现为 401 authentication_error，但原因并不完全相同：Kimi For Coding 的报告涉及认证变量或字段不匹配，例如使用 `ANTHROPIC_API_KEY` 而非 `ANTHROPIC_AUTH_TOKEN`，或密钥只写入顶层 `apiKey`、而 `env.ANTHROPIC_AUTH_TOKEN` 仍为空。MiniMax 和 OpenCode Zen 的报告则涉及 Coding Plan 密钥、供应商区域或请求地址配置。部分用户报告中，CC Switch 的连通性检查成功，但 Claude Code 发请求仍返回 401。

issue #1046 报告原生版 Claude Code 未读取 `~/.claude/settings.json`，但维护者表示无法在最新版复现，并建议参考 issue #404。现有材料没有给出适用于所有这些情况的单一修复；应先按所用供应商核对密钥类型、认证字段和请求地址。

Fix

1. 1

   核对供应商要求的 API Key 类型及认证字段。Kimi For Coding 用户报告使用 `ANTHROPIC_API_KEY` 可解决 401；另一个报告发现 Claude Code 实际读取的是 `env.ANTHROPIC_AUTH_TOKEN`，且该字段为空时会认证失败。

2. 2

   如果 Kimi For Coding 配置同时有顶层 `apiKey` 和空的 `env.ANTHROPIC_AUTH_TOKEN`，将密钥填入 `env.ANTHROPIC_AUTH_TOKEN`；或删除旧配置后用内置预设重新创建。完成后重启 Claude Code。

   // ~/.claude/settings.json
   {
     "env": {
       "ANTHROPIC_AUTH_TOKEN": "<你的 API Key>"
     }
   }

3. 3

   MiniMax 用户确认使用与订阅对应的 Coding Plan Key，并检查所选区域对应的供应商配置；issue 评论中有用户通过选择 MiniMax en 预设解决，也有用户通过调整请求地址解决。

4. 4

   OpenCode Zen 用户报告可通过启用代理并按接口格式配置请求地址解决；OpenAI Chat Completions 格式的示例需包含 `/v1/chat/completions`。

Affected Versions

ToolClaude Code / OpenCode

Version未知

PlatformsWindowsmacOS

Source Issues

本页汇总自 7 个真实 issue

• #185kimi的ANTHROPIC_BASE_URL不是https://api.moonshot.cn/anthropic
• #219在claude code中配置了kimi-for-coding 对应信息提示401
• #544Macos minimax not working
• #879Windows 11 Claude 自定义配置 OpenCode Zen 的免费模型，报错。
• #890添加MiniMax报错401。API Error: 401{"type":"error","error":{"type":"authentication_error","message":"invalid api key"},"request_id":""} · Please run /login
• #1046[Bug] cc-switch 配置不生效于原生版 Claude Code (v2.1.42+)
• #2525[Bug] Kimi For Coding preset writes API key to apiKey field but leaves env.ANTHROPIC_AUTH_TOKEN empty, causing 401 in Claude Code

FAQ

CC Switch 测速成功，为什么 Claude Code 仍然返回 401？

issue #2525 报告中，CC Switch 使用顶层 `apiKey` 测速成功，但 Claude Code 读取的 `env.ANTHROPIC_AUTH_TOKEN` 为空，因此请求仍返回 401。

Kimi For Coding 应该使用哪个认证变量？

issue #219 的用户报告称，改用 `ANTHROPIC_API_KEY` 后解决了 401；issue #2525 则指出其 Claude Code 配置从 `env.ANTHROPIC_AUTH_TOKEN` 读取密钥。请核对实际配置中的认证字段是否有值。

MiniMax 应该使用什么 API Key？

issue 评论建议使用 Coding Plan Key；有用户提到英文站订阅应选择 MiniMax en 预设。不同报告中的处理方式不一致，请核对密钥与所选预设、区域是否对应。

原生版 Claude Code 不生效怎么办？

issue #1046 报告原生版可能未读取 `~/.claude/settings.json`，但维护者称最新版无法复现，并建议参考 issue #404；该 issue 未提供可在此确认的通用修复。

相关问题

Missing API key.：Claude Desktop OpenCode Go将上游认证字段从 ANTHROPIC_AUTH_TOKEN 改为 ANTHROPIC_API_KEY，使请求通过 x-api-key 发送。4 issues mergedInvalid schema for function — Codex将 CC Switch 升级至包含 v3.18.0 修复的版本可解决 `parameters.type:null` 变体；其他 `null` schema 变体仍需跟踪原帖。13 issues mergedinvalid_authentication_error 测试失败 HTTP 401用量查询脚本的 {{apiKey}} 变量未被替换导致 401，升级 cc-switch 到最新版即可，临时可改用硬编码 Key。3 issues merged