很多人第一次用 Claude Code 时，会直接在登录界面里选择：

Anthropic Console account · API usage billing

然后以为后面所有调用，都会天然跟着自己后来新建的 workspace 走。

这其实很容易理解错。

真正容易踩坑的地方不是“怎么填 API key”，而是：

• 你已经在 Anthropic Console 里新建了一个 workspace
• 你也在这个 workspace 下面建了新的 API key
• 但 Claude Code 还是在用你默认登录时那套凭据，或者默认的计费归属

如果你不把当前终端里的 key 切换过去，Claude Code 不会替你“猜”你现在想用哪个 workspace。

这就是这篇教程要解决的问题。

先说结论

如果你希望 Claude Code 使用某个新 workspace 下面的 API key，那么最直接、最稳妥的做法是：

• 在 Anthropic Console 里切到那个 workspace
• 在这个 workspace 下创建新的 API key
• 在你当前的 shell 里把这个 key 设置成 ANTHROPIC_API_KEY
• 再从这个终端里启动 claude

这样 Claude Code 就会优先使用你当前 shell 中显式设置的这个 key，而不是继续沿用你之前默认登录时的那套环境。

为什么这个教程有必要

Claude Code 的登录方式本身就有两条路径：

• Claude 订阅账号
• Anthropic Console 账号（按 API 使用量计费）

根据 Anthropic 官方文档，当你第一次用 Anthropic Console 账号认证 Claude Code 时，系统会自动创建一个名为 Claude Code 的 workspace，用来集中跟踪和管理 Claude Code 的使用成本。

这一步没错，问题在于很多人会自然地以为：

“既然我已经登录过了，那我后来在 Console 里新建的 workspace 和 key，Claude Code 应该会自动识别。”

但现实通常不是这样。

Claude Code 是否使用某个 key，取决于你当前会话里实际提供给它的认证信息。

如果你在当前 shell 里显式设置了 ANTHROPIC_API_KEY，Claude Code 会用这个 key 发送请求。

换句话说：

• “我在 Console 里有几个 workspace” 是管理层面的事
• “Claude Code 当前到底拿哪个 key 发请求” 是运行时环境层面的事

这两件事不是一回事。

正确理解这个问题

你可以把它理解成下面这个模型：

默认情况

你登录 Claude Code，选择 Anthropic Console account。

Claude Code 拿到一套可用凭据，后续你能正常使用。

后来你又做了一件事

你在 Anthropic Console 里新建了一个 workspace，并在这个 workspace 下创建了新的 API key。

但问题来了

如果你没有在当前终端里把这个新 key 配进去，那么你只是“在 Console 里拥有了一个新 key”，并不等于“Claude Code 当前就在使用这个新 key”。

这也是为什么很多人明明建了新 workspace，却发现计费、权限或者调用归属看起来还是不对。

正确操作步骤

第一步：在目标 workspace 下创建 API key

先进入 Anthropic Console，切换到你真正想使用的那个 workspace。

注意，不要在默认组织或者别的 workspace 下面误建 key。

你想让 Claude Code 用哪个 workspace 的额度、权限和计费归属，就应该在那个 workspace 下面创建对应的 key。

创建完成后，你会拿到一个新的 API key。

第二步：在当前终端里设置 ANTHROPIC_API_KEY

如果你只是临时测试，最简单的方式是在当前 shell 里直接执行：

export ANTHROPIC_API_KEY="你的新 workspace key"

然后在同一个终端里启动：

claude

这时候 Claude Code 会优先使用你当前 shell 里的这个 key。

这一点很关键：

不是你在哪个 workspace 页面创建了 key 就自动生效，而是你有没有把这个 key 提供给当前会话。

第三步：如果你长期使用，就写进 shell 配置

如果你每次都要用这个 workspace 的 key，可以把它写进你的 shell 配置文件，比如 ~/.zshrc：

export ANTHROPIC_API_KEY="你的新 workspace key"

写完之后执行：

source ~/.zshrc

或者直接重新打开一个终端窗口。

之后你从这个终端里运行 claude，Claude Code 就会继续使用这个 key。

第四步：确认你是不是在“同一个终端”里启动了 Claude Code

这是另一个很容易忽略的坑。

很多人做了这一步：

export ANTHROPIC_API_KEY="新的 key"

然后又换了一个新窗口，或者从别的 IDE 终端里去启动 claude。

结果当然可能不对，因为环境变量只在你设置它的那个 shell 会话里生效，除非你已经把它写进了 ~/.zshrc、~/.bashrc 或者其他持久化配置。

所以一定要确认：

• 你是在设置完 key 的同一个终端里运行 claude
• 或者你已经把它写进 shell 配置并重新加载

临时切换 workspace 的推荐方式

如果你经常在不同 workspace 之间切换，我反而不建议把某一个 key 永久写死在全局配置里。

更好的方式是按项目、按会话切换：

export ANTHROPIC_API_KEY="workspace-a-key"
claude

换一个项目时再切：

export ANTHROPIC_API_KEY="workspace-b-key"
claude

这样你的心智模型会更清楚：

• 我现在在哪个项目目录
• 我现在导出了哪个 workspace 的 key
• 我这次启动的 Claude Code 到底会消耗哪边的额度

几个常见误区

误区一：我已经登录了 Console，所以 Claude Code 会自动切换到新 workspace

不一定。

登录只是让 Claude Code 有办法工作，不代表它会自动理解你后来在 Console 里新增的 workspace 和 key 的意图。

误区二：我在网页上创建了新 key，Claude Code 应该自动识别

也不对。

网页里创建 key 和终端里实际使用哪个 key，是两个层面的事。

误区三：我改过环境变量了，但好像没生效

最常见的原因有三个：

• 没有在同一个终端里启动 claude
• 没有 source ~/.zshrc
• 旧终端、IDE 内置终端或其他进程还保留着旧环境

误区四：应该配置 ANTHROPIC_AUTH_TOKEN

如果你拿的是 Anthropic 官方 API key，通常应该配置的是：

ANTHROPIC_API_KEY

ANTHROPIC_AUTH_TOKEN 对应的是 Authorization: Bearer ... 这类自定义认证头，更像是代理、网关或特殊接入方式的配置，不是最常见的官方 key 场景。

我建议你怎么教别人

如果你要把这个问题写成一篇教程，我建议标题不要写成：

“如何配置 Claude API key”

这种标题太泛，用户会以为又是一篇普通的入门教程。

更好的标题应该直接打在误区上，比如：

• Claude Code 为什么没有使用我新建 workspace 的 API key
• Claude Code 如何切换到当前 workspace 的 API key
• 在 Claude Code 里，如何避免一直用默认 Console key

因为真正值得写的不是“export 一下变量”，而是帮别人建立对这件事的正确理解。

最后总结

这件事其实可以用一句话说清楚：

Claude Code 用哪个 workspace 的额度，不取决于你脑子里想用哪个，而取决于你当前会话实际提供给它的那个 key。

所以正确流程应该是：

• 进入目标 workspace
• 在这个 workspace 下创建 key
• 在当前 shell 里设置 ANTHROPIC_API_KEY
• 从这个 shell 启动 claude

只要把这四步想明白，很多“为什么它还在用默认 key”的困惑就会消失。

参考：

• Anthropic Docs: Claude Code Settings
• Anthropic Docs: Claude Code Quickstart