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 用 TerminalWindows 可以用 PowerShell长期开发更推荐 WSL。如果你计划走 API 接入后面所有 API 示例统一用https://code.ai80.vip/官方脚本安装macOS、Linux、WSLcurl-fsSLhttps://claude.ai/install.sh|bashWindows PowerShellirmhttps://claude.ai/install.ps1|iexWindows CMDcurl -fsSL https://claude.ai/install.cmd -o install.cmd install.cmd del install.cmdHomebrewbrewinstall--caskclaude-codeWinGetwinget install Anthropic.ClaudeCode安装完成后验证claude--version看到类似下面的输出就说明安装成功2.1.81 (Claude Code)npm 安装为什么不优先推荐npm 方式现在不是首选只有你明确需要这种方式时再用。先确认 Node.jsnode--version再安装npminstall-ganthropic-ai/claude-code claude--version如果安装慢可以切换国内镜像npminstall-ganthropic-ai/claude-code--registryhttps://registry.npmmirror.com更新 Claude Codeclaudeinstall或者claude update通过 Homebrew 或 WinGet 安装时需要用对应包管理器更新brew upgrade claude-codewinget upgrade Anthropic.ClaudeCode常见安装问题npm command not found通常是没有安装 Node.js。去 nodejs.org 安装后重新执行命令。permission deniedmacOS/Linux 可以加 sudosudonpminstall-ganthropic-ai/claude-codeWindows 右键 PowerShell选择“以管理员身份运行”。安装速度很慢如果走 npm可以用npminstall-ganthropic-ai/claude-code--registryhttps://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 PowerShellRemove-Item-Path$env:USERPROFILE\.local\bin\claude.exe-ForceRemove-Item-Path$env:USERPROFILE\.local\share\claude-Recurse-ForceHomebrewbrew uninstall--caskclaude-codeWinGetwinget uninstall Anthropic.ClaudeCodenpmnpmuninstall-ganthropic-ai/claude-code如果要彻底删除配置和历史记录rm-rf~/.clauderm~/.claude.jsonrm-rf.clauderm-f.mcp.json这一步不可恢复执行前确认清楚。常见问题Q: 新手先用 Web 还是 CLIA: 体验用 Web真实开发用 CLI。Q: Windows 推荐 PowerShell 还是 WSLA: 能用 PowerShell但长期开发更推荐 WSL。Q: 国内怎么更省事地用A: 国内用户如果卡在官方账号、支付或网络环境上可以通过 Code80 更方便地使用涉及 API 的地方统一把 endpoint 配成https://code.ai80.vip/Key 使用 Code80 控制台生成的即可。