安装配置详解
Claude Code 是一个强大的终端 AI 编程助手，支持多种安装方式和平台。本指南将帮助您完成从系统要求检查到完整配置的全过程。
系统要求
操作系统支持
- macOS: 10.15 或更高版本
- Linux: Ubuntu 20.04+, Debian 10+, CentOS 8+, 或其他主流发行版
- Windows: Windows 10/11（支持 WSL2、Git Bash 或原生 PowerShell）
硬件要求
- 内存: 最低 4GB RAM（推荐 8GB+，处理大型代码库时）
- 存储: 至少 1GB 可用磁盘空间
- 网络: 稳定的互联网连接（用于认证和 AI 处理）
软件依赖
- Node.js: 18.0 或更高版本（仅 npm 安装方式需要）
- Git: 2.23+（可选，用于代码仓库集成）
- 终端: Bash、Zsh、Fish 或 PowerShell
安装方法
Claude Code 提供多种安装方式，推荐使用原生二进制安装，无需 Node.js 依赖且自动更新。
方法一：原生二进制安装（推荐）
macOS 和 Linux
打开终端，运行以下命令：
curl -fsSL https://claude.ai/install.sh | bash
安装特定版本：
curl -fsSL https://claude.ai/install.sh | bash -s -- --version v0.6.0
安装完成后，重新加载 shell 配置：
# Bash 用户
source ~/.bashrc
# Zsh 用户
source ~/.zshrc
验证安装：
claude --version
Windows（PowerShell）
以管理员身份打开 PowerShell，运行：
iwr -useb https://claude.ai/install.ps1 | iex
方法二：NPM 安装
如果您已安装 Node.js，也可以通过 npm 安装：
npm install -g @anthropic-ai/claude-code
注意:
- 不要使用
sudo执行 npm 安装 - 如遇权限错误，请配置用户级 npm 目录：
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc
方法三：Homebrew（macOS）
brew install --cask claude-code
认证配置
安装完成后，需要配置 Claude Code 的认证信息。
启动认证
首次运行 Claude Code 时会自动引导认证：
claude
认证方式选择
Claude Code 支持三种认证方式：
1. Anthropic Console（推荐）
选择此选项后，浏览器会自动打开 Anthropic Console 登录页面：
- 登录您的 Anthropic 账户
- 授权 Claude Code 访问权限
- 返回终端完成配置
2. Claude App（需要 Max 订阅）
如果您有 Claude Max 订阅：
- 确保订阅有效
- 选择 Claude App 选项
- 按提示完成认证
3. 企业平台
配置 Amazon Bedrock 或 Google Vertex AI：
- 准备好相应的 API 密钥
- 选择企业平台选项
- 按提示配置
环境变量配置（可选）
您可以通过环境变量自定义 Claude Code 的行为：
# 模型选择
export ANTHROPIC_MODEL=claude-sonnet-4-20250514
# 子代理模型
export CLAUDE_CODE_SUBAGENT_MODEL=claude-haiku-4-20241022
# 性能调优
export MAX_THINKING_TOKENS=10000
export CLAUDE_CODE_MAX_OUTPUT_TOKENS=8192
export BASH_DEFAULT_TIMEOUT_MS=30000
# 隐私设置
export DISABLE_TELEMETRY=1
export DISABLE_ERROR_REPORTING=1
将上述配置添加到您的 shell 配置文件（.bashrc、.zshrc 等）中。
特定平台配置
Windows 用户
WSL2 配置（推荐）
- 安装 WSL2：
wsl --install
-
在 WSL2 中遵循 Linux 安装步骤
-
配置 Windows Terminal 以获得最佳体验
Git Bash 配置
- 下载并安装 Git for Windows
- 使用 Git Bash 运行安装命令
- 配置 PATH 环境变量
PowerShell 原生支持
Claude Code 现已支持原生 Windows 安装，可直接在 PowerShell 中使用。
Alpine Linux 用户
Alpine 等 musl-based 发行版需要额外依赖：
export USE_BUILTIN_RIPGREP=0
curl -fsSL https://claude.ai/install.sh | bash
Docker 环境
虽然 Claude Code 主要用于本地开发，但也可以在 Docker 容器中运行：
FROM node:18-alpine
RUN npm install -g @anthropic-ai/claude-code
WORKDIR /workspace
CMD ["claude"]
验证安装
基本功能测试
- 版本检查：
claude --version
- 运行诊断：
claude doctor
- 查看帮助：
claude --help
创建测试项目
创建一个简单的测试项目验证功能：
mkdir claude-test
cd claude-test
echo "# 测试项目" > README.md
claude
在 Claude Code 中尝试：
/init- 初始化项目- "帮我创建一个简单的 Python 脚本" - 测试代码生成
/clear- 清除上下文
常见问题解决
权限错误
问题: EACCES: permission denied
解决方案:
# 修复 npm 权限
npm config fix
# 或使用 nvm 管理 Node.js
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
nvm install 18
nvm use 18
网络连接问题
问题: 无法连接到 Anthropic API
解决方案:
- 检查防火墙设置
- 配置代理（如需要）：
export HTTP_PROXY=http://proxy.company.com:8080
export HTTPS_PROXY=http://proxy.company.com:8080
版本冲突
问题: 多个 Claude Code 版本共存
解决方案:
# 卸载所有版本
npm uninstall -g @anthropic-ai/claude-code
sudo rm -rf ~/.claude
# 重新安装
curl -fsSL https://claude.ai/install.sh | bash
WSL2 问题
问题: WSL2 中 Claude Code 无法启动
解决方案:
# 更新 WSL2
wsl --update
# 重启 WSL2
wsl --shutdown
wsl
更新和维护
自动更新
原生安装版本支持自动更新：
# 检查更新
claude update
# 手动触发更新
claude update --force
NPM 更新
# 检查当前版本
npm list -g @anthropic-ai/claude-code
# 更新到最新版本
npm update -g @anthropic-ai/claude-code
清理缓存
如遇到问题，可以清理缓存重新开始：
# 清理 Claude Code 缓存
rm -rf ~/.claude/cache
# 清理 npm 缓存
npm cache clean --force
下一步
安装完成后，您已经可以开始使用 Claude Code 了。建议继续阅读：
- 第一个项目 - 学习基本使用流程（即将推出）
- 基础命令 - 掌握常用命令（即将推出）
- 项目配置指南 - 优化项目配置（即将推出）
提示：这些教程正在编写中，即将发布！
获取帮助
如果遇到安装问题，可以：
- 运行
claude doctor获取诊断信息 - 查看 官方文档
- 在 GitHub Issues 搜索或报告问题
- 加入社区讨论获取支持
提示: 保存好您的 API 密钥和配置文件，避免在公共代码仓库中提交敏感信息。