Claude Code 怎么配置 Anthropic API Key?

文章导读
Claude Code 本身支持多种认证方式,但大多数情况下,你需要一个有效的 Anthropic API Key 才能正常使用。配置不复杂,麻烦的是配置完不知道为什么没生效。下面这份说明基于命令行使用的常见情况,先判断缺什么,再动手写配置,最后用实际命令确认。
📋 目录
  1. Ⅰ 配置前先确认当前会话缺什么
  2. Ⅱ 配置 Key:写进 shell 配置还是项目配置?
  3. Ⅲ 配置完先验证 Key 有没有生效
  4. Ⅳ 容易被忽略的坑
  5. Ⅴ 安全边界:Key 泄露后怎么办
A A

Claude Code 本身支持多种认证方式,但大多数情况下,你需要一个有效的 Anthropic API Key 才能正常使用。配置不复杂,麻烦的是配置完不知道为什么没生效。下面这份说明基于命令行使用的常见情况,先判断缺什么,再动手写配置,最后用实际命令确认。

配置前先确认当前会话缺什么

在使用 Claude Code 之前,需要先确认当前会话是否已经具备可用的认证方式。如果此前从未配置过 Anthropic API Key,运行 claude 命令时通常会看到类似认证失败或缺少凭据的提示。此时不要急于猜测,可以先查看环境变量中是否存在 ANTHROPIC_API_KEY 这一项。在大部分终端里,执行 echo $ANTHROPIC_API_KEY 即可看到结果;如果输出为空,说明尚未配置。当然,有些开发工具会自动加载 .env 文件,也需要检查项目根目录下是否有该文件,以及其中是否包含正确的键值对。

这里要特别留意:你看到的“认证失败”并不一定代表 Key 不存在,也可能因为当前 shell 读取的是另一个用户的配置。比如通过 sudo 切换到其他账号运行 claude,就不会沿用你原本的环境变量。遇到这种情况,先用 whoami 和 env | grep ANTHROPIC 确认当前进程身份和变量内容,再决定下一步改哪个文件。

配置 Key:写进 shell 配置还是项目配置?

配置 API Key 的常规做法是在 shell 配置文件中导出环境变量。以 bash/zsh 为例,在 ~/.bashrc 或 ~/.zshrc 末尾添加 export ANTHROPIC_API_KEY="你的密钥",然后执行 source ~/.bashrc 让配置立即生效。对于 Windows PowerShell,则使用 $env:ANTHROPIC_API_KEY="你的密钥" 或者通过系统环境变量设置。注意,密钥应使用英文双引号包裹,且等号前后不要有空格。也可以将 ANTHROPIC_API_KEY 写入项目级的 .env 文件,并配合 dotenv 类工具自动加载,但要注意该文件不应被提交到版本库。

Claude Code 怎么配置 Anthropic API Key?

这两种方式各有适用场景。如果你只在一台机器上跑 Claude Code,写进 shell 配置最简单,每次打开终端都自动生效。如果你同时维护多个项目,而且不同项目需要对应不同的账户,建议优先尝试项目级 .env,并确认你的启动脚本真的会读取它。如果不确定,可以在终端里手动执行 set -a; source .env; set +a,再启动 claude,这样能临时把 .env 里的变量导入当前 shell。

配置完先验证 Key 有没有生效

改完配置文件后,不要直接开始写代码。先开一个新的终端窗口,再执行 echo $ANTHROPIC_API_KEY(Windows PowerShell 用 $env:ANTHROPIC_API_KEY),确认打印值与 Key 完全一致。如果打印为空,说明配置没有被正确加载,这时候去检查 shell 配置文件的拼写和 source 路径。

环境变量确认无误后,再运行 claude 输入一句简单的问候,看能否正常返回。这里有一个建议:第一次测试尽量选一个不需要额外联网能力的任务,减少把认证问题和网络问题混淆的几率。

Claude Code 怎么配置 Anthropic API Key?

容易被忽略的坑

一个容易被忽略的问题是环境变量名称拼写错误。正确的是 ANTHROPIC_API_KEY,不要漏掉中间的 IC,也不要写成 ANTHROPIC-KEY 或 API_KEY。另一个常见坑是修改了 shell 配置文件后没有重新加载,导致当前终端还停留在旧环境。此时要么执行 source 命令,要么直接关闭并重新打开终端。此外,有些代理工具或系统环境变量可能干扰,比如设置了 ANTHROPIC_BASE_URL 指向错误的服务地址。如果发现请求总是失败,可以先用 curl 测试一下环境变量是否生效,再检查网络代理设置。

补充一个和终端复用相关的场景:如果通过 tmux、screen 或 VS Code 远程终端运行 claude,新开的窗口可能基于旧的 shell 进程创建,并不会重新加载 .bashrc。这时候你在另一个窗口 source 了配置,这里仍然读不到。可以先退出当前会话再重进,或者在复用工具里手动执行 source ~/.bashrc。

Claude Code 怎么配置 Anthropic API Key?

安全边界:Key 泄露后怎么办

API Key 等同于账户的访问凭据,一旦泄露可能被他人盗用,产生不必要的费用或数据风险。因此,务必避免将 Key 直接写在代码中、提交到 GitHub 等公共仓库,或者粘贴到聊天工具里。如果项目使用版本管理,可以创建 .env 文件存放 Key,并在 .gitignore 中明确忽略该文件。同时,定期检查 Key 的使用情况,并在 Anthropic 后台管理界面轮换旧的 Key。若怀疑 Key 已泄露,应立刻撤销并重新生成,而不是继续使用现有的 Key。

如果你只是在本地临时测试,也建议给 Key 设置合理的权限范围,比如只允许需要使用的模型或服务。这样即使开发环境出问题,也能把影响限制在可处理的范围里。

配置本身不复杂,关键是每一步都确认到位。如果按上面的顺序做下来还是提示认证失败,下一步可以先看 Claude Code 的版本和启动日志,确认它读取的是哪一份配置文件,再对照环境变量排查。