Claude Code 保姆级安装教程
Claude Code 是 Anthropic 官方出品的 AI 编程助手 CLI 工具，可在终端、IDE 中直接使用。
目录
一、系统要求
macOS
- 系统版本：macOS 13.0 或更高
- 处理器：Intel 或 Apple Silicon（M1/M2/M3）
- 内存：至少 4GB（推荐 8GB 以上）
Windows
- 系统版本：Windows 10 / 11（64位）
- 内存：至少 4GB（推荐 8GB 以上）
- 不支持 32 位 Windows
Linux
- 支持：Ubuntu、Debian、Fedora、Alpine 等主流发行版
- 处理器：x86_64 或 ARM64
- 内存：至少 4GB（推荐 8GB 以上）
二、前置依赖安装
Node.js（部分安装方式需要）
原生安装方式不需要 Node.js，使用 npm 安装方式才需要。
macOS（使用 Homebrew）
brew install node
Ubuntu / Debian
sudo apt-get update
sudo apt-get install nodejs npm
Windows（使用 Chocolatey）
choco install nodejs
或直接去 nodejs.org 下载安装包。
验证 Node.js 安装
node --version
npm --version
Git（Windows 原生安装需要）
去 git-scm.com/downloads/win 下载安装。
验证 Git 安装
git --version
三、安装 Claude Code
方法一：原生安装（推荐）
无需 Node.js，支持自动更新。
macOS / Linux
curl -fsSL https://claude.ai/install.sh | bash
Windows PowerShell
irm https://claude.ai/install.ps1 | iex
Windows CMD
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
方法二：Homebrew（macOS / Linux）
brew install --cask claude-code
注意：Homebrew 安装不会自动更新，需手动执行
brew upgrade claude-code。
方法三：WinGet（Windows）
winget install Anthropic.ClaudeCode
注意：不会自动更新，手动执行
winget upgrade Anthropic.ClaudeCode。
方法四：npm 全局安装
npm install -g @anthropic-ai/claude-code
四、验证安装成功
安装完成后，运行以下命令检查版本：
claude --version
正常输出示例：
claude-code/2.x.x
如果提示 command not found: claude，请参考 第七部分常见问题 中的 Q1。
五、登录认证
第一次启动
进入任意项目目录，运行：
cd /你的项目目录
claude
支持的账户类型
| 账户类型 | 说明 | 地址 |
|---|---|---|
| Claude.ai 订阅 | Pro、Max、Team、Enterprise | claude.com/pricing |
| Anthropic Console | 免费 API 额度 | console.anthropic.com |
| Amazon Bedrock | 第三方云服务 | AWS 控制台 |
| Google Vertex AI | 第三方云服务 | GCP 控制台 |
登录步骤
- 运行
claude命令 - 浏览器自动打开登录页面
- 完成 OAuth 认证授权
- 返回终端，自动继续使用
如果浏览器没有自动打开，按
c键复制登录链接，手动粘贴到浏览器中打开。
切换账户
/login
六、IDE 集成
VS Code
方法一：命令行安装
code --install-extension anthropic.claude-code
方法二：在 VS Code 内安装
- 按
Cmd+Shift+X（Mac）或Ctrl+Shift+X（Windows/Linux）打开扩展面板 - 搜索 Claude Code
- 点击 Install
使用方式
- 点击右上角 Spark 图标
- 或按
Cmd+Shift+P/Ctrl+Shift+P搜索 “Claude Code”
JetBrains（IntelliJ、PyCharm、Android Studio 等）
- 打开 IDE → Settings → Plugins
- 搜索 Claude Code
- 点击 Install，重启 IDE
插件地址：plugins.jetbrains.com/plugin/27310
快捷键
- Mac：
Cmd + Esc - Windows/Linux：
Ctrl + Esc
Desktop 桌面应用
| 平台 | 下载地址 |
|---|---|
| macOS | https://claude.ai/api/desktop/darwin/universal/dmg/latest/redirect |
| Windows x64 | https://claude.ai/api/desktop/win32/x64/setup/latest/redirect |
| Windows ARM64 | https://claude.ai/api/desktop/win32/arm64/setup/latest/redirect |
七、常见问题解决
Q1：command not found: claude
原因：安装目录未加入 PATH 环境变量。
macOS / Linux（Zsh）
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
macOS / Linux（Bash）
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
Windows PowerShell
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')
重启终端后生效。
Q2：安装脚本报 HTML 错误
现象：syntax error near unexpected token '<'
原因：网络问题或地区限制。
解决：
- 改用 Homebrew 或 WinGet 安装
- 检查网络连接，稍后重试
Q3：网络连接失败
现象：Failed to fetch version
检查连接
curl -sI https://storage.googleapis.com
配置代理
export HTTPS_PROXY=http://proxy.example.com:8080
export HTTP_PROXY=http://proxy.example.com:8080
curl -fsSL https://claude.ai/install.sh | bash
Q4：TLS / SSL 错误
更新 CA 证书
Ubuntu/Debian：
sudo apt-get update && sudo apt-get install ca-certificates
macOS：
brew install ca-certificates
Windows PowerShell：
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
irm https://claude.ai/install.ps1 | iex
Q5：Windows 提示需要 Git Bash
现象：Claude Code on Windows requires git-bash
解决：去 git-scm.com/downloads/win 安装 Git for Windows。
Q6：Linux 安装被 Killed（内存不足）
原因：VPS 内存不足（至少需要 4GB）。
解决：创建交换文件
sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile
# 重试安装
curl -fsSL https://claude.ai/install.sh | bash
Q7：权限被拒绝
sudo mkdir -p ~/.local/bin
sudo chown -R $(whoami) ~/.local
curl -fsSL https://claude.ai/install.sh | bash
Q8：登录失败 / 浏览器未打开
- 按
c键复制登录 URL - 手动粘贴到浏览器
- 快速完成登录（有时效限制）
- 远程/SSH 环境中，复制 URL 到本地浏览器打开
Q9：运行诊断
claude /doctor
此命令会检查：安装类型、版本、自动更新状态、配置文件、MCP 服务器、快捷键绑定等。
八、常用命令速查
| 命令 | 功能 |
|---|---|
claude |
启动交互模式 |
claude "任务描述" |
执行单次任务后退出 |
claude -c |
继续最近一次对话 |
claude -r |
选择并恢复历史对话 |
claude -p "查询内容" |
非交互模式执行查询 |
/login |
登录 / 切换账户 |
/logout |
登出 |
/help |
显示帮助信息 |
/doctor |
诊断安装问题 |
/feedback |
提交反馈 |
/compact |
压缩当前上下文 |
/clear |
清空当前对话 |
九、卸载
macOS / Linux（原生安装）
rm -rf ~/.local/bin/claude
rm -rf ~/.claude/
Homebrew
brew uninstall --cask claude-code
WinGet
winget uninstall Anthropic.ClaudeCode
npm
npm uninstall -g @anthropic-ai/claude-code
获取帮助
| 渠道 | 地址 |
|---|---|
| 官方文档 | code.claude.com/docs |
| GitHub Issues | github.com/anthropics/claude-code/issues |
| Anthropic Discord | anthropic.com/discord |
| 本地帮助 | 运行 claude /help |
本教程基于 Claude Code 最新版本编写。如遇版本差异，以官方文档为准。
AtomGit 是由开放原子开源基金会联合 CSDN 等生态伙伴共同推出的新一代开源与人工智能协作平台。平台坚持“开放、中立、公益”的理念，把代码托管、模型共享、数据集托管、智能体开发体验和算力服务整合在一起，为开发者提供从开发、训练到部署的一站式体验。
更多推荐
15
0- 0
已为社区贡献2条内容
所有评论(0)