Claude Code 从零安装完整教程：CLI、登录、卸载和第一次启动

Claude Code 从零安装完整教程：CLI、登录、卸载和第一次启动

写在前面

第一次上手 Claude Code，最容易卡住的不是“会不会写代码”，而是环境怎么装、账号怎么登录、第一次启动以后该问什么。很多人装完就直接让它改项目，结果权限、目录、上下文都没搞清楚，体验自然不稳定。

这篇只解决一件事：从零把 Claude Code 跑起来。你会知道 Web、CLI、编辑器集成怎么选，CLI 怎么装，登录怎么做，第一次会话怎么启动，出问题时怎么排查。

先选使用方式

如果只是体验 Claude 的对话能力，Web 端最快；如果你准备让它真正读项目、改文件、跑命令，CLI 是最值得优先学习的入口。

不过说实话，官方账号、海外支付和网络环境对国内用户并不总是友好。如果你只是想把 Claude Code 稳定接进日常开发，可以看看 Code80，真实订阅帐号转 API，换个 endpoint 就能用，体验更接近官方，也少折腾账号和网络问题。

安装前准备

安装 Claude Code CLI 前，先准备两样东西：

1. Claude 账号。已经在用 Claude 网页版聊天的话，可以直接跳过注册。
2. 命令行工具。macOS/Linux 用 Terminal，Windows 可以用 PowerShell，长期开发更推荐 WSL。

如果你计划走 API 接入，后面所有 API 示例统一用：

https://code.ai80.vip/

官方脚本安装

macOS、Linux、WSL：

curl-fsSLhttps://claude.ai/install.sh|bash

Windows PowerShell：

irmhttps://claude.ai/install.ps1|iex

Windows CMD：

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Homebrew：

brewinstall--caskclaude-code

WinGet：

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-code

winget upgrade Anthropic.ClaudeCode

常见安装问题

npm command not found

通常是没有安装 Node.js。去 nodejs.org 安装后重新执行命令。

permission denied

macOS/Linux 可以加 sudo：

sudonpminstall-g@anthropic-ai/claude-code

Windows 右键 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/claude

Windows PowerShell：

Remove-Item-Path"$env:USERPROFILE\.local\bin\claude.exe"-ForceRemove-Item-Path"$env:USERPROFILE\.local\share\claude"-Recurse-Force

Homebrew：

brew uninstall--caskclaude-code

WinGet：

winget uninstall Anthropic.ClaudeCode

npm：

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 控制台生成的即可。