• 分组：五、技巧玩法 / 工作流套路
• 原始链接：https://support.anthropic.com/en/articles/12304248-managing-api-key-environment-variables-in-claude-code
• 抓取来源：http://support.anthropic.com/en/articles/12304248-managing-api-key-environment-variables-in-claude-code
• 原始文件：/Users/yuanruiqin/Desktop/知识库/ClaudeCode-系统化知识库/05-技巧玩法与工作流/38-managing-api-key-environment-variables-in-claude-code.md
• 精读版生成时间：2026-04-05 13:50:44

中文精读版（去噪）

在 Claude 代码中管理 API 密钥环境变量 |克劳德帮助中心

在 Claude 代码中管理 API 密钥环境变量

使用 Claude Code 时，了解身份验证方法的优先顺序非常重要，以避免意外的 API 费用并确保您使用的是预期的帐户。

身份验证如何工作

Claude Code 优先考虑环境变量 API 密钥而不是经过身份验证的订阅。 这是有意为之的行为，旨在让您能够灵活选择身份验证方法。 当 API 密钥设置为环境变量时，您将使用与该密钥关联的 API 帐户按 API 即用即付费率付费。

最佳实践

要将 Claude Code 与您的 Claude 订阅一起使用： 保持 ANTHROPIC_API_KEY 环境变量未设置。

这可以防止意外的 API 费用，并确保您使用订阅包含的使用量。 如果您偶尔需要使用特定的API密钥，请仅在需要时临时设置。 定期在 Claude Code 中运行 /status 以验证您当前的身份验证方法。

身份验证冲突警告

当经过身份验证的订阅与环境变量 API 密钥之间存在冲突时，Claude Code 会通知您：

1. 在初始设置过程中，如果在您的环境变量中检测到 API 密钥，Claude Code 将要求您确认要使用哪种身份验证方法。

检查当前配置

要验证 API 密钥是否设置为环境变量，请在 Claude Code 中运行 /status。这将显示当前处于活动状态的身份验证方法。

要直接检查环境变量，请在终端（Claude Code 外部）中运行以下命令之一：

macOS/Linux：

回显 $ANTHROPIC_API_KEY

Windows 命令：

回显%ANTHROPIC_API_KEY%

Windows PowerShell：

回声 $env:ANTHROPIC_API_KEY

临时设置API密钥

如果您仅需要对当前终端会话使用 API 密钥：

macOS/Linux：

导出 ANTHROPIC_API_KEY='your-api-key-here'

Windows 命令：

在此处设置 ANTHROPIC_API_KEY=your-api-key

Windows PowerShell：

$env:ANTHROPIC_API_KEY="your-api-key-here"

永久设置 API 密钥环境变量

macOS/Linux：

对于 zsh（macOS 上默认）：

巴什

添加到shell配置文件

echo 'export ANTHROPIC_API_KEY="your-api-key-here"' >> ~/.zshrc

应用更改

源~/.zshrc

对于bash：

巴什

添加到shell配置文件

echo 'export ANTHROPIC_API_KEY="your-api-key-here"' >> ~/.bash_profile

应用更改

源~/.bash_profile

窗户：

1.打开系统属性→高级→环境变量 2. 在“用户变量”下，单击“新建” 3.变量名：ANTHROPIC_API_KEY 4. 变量值：your-api-key-here 5. 单击“确定”并重新启动终端

删除 API 密钥环境变量

macOS/Linux（临时）：

取消设置 ANTHROPIC_API_KEY

macOS（永久）：