Claude Code安装使用教程：终端AI编程助手入门与实操详解

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 用终端），验证：

bash 复制代码

node -v
npm -v
git --version

能输出版本号就说明环境 OK。

2. 全局安装 Claude Code

在终端执行：

bash 复制代码

npm install -g @anthropic-ai/claude-code

等待安装完成。

3. 验证安装

输入：

bash 复制代码

claude --version

能输出版本号就说明装好了。

4. 登录

进入你的项目目录，运行：

bash 复制代码

claude

第一次会引导你登录，用浏览器打开链接，用 Claude 账号（Pro/Max 订阅）授权即可。

5. 基本用法

进入项目目录后启动交互模式：

bash 复制代码

claude

然后直接用自然语言描述任务，比如"帮我看看这个报错"。

其他常用启动方式：

bash 复制代码

claude "修复构建错误"      # 执行一次性任务
claude -c                  # 继续当前目录上一次对话
claude -p "解释这个函数"   # 执行完查询就退出

6. 常用斜杠命令

在交互界面里输入：

text 复制代码

/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、教程