Claude Code 入门:安装到第一次跑通,一步步带你上手
零基础学会安装 Claude Code 并在终端中使用 AI 助手,完成代码搜索、运行命令等基础操作。
准备环境:先装好 Node.js 和 npm
Claude Code 是一个命令行工具,运行在 Node.js(一个让 JavaScript 在电脑上运行的环境)之上。如果你没有安装 Node.js,请到 nodejs.org 下载 LTS 版本(长期稳定版)。安装完成后,打开终端(Mac 用“终端”应用,Windows 用 PowerShell 或 CMD),运行以下命令检查是否成功:
node --version应显示版本号(如 v18.x.x)npm --version应显示版本号(如 9.x.x)
如果提示“命令未找到”,说明 Node.js 没装好,请重新安装或重启终端。
安装 Claude Code:一行命令搞定
Claude Code 由 Anthropic 公司开发,可以理解你的整个项目代码。在终端中运行:
- 输入
npm install -g @anthropic-ai/claude-code并回车。这会从 npm 仓库下载并全局安装 Claude Code。 - 等待安装完成(可能需要几分钟,取决于网络)。
- 安装后,运行
claude --version验证是否成功,应显示版本号。
常见坑:Mac/Linux 用户如果遇到权限错误,请在命令前加 sudo(如 sudo npm install -g @anthropic-ai/claude-code)。Windows 用户建议以管理员身份运行终端。
第一次使用:让 Claude 帮你搜索文件
现在你已经装好了 Claude Code!打开一个你现有的项目文件夹(或新建一个空文件夹),在终端中进入该目录,然后输入 claude 并回车。首次运行会要求你登录 Anthropic 账号(免费注册即可),之后就可以开始对话了。
试试这些基础操作:
- 搜索文件:输入“帮我找到所有包含‘api’关键字的文件”。Claude 会自动搜索项目文件并列出结果。
- 运行命令:输入“运行 npm test”。Claude 会直接在终端执行该命令并返回结果。
- 解释代码:输入“解释 src/index.js 这个文件做了什么”。Claude 会读取文件内容并给出中文解释。
如果你没有项目,可以创建一个测试文件夹,在里面放一个简单的 hello.txt 文件,然后让 Claude 读取它。
下一步可以做什么?
Claude Code 还能做更多事,比如自动修复 bug、重构代码、分析项目架构。建议你先熟练上述基础操作,然后尝试:
- 让 Claude 为你生成一个新项目脚手架(如“帮我创建一个 React 项目”)
- 让 Claude 调试一段报错代码(把错误信息贴给它)
- 让 Claude 对比两个文件的不同
记住,Claude Code 是一个“代理型”AI,它能自主操作你的项目,所以使用时请确保代码已备份或使用版本控制(如 Git)。
内容来源
freeCodeCamp
发布时间
2026-05-15 01:30