常见问题

这里汇总了使用 Claude Code 时的常见问题和解决方法。

安装问题

无法安装 Claude Code

问题：运行 npm install -g @anthropic/claude-code 时报错。

解决方法：

1. 确保已安装 Node.js 16 或更高版本
2. 如果遇到权限问题，在 Linux/macOS 上使用 sudo
3. 在 Windows 上以管理员身份运行命令提示符

找不到 claude 命令

问题：安装后运行 claude 命令提示找不到。

解决方法：

1. 检查 npm 全局安装路径是否在 PATH 中
2. 运行 npm list -g @anthropic/claude-code 确认已安装
3. 重新打开终端窗口

配置问题

API Key 无效

问题：提示 API Key 无效或未授权。

解决方法：

1. 确保使用的是有效的 Anthropic API Key
2. 检查 API Key 是否有足够的配额
3. 运行 claude config 重新设置 API Key

无法访问文件

问题：Claude Code 无法读取或写入文件。

解决方法：

1. 检查文件权限
2. 在 macOS 上，确保终端应用有文件访问权限
3. 在 Windows 上，以管理员身份运行

使用问题

响应速度慢

问题：Claude Code 响应缓慢。

解决方法：

1. 检查网络连接
2. 尝试使用不同的模型（如 claude-haiku-4）
3. 检查是否有代理设置影响连接

中文显示乱码

问题：中文字符显示为乱码。

解决方法：

1. 确保终端使用 UTF-8 编码
2. 在 Windows 上，运行 chcp 65001 设置 UTF-8
3. 更新终端应用到最新版本

MCP 相关问题

MCP 服务器无法启动

问题：配置的 MCP 服务器无法连接。

解决方法：

1. 确保 MCP 服务器已正确安装
2. 检查配置文件中的命令路径是否正确
3. 使用 claude --mcp-debug 查看详细日志

GitHub MCP 集成失败

问题：GitHub MCP 服务器报错。

解决方法：

1. 确保 GITHUB_TOKEN 有效且有足够权限
2. 检查令牌是否已过期
3. 重新生成 GitHub Personal Access Token

更多帮助

如果以上解决方法无法帮助您，请：

1. 访问 GitHub Issues
2. 查看 官方文档
3. 联系技术支持