在本地开发环境中使用 Claude Code 时，正确配置环境变量是确保其能够顺利调用 Anthropic API 并执行代码任务的关键步骤。许多开发者在初次接触这款 AI 编程代理工具时，往往因为缺乏必要的凭证信息而遇到连接失败或权限不足的问题。本文将详细解析如何在主流操作系统中完成 Claude Code 的环境变量设置，帮助读者快速搭建稳定、高效的工作流。
核心环境变量与获取方式
Claude Code 的运行依赖于一个至关重要的环境变量：ANTHROPIC_API_KEY。这个变量存储了访问 Anthropic 服务的认证令牌。如果没有设置该变量，Claude Code 将无法验证用户身份，进而拒绝执行任何代码生成、解释或修改请求。
获取此密钥的方法非常直观。首先，你需要拥有一个有效的 Anthropic 账户，并已开通相应的 API 服务权限。登录 Anthropic 控制台后，导航至“API Keys”页面，点击创建新密钥。系统会生成一串以 sk-ant- 开头的长字符串，请务必立即复制并妥善保存，因为出于安全考虑，一旦关闭页面后将无法再次查看完整内容。这串密钥就是你的“通行证”，必须严格保密，切勿将其提交到公开的代码仓库中。
Linux 与 macOS 环境配置实战
对于大多数使用 Unix-like 系统的开发者而言，通过命令行临时或永久设置环境变量是最常见且推荐的做法。临时设置适合测试场景，只需在当前终端会话中输入以下命令：
export ANTHROPIC_API_KEY="你的密钥在这里"
这种方式在关闭终端窗口后即失效，不会污染全局配置。若希望永久生效，则需要将上述导出语句添加到你的 shell 配置文件（如 .bashrc、.zshrc 或 .profile）中。编辑完成后，运行 source ~/.zshrc（以 Zsh 为例）使配置即时生效。你可以使用 echo $ANTHROPIC_API_KEY 来验证变量是否已成功加载。这种配置方式确保了在任何目录下启动 Claude Code 都能自动识别凭证，极大地提升了操作便利性。
Windows 及跨平台替代方案
Windows 用户可以通过图形界面或 PowerShell 进行设置。在 PowerShell 中，可以使用 $env:ANTHROPIC_API_KEY = "你的密钥" 进行临时设置，或者修改用户级别的环境变量以实现永久存储。此外，考虑到项目隔离的需求，许多开发者倾向于使用 .env 文件管理敏感信息。虽然 Claude Code 原生主要依赖系统级环境变量，但结合 dotenv 等库或在项目根目录放置 .env 文件，并在启动脚本中预加载，也是一种常见的工程化实践。无论采用何种方式，核心原则都是确保 ANTHROPIC_API_KEY 在 Claude Code 进程启动前已被正确注入到运行环境中，从而保障 AI 辅助编程的流畅体验。
本文链接：https://ai-claudecode.cn/DeepSeek/claude-codehjblszzn-claude-codepz/
