Claude Code 必须绑定有效的 Anthropic API 账号才能运行，同时需确保本地环境具备代码执行与文件操作的必要权限。
Anthropic 账号准备
- 注册：访问 console.anthropic.com 使用邮箱注册（支持 Gmail、企业邮箱及 Google 账号快捷登录）
- 地区限制：目前支持绝大多数国家和地区，如遇访问问题需检查网络环境
- 企业账号：如公司已有 Anthropic 组织账号，联系管理员邀请加入，无需单独注册
API Key 获取与配置
获取方式：
- 登录 Console → 左侧菜单 Settings → API Keys → Create Key
- 密钥格式以
sk-ant-api03-开头，仅显示一次，务必立即复制保存
配置方法（三选一）：
# 方法1：临时设置（当前终端会话有效）
export ANTHROPIC_API_KEY='sk-ant-api03-xxxxxxxx'
# 方法2：永久生效（根据你的 shell 选择）
echo 'export ANTHROPIC_API_KEY="sk-ant-api03-xxxxxxxx"' >> ~/.zshrc # macOS Zsh
echo 'export ANTHROPIC_API_KEY="sk-ant-api03-xxxxxxxx"' >> ~/.bashrc # Linux Bash
source ~/.zshrc # 或 source ~/.bashrc 立即生效
# 方法3：首次启动时交互式输入（不推荐用于自动化场景）
# 运行 claude 命令后按提示粘贴密钥本地系统权限
- 安装权限：全局安装需写入
/usr/local/bin，如遇Permission denied改用用户级安装（--install-dir ~/.local/bin） - 项目目录权限：确保对目标代码库有读写权限，Claude Code 会在项目根目录创建
.claude/缓存文件夹 - 执行权限：首次运行可能需要批准"终端执行权限"（macOS 安全提示）
费用与额度管理
- 免费试用：新账号通常包含 $5 免费额度（约支持 100-200 次标准代码审查），用完即止
- 付费激活：需在 Console → Billing 绑定信用卡或设置自动充值（最低充值 $5）
- 用量监控：
- 终端内运行
/usage查看本次会话消耗 - 网页端 Console → Usage 查看详细账单（按 tokens 计费，当前 Claude 3.5 Sonnet 约 $3/百万输入 tokens + $15/百万输出 tokens）
企业/团队环境特殊说明
- 防火墙放行：企业网络需允许访问
api.anthropic.com:443，部分公司需申请白名单 - SSO 限制：如公司启用单点登录，可能无法直接生成 API Key，需通过 IT 管理员获取
- 密钥轮换：建议每 90 天更换一次 API Key，旧密钥可在 Console 手动 Revoke
验证检查清单
# 1. 确认密钥已设置
echo $ANTHROPIC_API_KEY | cut -c1-12 # 应输出 sk-ant-api03-
# 2. 测试网络连通（应返回 HTTP/2 401，证明网络畅通只是未授权）
curl -s -o /dev/null -w "%{http_code}" https://api.anthropic.com/v1/messages
# 3. 验证安装后能否正常认证
claude --version # 应显示版本号而非认证错误排错提示：如遇 Error: Authentication failed，先检查密钥字符串是否包含换行符或空格；如遇 Rate limit exceeded，说明免费额度已用完或触发了并发限制，需等待 1 分钟或升级付费计划。