面向开发者的 Claude Code 上手教程，从安装到实战，学会用自然语言在终端里操作代码库。
Claude Code 是 Anthropic 推出的终端编程代理工具，适合日常在终端里工作的开发者。它能理解你的代码库，用自然语言帮你改代码、跑任务、处理 git 流程。本文从安装开始，带你跑通第一个例子，再聊常用操作和实战场景。
Claude Code 是一个运行在终端里的智能编程助手。它不是简单的代码补全，而是能理解整个项目结构，通过对话方式完成具体任务。
它能做的事包括：
执行重复性任务，比如批量替换、格式化代码
解释复杂代码，快速理解别人写的模块
处理 git 工作流，比如提交、分支操作
在终端、IDE 里使用，也可以在 GitHub 上 @claude 让它参与讨论
和传统 IDE 插件相比，Claude Code 的优势在于它不依赖编辑器，直接在终端里工作，和你的命令行工作流无缝衔接。你不需要切换窗口，也不用复制粘贴代码，直接说需求就行。
Claude Code 需要 Node.js 18 或更高版本。安装前先确认你的环境：
node -v如果版本低于 18，先去 Node.js 官网升级。
官方推荐用脚本安装：
curl -fsSL https://claude.ai/install.sh | bash也可以用 Homebrew：
brew install --cask claude-codeWindows 用户推荐用 PowerShell 脚本：
irm https://claude.ai/install.ps1 | iex或者用 WinGet：
winget install Anthropic.ClaudeCode早期版本可以用 npm install -g @anthropic-ai/claude-code 安装，但官方已经弃用这种方式。如果你之前用 npm 装过，建议卸载后改用上面的方式。卸载命令以官方文档为准。
安装完成后，验证一下：
claude --version能输出版本号就说明装好了。
找个项目目录，比如一个你正在开发的 Web 应用：
cd ~/my-project
claude启动后你会进入一个交互式对话界面。第一次运行可能需要登录授权，按提示操作即可。
先问一个简单的问题：
这个项目是做什么的？Claude Code 会扫描项目文件，然后给你一个概括性的回答。如果项目里有 README 或配置文件，它会结合这些内容解释。
再试一个具体任务：
解释一下 src/utils.js 里的函数分别有什么用它会读取文件，逐个函数给你说明。这就是第一个能跑通的例子，不需要写任何代码，用自然语言就能和代码库对话。
在交互界面里，直接输入中文或英文描述你的需求。比如：
“给所有组件文件加上版权注释”
“找出测试覆盖率最低的模块”
“把这段代码改成 async/await 风格”
Claude Code 会分析代码并给出修改建议，有些操作会直接改文件，改动前通常会有确认提示。
Claude Code 支持斜杠命令，比如 /bug 可以直接在工具内反馈问题。输入 / 会弹出可用命令列表，具体命令以官方文档为准。
除了终端，Claude Code 也能在 IDE 里用。官方文档提供了集成方式，你可以在编辑器里直接调用它，不用切到终端。具体配置方法见官方文档。
在 GitHub 的 issue 或 PR 中 @claude，可以让它参与代码讨论。比如你在 PR 里 @claude 让它 review 代码，它会根据上下文给出意见。这个功能适合团队协作时使用。
Claude Code 能处理 git 工作流。你可以直接说：
把当前所有改动提交，提交信息写“修复登录页样式问题”它会帮你执行 git add、git commit 等操作。也可以让它创建分支、合并分支，甚至处理冲突。注意，涉及破坏性操作时它会先跟你确认。
Claude Code 支持插件机制，官方仓库里带了一些插件，可以扩展自定义命令和代理。你可以查看 plugins 目录下的文档，了解有哪些现成插件，或者自己写插件。
接手老项目时，最头疼的是看不懂历史代码。你可以把整个目录交给 Claude Code，让它梳理模块关系：
帮我画出这个项目的模块依赖关系，标出核心入口它会分析 import 和 require，给出结构说明。这比人肉翻代码快得多。
让 Claude Code 做批量替换时，建议先让它列出改动计划，再逐步执行。比如：
把项目里所有 var 改成 let 或 const，先告诉我涉及哪些文件这样能避免误改。
假设你有一个 Node.js 项目，最近加了一个新功能，但测试一直不过。你可以这样用 Claude Code：
启动工具：
cd ~/my-node-app
claude让它定位问题：
运行 npm test，看看哪些测试失败了，分析原因Claude Code 会执行测试命令，读取输出，然后告诉你失败原因。
让它修复：
根据失败信息修复代码，确保所有测试通过它会修改相关文件，然后重新跑测试。如果还有问题，你可以继续追问。
提交代码：
测试通过了，帮我提交这次修改，提交信息写“修复测试失败问题”整个流程都在终端里完成，不用切编辑器，也不用记 git 命令。
再举个例子，你想给项目加一个新接口。可以这样描述：
在 routes/user.js 里新增一个 GET /user/profile 接口，返回当前登录用户的信息，参考现有接口的写法Claude Code 会模仿现有代码风格，生成对应的路由和处理逻辑。
如果你在 MacOS/Linux 上运行 curl -fsSL https://claude.ai/install.sh | bash 时报错，先检查网络能不能访问 claude.ai。国内网络可能需要代理。另外，确认当前用户对安装目录有写权限。
如果运行 claude 时提示需要 Node.js 18+，用 node -v 查看版本。如果版本低，去官网下载新版，或者用 nvm 切换：
nvm install 18
nvm use 18如果你之前用 npm install -g @anthropic-ai/claude-code 安装，现在可能会看到弃用警告。建议卸载后改用官方脚本安装。卸载命令和详细步骤见官方 setup 文档。
第一次运行 claude 时，如果卡在登录界面，检查终端是否支持交互式链接。有些终端需要手动复制链接到浏览器打开。
Claude Code 会收集使用数据，包括代码接受/拒绝情况、对话数据，以及通过 /bug 提交的反馈。官方有数据使用政策，敏感信息有保留期限限制，反馈数据不会用于模型训练。如果你在意隐私，可以查阅官方数据使用文档。
遇到任何 bug，可以在工具内输入 /bug 反馈，或者到 GitHub 仓库提交 issue。也可以加入 Claude Developers Discord 社区求助。
这篇教程带你完成了 Claude Code 的安装、第一个对话、常用操作和实战流程。核心要点是：在终端里用自然语言描述需求，让它理解代码库并执行任务。
下一步建议：找一个你手头的小项目，试着用 Claude Code 完成一次代码解释或 git 提交。遇到问题就查官方文档，或者用 /bug 反馈。
官方文档地址：https://code.claude.com/docs/en/overview
评论 (0)
暂无评论，来发表第一条评论吧