在 Mac 和 Windows 上装 Claude Code

Claude Code 是命令行工具，但不需要你会编程。整个安装过程就是复制几行命令粘进去。

Mac 顺利的话三分钟；Windows 会多两步，也是最容易卡住的地方——这篇把那两处单独拎出来讲。

开始之前

• 订阅：需要 Pro、Max、Team 或 Enterprise。免费版不含 Claude Code
• 系统：macOS 13.0 以上；Windows 10 1809 以上
• 硬件：4 GB 以上内存
• 网络：安装和授权都要能连上 claude.ai

如果你只是想试试、不想装东西，claude.ai/code 是网页版，打开浏览器就能用。也有桌面客户端，图形界面，同样不需要终端。

Mac

第一步：安装

打开「终端」（在启动台里搜「终端」，或按 Command + 空格 搜 Terminal），把这行粘进去，回车：

curl -fsSL https://claude.ai/install.sh | bash

装完验证：

claude --version

看到类似 2.1.211 (Claude Code) 的版本号就成了。

如果你用 Homebrew，也可以 brew install --cask claude-code。区别是：官方脚本装的会自动后台更新，Homebrew 装的不会，得手动 brew upgrade claude-code。

第二步：授权

claude

浏览器会自动打开授权页，登录 Claude 账号，点 Allow。回到终端看到欢迎信息，就可以用了。

Windows

Windows 有两处坑，都在下面标出来了。命令都在 PowerShell 里执行（开始菜单搜「PowerShell」）。

第一步：装 Git for Windows（建议先做）

Claude Code 在 Windows 上不装 Git 也能跑，但功能会打折——装了 Git 之后，它才能用 Git Bash 来执行命令；不装的话它退回到 PowerShell，部分行为不一样。

winget install Git.Git

装完关掉 PowerShell 窗口，重新开一个（不重开的话环境变量不生效）。验证：

git --version

命令行装不上就手动下载：https://git-scm.com/downloads/win。安装时全部保持默认，确认勾选了 Git Bash。

第二步：安装 Claude Code

irm https://claude.ai/install.ps1 | iex

验证：

claude --version

如果提示「不是内部或外部命令」，是 PATH 没配上，运行这行再重启 PowerShell：

[Environment]::SetEnvironmentVariable("PATH", "$env:PATH;$env:USERPROFILE\.local\bin", [EnvironmentVariableTarget]::User)

如果输入 claude 打开的是桌面应用而不是命令行，是同名程序抢了，删掉那个占位文件：

Remove-Item "$env:LOCALAPPDATA\Microsoft\WindowsApps\Claude.exe"

如果它找不到 Git Bash（提示 requires git-bash），在 ~/.claude/settings.json 里指明路径：

{
  "env": {
    "CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"
  }
}

你也可以用 winget install Anthropic.ClaudeCode 装。同样不会自动更新，需要定期 winget upgrade Anthropic.ClaudeCode。

第三步：确认本地回调通畅（最容易卡住的一步）

授权的原理是：浏览器登录成功后，要回调到你自己电脑上的一个本地地址（127.0.0.1）。这一步在 Windows 上经常失败，表现是点了 Allow 之后浏览器显示「无法访问此网站」。

先确认 hosts 文件里 localhost 指向正确：

1. 开始菜单搜「PowerShell」，右键 → 以管理员身份运行
2. 打开 hosts 文件：

notepad C:\Windows\System32\drivers\etc\hosts

3. 确认文件里有这一行（没有就加在最后）：

127.0.0.1 localhost

4. 如果有一行 ::1 localhost 且前面没有 #，在前面加一个 # 把它注释掉：

# ::1 localhost

5. 保存关闭，回到管理员 PowerShell 刷新 DNS：

ipconfig /flushdns

改完还是回调失败的话，通常是本机的网络环境把发往 127.0.0.1 的请求也拦下来了。这属于你自己电脑上的网络配置问题，需要按你所用软件的说明处理——这一步我们无法代劳，也不提供相关配置建议。

第四步：授权

claude

浏览器打开授权页，登录、点 Allow，回到 PowerShell 看到欢迎信息即成功。

第五步（可选）：换个好用的终端

前面一直用的 PowerShell 黑窗口能用但不好用。Windows Terminal 是微软官方的现代终端，多标签、可配色，占用也低（30–50 MB）。

Windows 11 已自带；Windows 10 去 Microsoft Store 搜「Windows Terminal」装。

装好后把默认环境改成 Git Bash：打开「终端」→ 顶部标签栏右侧的 ∨ → 「设置」（或 Ctrl + ,）→ 左侧「启动」→「默认配置文件」选 Git Bash → 保存。

以后打开终端直接就在 Git Bash 里，敲 claude 就能用。

外观想调的话，Ctrl + , →「默认值」→「外观」：

装完之后

自检

claude doctor

这个命令不会启动会话，只打印安装状态、配置文件的语法错误和建议修复项。装完跑一次，之后遇到怪问题也先跑它。

更新

用官方脚本装的会自动后台更新，不用管。想立刻更新：

claude update

Homebrew、WinGet、Linux 包管理器装的不会自动更新，需要手动。

稳定版还是最新版

默认跟的是 latest 通道，新功能第一时间到。如果你更看重稳定，可以切到 stable（大约落后一周，会跳过有明显回退的版本）：/config → Auto-update channel，或写进 ~/.claude/settings.json：

{
  "autoUpdatesChannel": "stable"
}

一个建议

装完先别急着上手真活儿。找一个不要紧的文件夹，让它做件小事——比如「把这个目录下的文件按类型整理一下」——看它怎么动手、怎么问你、怎么报告结果。

Claude Code 的默认行为是直接改文件，不是给建议。先在无关紧要的地方看清楚这一点，比在真项目上第一次发现要好得多。