解决 Claude Code 安装、登录和认证过程中遇到的常见问题。
安装问题
安装脚本失败
如果 curl -fsSL https://claude.ai/install.sh | bash 失败：
- 网络连接：确认能访问
claude.ai - 权限：使用
sudo运行安装脚本 - 磁盘空间：确认有足够的磁盘空间
安装后 claude 命令找不到
- 确认安装目录在 PATH 中：
echo $PATH - 默认安装到
/usr/local/bin或~/.local/bin - 重新打开终端或运行
source ~/.bashrc
登录问题
认证链接无法打开
在没有图形界面的环境中：
- 在终端中复制认证 URL
- 在本地浏览器中打开该 URL
- 登录后获取认证令牌
- 将令牌粘贴回终端
API 密钥无效
- 确认
ANTHROPIC_API_KEY环境变量设置正确 - 前往 Anthropic Console 检查密钥状态
- 重新生成密钥并更新环境变量
登录超时
重新运行 claude 会生成新的认证链接。旧链接会自动失效。
运行问题
模型不可用
确认：
- 你的账户有有效的订阅或 API 额度
- 使用
/model切换到可用的模型 - 检查是否有速率限制
权限被拒绝
- 检查文件权限：Claude 需要对项目目录的读写权限
- 检查 Shell 权限：Claude 需要能执行命令