Claude Code 是 Anthropic 推出的 AI 编程助手,运行在终端里,不是图形化编辑器插件。本文记录从零开始怎么安装、怎么登录、常用命令有哪些,以及它和 Cursor、GitHub Copilot 的区别,最后附上常见问题。
环境:Windows/macOS/Linux,需要 Node.js。
一、工具介绍
Claude Code 是 Anthropic 开发的终端型 AI 编程 agent。你用自然语言告诉它要做什么,它会自己读代码、改文件、跑命令、看报错结果。
2026 年它的默认模型是 Claude Sonnet 5,旗舰是 Opus 5,上下文窗口达到 100 万 token。它和普通代码补全工具的区别是:补全工具一次看一个文件,Claude Code 能理解整个项目。
它解决的问题是:接手老项目看不懂代码、要排查疑难 bug、要做大范围跨文件重构。
二、为什么选择它
- 理解整个代码库
它可以自己翻相关文件、顺着调用链找问题,不需要你一个文件一个文件贴给它。
- 自主排查 bug
你说哪里报错,它自己复现、跑测试、根据报错改代码、再跑一遍验证,把整个流程在终端里跑完。
- 跨文件大重构
批量把旧写法改成新写法、给一组文件统一加逻辑,它一次扫多个文件统一修改。
- 包含在订阅里
Claude Pro(20 美元/月)就包含 Claude Code,重度用上 Max(100 美元/月)。
三、安装教程
1. 准备环境
需要先装好两样东西:
- Node.js(自带 npm),官网 nodejs.com 下载 LTS 版;
- Git(Windows 上建议装),官网 git-scm.com 下载。
装完后打开终端(Windows 用 PowerShell 或命令提示符,Mac/Linux 用终端),验证:
node -v
npm -v
git --version
能输出版本号就说明环境 OK。
2. 全局安装 Claude Code
在终端执行:
npm install -g @anthropic-ai/claude-code
等待安装完成。
3. 验证安装
输入:
claude --version
能输出版本号就说明装好了。
4. 登录
进入你的项目目录,运行:
claude
第一次会引导你登录,用浏览器打开链接,用 Claude 账号(Pro/Max 订阅)授权即可。
5. 基本用法
进入项目目录后启动交互模式:
claude
然后直接用自然语言描述任务,比如"帮我看看这个报错"。
其他常用启动方式:
claude "修复构建错误" # 执行一次性任务
claude -c # 继续当前目录上一次对话
claude -p "解释这个函数" # 执行完查询就退出
6. 常用斜杠命令
在交互界面里输入:
/plan 先出执行计划,确认后再改,避免乱改
/diff 查看它改了哪些文件
/status 查看当前配置和登录状态
/clear 清空当前对话
/exit 退出
/fast 切换快速模式
四、实际使用体验
接手老项目时,直接问它"这个报错是怎么引起的",它会自己去翻相关文件顺着调用链找,不用你贴文件。
排查 bug 时,说"这个功能报错了帮我看看",它自己复现、跑测试、根据报错改代码、再跑验证,整个过程在终端里完成。
做大范围修改时,比如统一替换旧写法,它一次扫多个文件改完,再用 /diff 核对改了哪些地方。
需要注意的是:它没有图形化界面,要习惯命令行;开启后会自主跑命令,要信任它的权限范围。
五、常见问题
1. 安装时报 npm 命令找不到?
说明 Node.js 没装好或没加到环境变量,重装 LTS 版并重启终端。
2. claude 命令找不到?
npm 全局安装路径可能没进 PATH,重启终端试试;还不行就检查 npm root。
3. 登录不上?
确认是 Claude Pro/Max 订阅账号;国内网络环境可能需要自己解决访问问题。
4. 它会把代码传到哪里?
代码会发送到 Anthropic 处理,企业要注意数据合规。
5. 和 Cursor、Copilot 选哪个?
实时补全、图形界面选 Cursor 或 Copilot;理解整个老项目、自主排查 bug、跨文件重构选 Claude Code。
6. 不会命令行能用吗?
不太适合,它跑在终端里,需要基本命令行操作能力。
7. 免费吗?
不单独免费,包含在 Claude Pro(20 美元/月)里,重度用 Max(100 美元/月)。
六、优缺点总结
优点:
- 能理解整个代码库,不只是当前文件
- 自主复现 bug、跑测试、改代码
- 跨文件大重构能力强
- 包含在 Claude 订阅里,不用单独付费
- 终端原生,支持 SSH 和 CI/CD
不足:
- 没有图形化补全界面
- 需要命令行基础
- 没有免费独立版,用量大会触顶
- 单一模型锁定在 Anthropic
七、别乱装结论
推荐指数:4/5
适合:
- 经常接手看不懂的老项目
- 要做大范围重构和批量修改
- 习惯命令行,愿意让 AI 自主跑流程
- 需要 AI 排查疑难 bug
不适合:
- 主要写新代码要实时补全
- 不想碰命令行
- 只做小功能小改动
最终建议:Claude Code 把"AI 写代码"从"帮你补全一行"推到了"你说一句话它自己做完一个任务"。日常补全用 Cursor 或 Copilot,老项目和大改动用 Claude Code,按场景选。
标签:Claude Code、AI编程、Anthropic、终端、CLI、npm、代码补全、Cursor、Copilot、教程