Managing API Key Environment Variables in Claude Code
约 3 分钟
加载中...
使用 Claude Code 时，了解身份验证方法的优先顺序非常重要，以避免意外的 API 费用并确保您使用的是预期的帐户。
Claude Code 优先考虑环境变量 API 密钥而不是经过身份验证的订阅。 这是有意为之的行为，旨在让您能够灵活选择身份验证方法。 当 API 密钥设置为环境变量时，您将使用与该密钥关联的 API 帐户按 API 即用即付费率付费。
要将 Claude Code 与您的 Claude 订阅一起使用： 保持 ANTHROPIC_API_KEY 环境变量未设置。
这可以防止意外的 API 费用，并确保您使用订阅包含的使用量。 如果您偶尔需要使用特定的API密钥，请仅在需要时临时设置。 定期在 Claude Code 中运行 /status 以验证您当前的身份验证方法。
当经过身份验证的订阅与环境变量 API 密钥之间存在冲突时，Claude Code 会通知您：
要验证 API 密钥是否设置为环境变量，请在 Claude Code 中运行 /status。这将显示当前处于活动状态的身份验证方法。
要直接检查环境变量，请在终端（Claude Code 外部）中运行以下命令之一：
macOS/Linux：
回显 $ANTHROPIC_API_KEY
Windows 命令：
回显%ANTHROPIC_API_KEY%
Windows PowerShell：
回声 $env
如果您仅需要对当前终端会话使用 API 密钥：
macOS/Linux：
导出 ANTHROPIC_API_KEY='your-api-key-here'
Windows 命令：
在此处设置 ANTHROPIC_API_KEY=your-api-key
Windows PowerShell：
$env
="your-api-key-here"macOS/Linux：
对于 zsh（macOS 上默认）：
巴什
echo 'export ANTHROPIC_API_KEY="your-api-key-here"' >> ~/.zshrc
源~/.zshrc
对于bash：
巴什
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. 单击“确定”并重新启动终端
macOS/Linux（临时）：
取消设置 ANTHROPIC_API_KEY
macOS（永久）：
sed -i '' '/ANTHROPIC_API_KEY/d' ~/.zshrc
源~/.zshrc
Linux（永久）
sed -i '/ANTHROPIC_API_KEY/d' ~/.zshrc
Windows 命令：
设置 ANTHROPIC_API_KEY=
Windows PowerShell：
删除项目环境：ANTHROPIC_API_KEY
Windows（永久）：从系统环境变量设置中删除变量。
在 shell 配置文件中设置环境变量并忘记它们。 更改环境变量后不重新启动终端。 假设您在环境中配置了 API 密钥时正在使用订阅。
如果您有任何疑问，请联系我们的支持团队。
相关文章
API 密钥最佳实践：确保密钥安全在 Pro 或 Max 中使用 Claude Code planClaude Code模型配置Claude Code常见问题解答网络上的克劳德代码
这回答了你的问题吗？
😞😐😃
目录
了解 Claude Code 中的身份验证优先级如何进行身份验证作品最佳实践身份验证冲突警告检查您当前的配置设置 API 密钥暂时设置 API 密钥环境变量永久删除 API 密钥环境变量要避免的常见问题