Claude Code 从零安装完整教程：CLI、登录、卸载和第一次启动
写在前面
第一次上手 Claude Code，最容易卡住的不是“会不会写代码”，而是环境怎么装、账号怎么登录、第一次启动以后该问什么。很多人装完就直接让它改项目，结果权限、目录、上下文都没搞清楚，体验自然不稳定。
这篇只解决一件事：从零把 Claude Code 跑起来。你会知道 Web、CLI、编辑器集成怎么选，CLI 怎么装，登录怎么做，第一次会话怎么启动，出问题时怎么排查。
先选使用方式
| 方式 | 适合人群 | 优点 | 缺点 |
|---|---|---|---|
| Web 端 | 完全新手 | 无需安装，打开浏览器即可使用 | 功能相对有限，无法深度集成本地代码 |
| CLI 命令行 | 有一定基础的开发者 | 功能完整，集成度高，最接近 Claude Code 的设计初衷 | 需要熟悉命令行操作 |
| 编辑器集成 | 日常开发者 | 融入 VS Code、Cursor、JetBrains 等工作流 | 依赖插件和本地环境配置 |
如果只是体验 Claude 的对话能力，Web 端最快；如果你准备让它真正读项目、改文件、跑命令，CLI 是最值得优先学习的入口。
不过说实话，官方账号、海外支付和网络环境对国内用户并不总是友好。如果你只是想把 Claude Code 稳定接进日常开发，可以看看 Code80，真实订阅帐号转 API，换个 endpoint 就能用，体验更接近官方，也少折腾账号和网络问题。
安装前准备
安装 Claude Code CLI 前，先准备两样东西：
- Claude 账号。已经在用 Claude 网页版聊天的话，可以直接跳过注册。
- 命令行工具。macOS/Linux 用 Terminal，Windows 可以用 PowerShell，长期开发更推荐 WSL。
如果你计划走 API 接入，后面所有 API 示例统一用：
https://code.ai80.vip/官方脚本安装
macOS、Linux、WSL：
curl-fsSLhttps://claude.ai/install.sh|bashWindows PowerShell：
irmhttps://claude.ai/install.ps1|iexWindows CMD：
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmdHomebrew：
brewinstall--caskclaude-codeWinGet：
winget install Anthropic.ClaudeCode安装完成后验证：
claude--version看到类似下面的输出，就说明安装成功：
2.1.81 (Claude Code)npm 安装为什么不优先推荐
npm 方式现在不是首选，只有你明确需要这种方式时再用。先确认 Node.js：
node--version再安装：
npminstall-g@anthropic-ai/claude-code claude--version如果安装慢，可以切换国内镜像：
npminstall-g@anthropic-ai/claude-code--registry=https://registry.npmmirror.com更新 Claude Code
claudeinstall或者：
claude update通过 Homebrew 或 WinGet 安装时，需要用对应包管理器更新：
brew upgrade claude-codewinget upgrade Anthropic.ClaudeCode常见安装问题
npm command not found
通常是没有安装 Node.js。去 nodejs.org 安装后重新执行命令。
permission denied
macOS/Linux 可以加 sudo：
sudonpminstall-g@anthropic-ai/claude-codeWindows 右键 PowerShell，选择“以管理员身份运行”。
安装速度很慢
如果走 npm，可以用：
npminstall-g@anthropic-ai/claude-code--registry=https://registry.npmmirror.com登录 Claude Code
进入项目目录后启动：
claude首次启动会引导你登录。也可以在界面里输入：
/login支持 Claude Pro、Max、Teams、Enterprise，也支持 Claude Console 账号。使用 Console 账号时，系统会自动创建一个名为 Claude Code 的工作区，用于跟踪 API 使用成本。
启动第一次会话
cd/path/to/your/project claude启动后会看到欢迎界面。
查看帮助：
/help恢复之前中断的对话：
/resume输入/会弹出命令补全列表。
第一次代码修改
建议先建一个测试目录，不要直接动生产项目：
mkdirrunoob-testcdrunoob-test claude进入界面后输入：
在 test.py 文件中添加 hello world 函数Claude Code 会展示 diff，执行前请求确认。选择 yes 后才会写入文件。
修改流程通常是：定位文件、展示 diff、请求批准、执行编辑。新手一定要先看 diff，再批准。
卸载 Claude Code
官方脚本安装：
rm-f~/.local/bin/clauderm-rf~/.local/share/claudeWindows PowerShell：
Remove-Item-Path"$env:USERPROFILE\.local\bin\claude.exe"-ForceRemove-Item-Path"$env:USERPROFILE\.local\share\claude"-Recurse-ForceHomebrew：
brew uninstall--caskclaude-codeWinGet：
winget uninstall Anthropic.ClaudeCodenpm：
npmuninstall-g@anthropic-ai/claude-code如果要彻底删除配置和历史记录：
rm-rf~/.clauderm~/.claude.jsonrm-rf.clauderm-f.mcp.json这一步不可恢复，执行前确认清楚。
常见问题
Q: 新手先用 Web 还是 CLI？
A: 体验用 Web，真实开发用 CLI。
Q: Windows 推荐 PowerShell 还是 WSL？
A: 能用 PowerShell，但长期开发更推荐 WSL。
Q: 国内怎么更省事地用？
A: 国内用户如果卡在官方账号、支付或网络环境上，可以通过 Code80 更方便地使用；涉及 API 的地方统一把 endpoint 配成https://code.ai80.vip/，Key 使用 Code80 控制台生成的即可。
)
