Claude Code（Anthropic）
一句话定位：Anthropic 官方的终端 AI 编码助手，理解整个代码库、跨文件改代码、跑命令、做 Git 自动化；支持 VS Code / Cursor 扩展与独立桌面 App。 适用场景：终端里直接让 AI 改代码 / 跑测试 / 提 PR；需要 Agent 模式自动读文件、跑命令、写改动；接入 MCP server 扩展能力。
一、前置依赖
- 系统：macOS 10.15+ / Linux / Windows（原生或 WSL2）
- Node.js 18+，4GB+ RAM
- 稳定网络
- Windows 原生需先装 Git for Windows（WSL2 不需要）
- 账号：Claude Pro / Max / Teams / Enterprise 或 Anthropic Console API 账号
二、安装步骤
macOS / Linux / WSL
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
其他安装方式
brew install --cask claude-code # macOS Homebrew（稳定频道，约落后一周）
winget install Anthropic.ClaudeCode # Windows WinGet
⚠️
npm install -g @anthropic-ai/claude-code官方已弃用，请用上面原生安装方式。 Homebrew 有两个 cask：claude-code（稳定频道）与claude-code@latest（最新频道）；两者均不自动更新，需手动brew upgrade。
三、最小可用配置
进入项目目录启动：
cd your-project
claude
首次会引导登录（Anthropic API 或 Claude Pro/Max 订阅），浏览器完成即本地保存凭据。
初始化项目（生成项目记忆）：
claude> /init
验证安装：
claude --version
四、国内环境坑
- 账号 / Key：Anthropic 在国内访问受限，登录与 API 可能需要代理或海外环境。
- Git for Windows：Windows 原生必须装 Git for Windows；WSL2 无需但体验亦可。
- Node 版本：低于 18 会报错，先
node --version检查，用 nvm 升级：
nvm install 18 && nvm use 18
五、常见报错 → 解决
| 现象 | 解决 |
|---|---|
claude: command not found |
重载 shell；确认安装成功；Homebrew 装后 brew upgrade claude-code |
| Node 版本过低 | nvm install 18 && nvm use 18 |
| npm 全局权限问题 | mkdir ~/.npm-global && npm config set prefix '~/.npm-global'，并把 ~/.npm-global/bin 加入 PATH |
| 更新 | 原生安装后台自动更新；Homebrew brew upgrade claude-code；WinGet winget upgrade Anthropic.ClaudeCode |
六、实测状态
🟡 文档核验（2026-08-11）：安装命令与步骤取自 Anthropic 官方文档，尚未在本机沙箱实跑验证。后续由站点 CI 定时实跑并更新徽章。
七、官方链接
- 官方文档（快速开始）：https://code.claude.com/en/quickstart
- 安装 / 高级设置：https://code.claude.com/en/setup
- 故障排查：https://code.claude.com/en/troubleshooting
踩坑交流 / 1v1 配置，加微信 hhummingg
踩坑交流 / 1v1 配置，加微信 hhummingg