目标：在你的电脑上安装 Claude Code，完成首次登录
预计时间：15 分钟
对应官方文档：Quickstart、Setup
系统要求
- macOS：11+（Big Sur 或更新）
- Linux：主流发行版（Ubuntu、Debian、Fedora 等）
- Windows：Windows 10/11，支持 WSL 或原生 PowerShell
- Node.js：18+（自动安装，无需手动准备）
macOS / Linux / WSL 安装
打开终端，复制粘贴以下命令：
curl -fsSL https://claude.ai/install.sh | bash安装完成后，运行：
claude使用 Homebrew（macOS 可选）
# 稳定版（推荐新手）
brew install --cask claude-code
# 最新版（功能最全，可能有小问题）
brew install --cask claude-code@latest⚠️ Homebrew 安装不会自动更新，需要定期运行
brew upgrade claude-code
Windows 安装
方式一：PowerShell（推荐）
irm https://claude.ai/install.ps1 | iex方式二：CMD
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd使用 WinGet
winget install Anthropic.ClaudeCode💡 建议安装 Git for Windows，这样 Claude 可以使用 Bash 工具，功能更完整。
首次登录
运行 claude 后，会提示你登录：
╭────────────────────────────────────────╮
│ Welcome to Claude Code! │
│ │
│ Please log in to get started. │
│ A browser window will open... │
╰────────────────────────────────────────╯
- 按回车，系统会自动打开浏览器
- 使用你的 Claude 账号（或 Anthropic Console 账号）登录
- 授权完成后，回到终端即可使用
登录遇到问题？
| 问题 | 解决方式 |
|---|---|
| 浏览器没打开 | 复制终端显示的 URL，手动粘贴到浏览器 |
| 提示 "command not found" | 检查 PATH，或重新运行安装脚本 |
| 公司网络/代理 | 参考 网络配置文档 |
| 需要粘贴 OAuth 码 | 这是 Windows 常见情况，按提示粘贴即可 |
验证安装
登录成功后，你应该看到：
╭────────────────────────────────────────╮
│ Claude Code v1.x.x │
│ Ready to help you code! │
╰────────────────────────────────────────╯
>
光标前的 > 表示 Claude 在等待你的输入。
安装与登录流程图
以下是 Claude Code 从安装到首次登录的完整流程：
基本操作测试
试试输入：
> 你好，请介绍一下这个项目
Claude 会：
- 读取当前目录的文件结构
- 分析项目类型（Python、JavaScript 等）
- 给你一个项目概述
更多代码示例
示例 1：查看 Claude 版本信息
claude --version预期输出：
Claude Code v1.x.x
示例 2：检查当前 PATH 中是否存在 claude
echo $PATH | tr ':' '\n' | grep -i claude如果输出包含类似 ~/.claude/bin 的路径，说明安装路径已正确加入。
示例 3：查看 claude 可执行文件位置
which claude && ls -la $(which claude)预期输出：
/Users/username/.claude/bin/claude
lrwxr-xr-x 1 username staff 29 Jun 10 09:30 /Users/username/.claude/bin/claude -> /Users/username/.claude/bin/claude-x.x.x
实战场景
场景 1：在公司内网环境完成安装与登录
背景：你的公司网络需要通过 HTTP 代理访问外网，直接运行安装脚本失败。
操作步骤：
- 确认代理地址和端口（询问 IT 或查看系统设置）
- 在终端设置代理环境变量：
export HTTP_PROXY=http://proxy.company.com:8080 export HTTPS_PROXY=http://proxy.company.com:8080 - 重新执行安装脚本：
curl -fsSL -x $HTTP_PROXY https://claude.ai/install.sh | bash - 安装完成后，同样带上代理启动 Claude：
HTTPS_PROXY=http://proxy.company.com:8080 claude - 浏览器正常打开后完成 OAuth 授权，回到终端即可使用
预期结果：成功登录并看到 > 提示符，输入 > 你好 能正常收到回复。
场景 2：在无图形界面的远程服务器上安装
背景：你在一台无浏览器、无外显的远程 Linux 服务器（如 SSH 到云主机）上需要安装 Claude Code。
操作步骤：
- 通过 SSH 连接到服务器：
ssh user@remote-server - 在服务器上执行安装：
curl -fsSL https://claude.ai/install.sh | bash - 启动 Claude 并选择 OAuth Code 登录方式：
claude auth login --method oauth-code - 终端会显示类似如下信息：
Please visit: https://claude.ai/login?device=xxx Enter the code shown in your browser: - 在本地电脑浏览器中打开上述 URL，完成登录并复制显示的授权码
- 将授权码粘贴到 SSH 终端，回车确认
预期结果：服务器终端显示 Welcome to Claude Code! 和 > 提示符，表明已成功在无头环境下完成登录。
更新与卸载
更新
# 自动更新版本
claude update
# Homebrew 版本
brew upgrade claude-code
# WinGet 版本
winget upgrade Anthropic.ClaudeCode卸载
# macOS/Linux
rm -rf ~/.claude
rm $(which claude)
# 或使用包管理器
brew uninstall claude-code
winget uninstall Anthropic.ClaudeCode