在本地开发环境中使用 Claude Code 时，正确配置环境变量是确保其能够顺利调用 Anthropic API 并执行代码任务的关键步骤。许多开发者在初次安装后遇到认证失败或权限错误，往往是因为未将必要的密钥信息注入到系统的环境变量中。本文将通过清晰的步骤清单，指导您如何在主流操作系统上完成这一核心配置，从而解锁 Claude Code 的全部功能。
准备工作：获取必要的 API 密钥
在开始任何技术操作之前，您需要拥有一个有效的 Anthropic API 密钥。这是 Claude Code 与云端模型进行通信的唯一凭证。请登录 Anthropic 控制台，导航至“API Keys”页面，创建一个新的密钥。请务必妥善保存该密钥，因为它只会显示一次。切勿将密钥硬编码在脚本中或通过明文形式分享，以确保账户安全。获得密钥后，我们将进入具体的环境配置环节。
Linux 和 macOS 系统配置步骤
对于基于 Unix 的系统，环境变量通常存储在 shell 的配置文件中。以下是针对常用 Shell 的具体操作指南：
1. 确定您的 Shell 类型
大多数现代 macOS 用户默认使用 Zsh，而 Linux 用户可能使用 Bash 或 Zsh。您可以通过在终端输入 echo $SHELL 来确认当前使用的 Shell 路径。如果输出包含 zsh，则对应配置文件为 .zshrc；如果包含 bash，则为 .bashrc 或 .bash_profile。
2. 编辑配置文件
打开终端，使用文本编辑器（如 nano 或 vim）编辑相应的隐藏配置文件。例如，在 Zsh 环境下，执行以下命令：
nano ~/.zshrc
3. 添加环境变量
在文件末尾添加以下行，将您的实际 API 密钥替换占位符：
export ANTHROPIC_API_KEY="your_actual_api_key_here"
如果您需要自定义基础 URL 或其他高级参数，也可以在此处添加相应的导出语句，如 export CLAUDE_CODE_BASE_URL="..."。
4. 使配置生效
保存文件并退出编辑器后，运行 source ~/.zshrc（或对应的 bash 配置文件名称）以立即加载新设置。此时，您可以在终端中输入 echo $ANTHROPIC_API_KEY 来验证变量是否已成功设置。如果返回了正确的密钥字符串，则配置成功。
Windows 系统配置步骤
Windows 用户的配置过程主要通过图形界面完成，这为不熟悉命令行操作的用户提供了便利：
1. 访问系统环境变量设置
按下 Win + R 键打开运行窗口，输入 sysdm.cpl 并回车，打开“系统属性”。切换到“高级”选项卡，点击底部的“环境变量”按钮。
2. 新建用户变量
在“用户变量”区域（而非系统变量，以避免影响其他用户），点击“新建”。变量名填写 ANTHROPIC_API_KEY，变量值粘贴您的 API 密钥。点击“确定”保存。
3. 重启终端应用
为了使更改生效，您需要关闭所有已打开的 CMD、PowerShell 或 VS Code 终端窗口，然后重新打开。这确保了新的环境变量被加载到当前的会话中。
验证与故障排除
配置完成后，建议运行一个简单的测试命令来验证 Claude Code 是否能识别您的密钥。在终端中直接输入 claude 并回车，如果它成功启动并等待您的指令，说明环境变量配置无误。若出现认证错误，请检查以下几点：首先，确认密钥中没有多余的空格或换行符；其次，确保您使用的是最新版本的 Claude Code；最后，检查网络连接是否正常，以及 Anthropic 服务状态是否稳定。通过遵循上述步骤，您可以建立一个稳定、安全的开发环境，充分发挥 AI 辅助编程的效率。
本文链接：https://ai-claudecode.cn/gpt/claude-codehjblpzzn-claude-codesz/