当使用的凭据优先级高于你的 claude.ai 登录时,Claude Code 会在启动时打印此行,例如使用 ANTHROPIC_AUTH_TOKEN、ANTHROPIC_API_KEY 或 apiKeyHelper 脚本。会话使用该凭据运行,模型请求照常处理。不会加载的是你在 claude.ai 添加的连接器;Remote Control 和 /schedule 也会停用。如果你本来不打算使用密钥,请查明它的设置位置:通常它位于 ~/.claude/settings.json 的 env 块中,在 shell 中执行 unset 无法清除它。如果你本来就打算使用它,则没有任何问题。
错误
claude.ai connectors are disabled because ANTHROPIC_API_KEY or another auth source is set and
takes precedence over your claude.ai login. Unset it to load your organization's connectors.
# Printed at startup. ANTHROPIC_API_KEY is only the line's example: the credential
# in use can be ANTHROPIC_AUTH_TOKEN, an apiKeyHelper script or another source.
# /status names it.原因和解决方法一览
| 原因 | 解决方法 |
|---|---|
| ~/.claude/settings.json 的 env 块中的 ANTHROPIC_AUTH_TOKEN 或 ANTHROPIC_API_KEY | 从文件中删除它;如果 ANTHROPIC_BASE_URL 指向网关,也一并删除。仅在 shell 中取消设置无法清除这些配置。 |
| shell 配置文件中的导出设置,例如 ~/.zshrc 或 ~/.bashrc | 删除该导出设置,打开一个新终端,然后运行 /status。 |
| apiKeyHelper 设置,或写入这些变量的提供商切换工具 | 移除 apiKeyHelper,或将该工具切回你的 claude.ai 账户。 |
| 你原本是想通过网关或使用 API 密钥运行 Claude Code | 无需修复。需要使用连接器时,请在不设置密钥和网关的 ANTHROPIC_BASE_URL 的情况下启动会话。 |
理解这行提示:正在使用密钥,但没有使用连接器
存在多个凭据时,Claude Code 按以下顺序使用其中一个:设置了 CLAUDE_CODE_USE_BEDROCK、CLAUDE_CODE_USE_VERTEX 或 CLAUDE_CODE_USE_FOUNDRY 时使用云服务提供商凭据;然后依次是 ANTHROPIC_AUTH_TOKEN、ANTHROPIC_API_KEY、apiKeyHelper 脚本、CLAUDE_CODE_OAUTH_TOKEN、Anthropic 配置文件和联合身份凭据;最后是通过 /login 登录的订阅账户(https://code.claude.com/docs/en/authentication#authentication-precedence,核查日期:2026 年 11 月 14 日)。只有在使用订阅登录作为身份验证方式时,才会获取在 claude.ai 添加的连接器。因此,只要设置了优先级更高的凭据,Claude Code 就不会加载这些连接器,即使你之前运行过 /login 也是如此(https://code.claude.com/docs/en/mcp#use-mcp-servers-from-claude-ai)。此处这一行中的 ANTHROPIC_API_KEY 仅为示例。Claude Code 于 2026 年 5 月 11 日发布的 2.1.139 版本更新日志列出了四项在设置了 ANTHROPIC_API_KEY、ANTHROPIC_AUTH_TOKEN 或 apiKeyHelper 时会关闭的功能,即使已登录 claude.ai 也一样:claude.ai 连接器、Remote Control、/schedule 和通知偏好设置。模型请求会通过当前使用的凭据发送,不受影响。
查明凭据的设置位置
在 Claude Code 中运行 /status:它会显示当前使用的身份验证方式。然后检查凭据可能来自哪些位置。shell 配置文件中导出的变量会传递到每个终端。设置文件 env 块中的变量由 Claude Code 在每次启动时应用,因此在 shell 中运行 unset 不会产生任何影响。2026 年 11 月 9 日 anthropics/claude-code#108528 报告的就是这种情况:取消设置后,该行仍显示 ANTHROPIC_API_KEY,而实际使用的凭据是 ~/.claude/settings.json 的 env 块中的 ANTHROPIC_AUTH_TOKEN。用于在提供商之间切换 Claude Code 的工具会将 ANTHROPIC_BASE_URL 和令牌写入同一个块中;apiKeyHelper 则是单独的设置项。
# In Claude Code, run /status first: it names the method in use.
# Exported in this shell? (prints the names, not the values)
env | grep -oE '^ANTHROPIC_(API_KEY|AUTH_TOKEN|BASE_URL)='
# Set by a settings file (user, project, local)?
grep -noE 'ANTHROPIC_(API_KEY|AUTH_TOKEN|BASE_URL)|apiKeyHelper' \
~/.claude/settings.json .claude/settings.json .claude/settings.local.json 2>/dev/null
# Exported by a shell startup file?
grep -noE 'ANTHROPIC_(API_KEY|AUTH_TOKEN|BASE_URL)' \
~/.zshenv ~/.zprofile ~/.zshrc ~/.bash_profile ~/.bashrc ~/.profile 2>/dev/null二选一:使用带连接器的 claude.ai 登录,或使用密钥
要恢复连接器,请移除你找到凭据的位置:环境变量块中的那一行、配置文件中的 export,或 apiKeyHelper 键。如果旁边设置了 ANTHROPIC_BASE_URL 且它指向网关,也请一并移除:只留下基础 URL 时,Claude Code 会使用你的 claude.ai 登录,但仍会携带该登录的令牌,将请求发送到网关,而且 Remote Control 仍会关闭(https://code.claude.com/docs/en/llm-gateway#subscriptions-and-gateways)。打开新的终端,启动 Claude Code,运行 /login 并选择你的 claude.ai 账户;随后 /mcp 会列出 claude.ai 连接器。若要继续使用密钥、网关、团队密钥或按令牌计费,请保留该设置:这一行是信息说明,不是错误。若要同时使用两种方式,请勿将密钥和 ANTHROPIC_BASE_URL 放在 settings.json 中,而只在需要它们的会话中设置,如下所示。这样,直接运行 claude 时就会使用你的订阅,将请求发送到 Anthropic,并加载连接器。你自行通过 claude mcp add 或项目的 .mcp.json 添加到 Claude Code 的 MCP 服务器不属于 claude.ai 连接器,因此不受此规则限制。如果你从不使用连接器,可在设置中将 disableClaudeAiConnectors 设为 true,或在某个 shell 会话中以 ENABLE_CLAUDEAI_MCP_SERVERS=false 启动 Claude Code,这样 Claude Code 就会停止获取这些连接器(https://code.claude.com/docs/en/mcp#disable-claude-ai-connectors)。
# A second command for gateway sessions. Plain `claude` keeps your
# claude.ai login, talks to Anthropic and loads its connectors;
# `kclaude` runs on the Kunavo key. Neither variable is in settings.json.
export KUNAVO_API_KEY="sk-kn-..." # your key; Claude Code never reads this name
kclaude() {
ANTHROPIC_BASE_URL=https://api.kunavo.com \
ANTHROPIC_AUTH_TOKEN="$KUNAVO_API_KEY" \
claude "$@"
}
# Add the model variables from the Claude Code integration guide the same way.如果你通过 Kunavo 调用
通过 Kunavo 使用 Claude Code 时,设置的正是这类凭据:Kunavo 的 Claude Code 配置会使用 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN,并将其导出以供当前会话使用,或保存在 ~/.claude/settings.json 的 env 块中。如果你也登录了 claude.ai 账户,Claude Code 会在启动时打印这行提示。这是预期行为:会话使用你的 Kunavo 密钥运行,模型请求按令牌计费,并从你的 Kunavo 余额扣除。在这些会话中,你无法使用 claude.ai 连接器、Remote Control 或 /schedule。如果你两种方式都要用,请像最后一步所示,在每次启动时设置 Kunavo 变量,而不要将它们放在 settings.json 中;订阅会话则直接运行 claude。关于 Claude Code 如何连接 Kunavo,请参阅 Claude Code 集成指南。
常见问题
“由于设置了 ANTHROPIC_API_KEY 或其他身份验证来源,claude.ai 连接器已停用”是什么意思?
Claude Code 检测到一个优先级高于你的 claude.ai 登录的凭据,例如 ANTHROPIC_AUTH_TOKEN、ANTHROPIC_API_KEY 或 apiKeyHelper 脚本,并在会话中使用该凭据。只有在使用 claude.ai 登录作为身份验证方式时,才会加载你在 claude.ai 添加的连接器,因此 Claude Code 会跳过它们。会话本身仍可正常运行。
我取消设置了 ANTHROPIC_API_KEY,但提示仍然存在。为什么?
另一个来源仍在设置凭据。常见情况是 ~/.claude/settings.json 的 env 块:Claude Code 会在每次启动时应用其中的内容,因此在 shell 中执行 unset 不会影响它。即使实际使用的凭据是 ANTHROPIC_AUTH_TOKEN 或 apiKeyHelper,这行提示里写的也是 ANTHROPIC_API_KEY。运行 /status 查看当前使用的身份验证方式,然后检查 settings.json、shell 配置文件和 apiKeyHelper。
这条提示是否意味着我的 API 密钥或网关出了问题?
不,这表示密钥正在使用中。模型请求会发送到该凭据对应的端点和账户,并在那里计费。该会话中关闭的是需要 claude.ai 登录的功能:claude.ai 连接器、Remote Control、/schedule、通知偏好设置和语音听写。
我能否在同一个会话中同时使用 claude.ai 连接器和 API 密钥?
不会。只有在使用 claude.ai 订阅登录作为身份验证方式时,Claude Code 才会获取连接器。请保留两套配置:仅在需要密钥和 ANTHROPIC_BASE_URL 的会话中设置它们;需要使用连接器时,则在两者都未设置的情况下启动 Claude Code。你直接添加到 Claude Code 中的 MCP 服务器不受此规则限制,但某些由 Anthropic 托管的连接器,例如 Gmail、Google Calendar 和 Microsoft 365,只能通过 claude.ai 连接。
如何彻底阻止 Claude Code 获取 claude.ai 连接器?
在任意设置文件中将 disableClaudeAiConnectors 设为 true,或在当前 shell 中以 ENABLE_CLAUDEAI_MCP_SERVERS=false 启动 Claude Code。这样 Claude Code 就会停止获取原本会从 claude.ai 加载的连接器。