Claude Code注册API Key授权

Claude 账户注册与 API Key 授权配置

手把手讲解 Claude Code 的账户注册流程、API Key 获取方式和授权配置，包括多种认证方式的适用场景。

· 阅读约 5 分钟

安装好 Claude Code 后，第一次运行前需要完成账户授权。Claude Code 支持两种认证方式：Anthropic 账户登录和 API Key 认证，根据你的使用场景选择合适的方式。

两种认证方式对比

方式适用场景费用配置难度
Anthropic 账户（claude.ai）个人使用，有 Pro 订阅包含在 Pro 订阅里简单，浏览器授权
API Key团队使用、自动化脚本按用量计费稍复杂，需要管理 Key

方式一：使用 Anthropic 账户登录（推荐个人用户）

如果你已经有 Claude.ai 的 Pro 或 Team 订阅，可以直接用账户登录，Claude Code 的用量会包含在订阅里。

注册 Anthropic 账户

  1. 访问 claude.ai
  2. 点击”Sign up”
  3. 用邮箱或 Google 账号注册
  4. 验证邮箱

注意：免费账户的 Claude Code 使用量有限，推荐使用 Claude Pro（$20/月）或 Claude Max 订阅，使用量更充足。

在 Claude Code 中登录

安装 Claude Code 后，在终端运行：

claude

首次运行会自动提示你登录：

Welcome to Claude Code!
Please log in to continue.
Opening browser for authentication...

浏览器会自动打开 Anthropic 的授权页面，登录你的账户后点击”Authorize”，返回终端，登录完成。

如果浏览器没有自动打开，复制终端里显示的 URL 手动粘贴到浏览器。

验证登录状态

claude /status
# 或
claude --version

显示账户信息说明登录成功。

方式二：使用 API Key 认证（推荐团队 / 自动化）

API Key 方式更灵活，适合自动化脚本、CI/CD 流水线，或者团队里多人共享使用。

获取 API Key

  1. 访问 console.anthropic.com
  2. 注册或登录账号
  3. 进入”API Keys”页面
  4. 点击”Create Key”
  5. 给 Key 起个名字（比如 claude-code-personal）
  6. 复制生成的 Key（格式：sk-ant-api03-...）

重要：API Key 只会显示一次，立即保存到安全的地方。

配置 API Key

方法一：设置环境变量（推荐）

# 临时设置（当前终端会话有效）
export ANTHROPIC_API_KEY="sk-ant-api03-你的key"

# 永久设置（加入 shell 配置文件）
# zsh 用户：
echo 'export ANTHROPIC_API_KEY="sk-ant-api03-你的key"' >> ~/.zshrc
source ~/.zshrc

# bash 用户：
echo 'export ANTHROPIC_API_KEY="sk-ant-api03-你的key"' >> ~/.bashrc
source ~/.bashrc

方法二：通过 claude login 命令

claude login
# 选择 API Key 方式，粘贴你的 Key

方法三：项目级 .env 文件

# 在项目根目录创建 .env 文件（记得加入 .gitignore！）
echo 'ANTHROPIC_API_KEY=sk-ant-api03-你的key' > .env

配合 direnv 工具，进入项目目录时会自动加载环境变量。

验证 API Key

claude -p "你好"
# 如果 Key 正确，Claude 会正常回复

API Key 的安全管理

API Key 是访问 Claude API 的凭证，泄露会导致费用被盗用，务必注意：

必须做的：

  • 把 .env 文件加入 .gitignore，永远不要提交 Key 到 Git
  • 给每个环境（开发 / 测试 / 生产）创建独立的 Key
  • 定期轮换 Key

不要做的：

  • 不要把 Key 直接写进代码文件
  • 不要通过邮件或聊天工具传输 Key
  • 不要在公开的仓库里暴露 Key

检查 Key 是否已泄露：

# 在仓库里搜索是否有 Key
grep -r "sk-ant" . --exclude-dir=.git

在 Anthropic 控制台管理用量

登录 console.anthropic.com 可以：

  • 查看 API 用量和费用明细
  • 设置用量上限（避免超出预算）
  • 管理多个 API Key
  • 查看每次请求的详情

建议设置用量告警：在控制台的”Billing”页面设置月度预算上限，超出后自动停止，避免意外超支。

切换和退出登录

# 切换账户或 API Key
claude login

# 退出登录
claude logout

# 查看当前登录状态
claude /status

完成账户配置后，Claude Code 就可以正式使用了。下一步建议进行基本配置，让 Claude Code 更符合你的使用习惯。