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 更符合你的使用习惯。

标记本节教程为已读

记录您的学习进度,方便后续查看。