字
字节笔记本
2026年2月23日
Claude Code 原生安装与卸载完全指南（2025最新）
本文介绍 Claude Code 最新的原生安装方式，包括 macOS 和 Windows 系统的安装与完整卸载步骤。相比 npm 安装，原生安装更加轻量、启动更快，且无需 Node.js 环境。
安装
macOS
原生安装（推荐，无需 Node.js）
bash
curl -fsSL https://claude.ai/install.sh | bash安装完成后验证：
bash
claude --version
claude doctor # 检查安装状态npm 安装（已不推荐，但仍可用）
需要 Node.js 18+，注意不要加 sudo：
bash
npm install -g @anthropic-ai/claude-codeWindows
原生安装（PowerShell，推荐）
以普通用户权限打开 PowerShell，执行：
powershell
irm https://claude.ai/install.ps1 | iexWSL 安装（Ubuntu 等）
在 WSL 终端内运行与 macOS 相同的命令：
bash
curl -fsSL https://claude.ai/install.sh | bashWSL 2 支持沙盒功能，WSL 1 不支持，推荐使用 WSL 2。
首次登录
安装后运行 claude，会提示打开浏览器进行 OAuth 授权，使用 Claude.ai 账号登录（需要 Pro/Max 订阅或 API Key）。
卸载
macOS / Linux / WSL
第一步：删除二进制文件
bash
rm -f ~/.local/bin/claude
rm -rf ~/.local/share/claude第二步（可选）：删除配置和缓存
bash
rm -rf ~/.claude
rm -f ~/.claude.json
rm -rf ~/.local/state/claude
rm -rf ~/.config/claude如果在项目目录下有项目级配置：
bash
rm -rf .claude
rm -f .mcp.json如果是 npm 安装的，先执行：
bash
npm uninstall -g @anthropic-ai/claude-codeWindows（原生安装）
第一步：删除二进制文件
powershell
Remove-Item -Path "$env:USERPROFILE\.local\bin\claude.exe" -Force
Remove-Item -Path "$env:USERPROFILE\.local\share\claude" -Recurse -Force第二步（可选）：删除配置
powershell
Remove-Item -Path "$env:USERPROFILE\.claude" -Recurse -Force
Remove-Item -Path "$env:USERPROFILE\.claude.json" -Force
Remove-Item -Path "$env:APPDATA\claude-code" -Recurse -Force -ErrorAction SilentlyContinue
Remove-Item -Path "$env:LOCALAPPDATA\claude-code" -Recurse -Force -ErrorAction SilentlyContinue注意事项
混装问题：如果之前用 npm 或 Homebrew 装过，再用原生安装容易产生冲突。建议完整卸载旧版后再重装。遇到奇怪的报错（如 segfault），大多数情况下彻底清除后重新原生安装即可解决。
自动更新：原生安装版本会在启动时自动检查并在后台静默更新，无需手动维护。
从 npm 迁移到原生：直接运行 claude install 即可完成迁移。
分享: