在开发过程中，安全且高效地管理 API 密钥是每位工程师的必修课。对于使用 Anthropic 旗下 AI 编程助手 Claude Code 的用户而言，正确配置命令行环境变量不仅是启动工具的前提，更是保障凭证安全、避免硬编码风险的关键步骤。许多初学者常因环境配置不当导致“认证失败”或“权限不足”的错误，从而阻碍了流畅的编码体验。本文将深入解析如何在不同操作系统中设置必要的环境变量，确保 Claude Code 能够稳定调用 API 服务。
理解核心环境变量与前置准备
Claude Code 的运行依赖于特定的环境变量来识别身份和授权访问。其中，最核心的变量是 ANTHROPIC_API_KEY。这个变量存储了你的 Anthropic 账户专属 API 密钥，它类似于数字世界的通行证，允许开发者通过命令行界面与大型语言模型进行交互。除了 API 密钥外，部分高级功能或特定代理模式可能还需要配置 ANTHROPIC_BASE_URL 以指定服务端点，或者设置 CLAUDE_CODE_VERSION 来锁定版本行为，但在绝大多数常规场景下，只需关注 API 密钥的配置即可。
在开始配置之前，请确保你已经完成了以下准备工作：首先，注册并登录 Anthropic 官网，进入控制台获取有效的 API 密钥；其次，确认你的终端环境（如 Bash、Zsh 或 PowerShell）已安装最新版本的 Claude Code CLI 工具。如果密钥泄露，应立即在控制台中撤销并重置，切勿将密钥直接写入脚本文件或提交到代码仓库中，这是安全操作的第一准则。
主流操作系统的环境变量配置实操
不同的操作系统有着截然不同的环境变量持久化机制。为了让你能够一劳永逸地解决问题，我们需要针对 Linux、macOS 和 Windows 分别进行详细讲解。
对于 Linux 和 macOS 用户，通常使用 Zsh 或 Bash 作为默认 Shell。若你使用的是 Zsh（macOS 默认），请编辑 ~/.zshrc 文件；若是 Bash，则编辑 ~/.bashrc 或 ~/.bash_profile。在文件末尾添加如下行：export ANTHROPIC_API_KEY="your_api_key_here"。保存后，务必运行 source ~/.zshrc（或对应的文件名）使配置立即生效。这种方式的优势在于环境变量会在每次打开新终端时自动加载，无需重复输入。
Windows 用户的配置路径略有不同。虽然可以通过 PowerShell 临时设置变量，但推荐通过图形界面进行永久配置。右键点击“此电脑”选择“属性”，进入“高级系统设置”，点击“环境变量”。在“系统变量”或“用户变量”区域新建名为 ANTHROPIC_API_KEY 的变量，并将你的密钥填入值字段。配置完成后，重启终端窗口以确保更改被读取。此外，PowerShell 用户也可以直接在配置文件 $PROFILE 中添加 $env:ANTHROPIC_API_KEY = "your_api_key_here" 以实现自动化加载。
验证配置与故障排查技巧
配置完成后，验证是否成功至关重要。你可以在终端中输入 echo $ANTHROPIC_API_KEY（Linux/macOS）或 echo %ANTHROPIC_API_KEY%（Windows CMD）/ $env:ANTHROPIC_API_KEY（PowerShell）。如果输出显示为你设置的密钥字符串（或部分掩码），说明配置已成功载入内存。接着，尝试运行 claude --version 或发起一次简单的对话测试，观察是否出现认证错误。
若遇到“Key not found”或“Unauthorized”错误，请检查以下几点：一是确认变量名拼写完全一致，区分大小写；二是确认密钥未被多余的空格或换行符污染，特别是在复制粘贴时；三是检查终端会话是否为新开启的，旧会话可能仍缓存着空值。通过遵循上述标准化流程，你可以建立起一个稳固、安全的 Claude Code 开发环境，从而专注于代码逻辑本身，而非基础设施的维护。
本文链接：https://jianli-bf.com.cn/gpt/claude-code-mlxhjblpzszzn/
