Claude Code 小白上手教程告别繁琐的复制粘贴在终端里用自然语言直接操控你的代码库。 面向中文开发者 · 零基础入门 · 2026.07---一、Claude Code 是什么**Claude Code** 是 Anthropic 官方推出的基于终端CLI的 AI 编程助手。它不是你在网页上常见的聊天框——它直接运行在你的项目目录中能读取你的整个代码库、修改文件、运行命令、甚至帮你提交 Git 代码。简单说你在终端里跟它说话它帮你写代码。**Agent 架构**不像 Web 端那样只能一问一答Claude Code 有自主行动能力——你说帮我修这个 bug它会自己去读代码、定位问题、修改文件、运行测试确认修复。**项目理解**它能一次性看到你的整个项目结构而不是像 ChatGPT 那样只能一段段粘贴代码。**终端原生**直接在命令行工作和 Git、npm、测试框架等工具无缝配合。 **一句话总结** Claude Code 能看懂你整个项目的 AI 程序员同事坐在你的终端里随叫随到。---二、安装与环境配置2.1 前提条件**Node.js** v18安装 Node 时会自动带上 npm**Git**Claude Code 大量依赖 Git 来理解代码变更一个 **Anthropic 账号**用 Google 账号或邮箱注册即可没有 Node.js去 [nodejs.org](https://nodejs.org) 下载 LTS 版本安装即可。2.2 安装 Claude Code打开终端Mac 的「终端」或 Windows 的 PowerShell执行npm install -g anthropic-ai/claude-code安装完成后验证claude --version如果显示了版本号就说明安装成功了。2.3 身份认证首次使用需要登录你的 Anthropic 账号claude auth终端会弹出一个链接用浏览器打开它、登录授权即可。整个过程不需要手动填 API Key。 ⚠️ **关于费用** Claude Code 按消耗的 Token 量计费。注册 Anthropic 账号后会赠送一些免费额度试用。建议在 [Anthropic Console](https://console.anthropic.com) 的 Billing 页面设置好预算上限Usage Limits避免超额。---三、基本使用流程3.1 启动进入你的项目目录然后输入cd 你的项目路径 claude这时终端会进入 Claude Code 的交互界面你会看到提示符变成了▎表示它已经准备好听你指令了。3.2 第一次对话像跟人说话一样自然就好。例如这个项目的入口文件在哪里解释一下 src/utils.js 的作用帮我看看 package.json 里有哪些依赖Claude 会读取文件并给你清晰的回答。3.3 权限确认机制当 Claude Code 要修改文件或执行命令时它不会擅自行动——终端会弹出[y/N]确认提示并告诉你它打算做什么? Claude 想要修改文件 src/App.tsx - 在第 15 行添加一个 email 校验函数 允许执行(Y/n)**小白建议** 刚开始使用时仔细读一遍它要改什么确认没问题再敲回车。这个机制是个安全防护网。3.4 退出输入/exit或按Ctrl D即可退出。 **小技巧** 不需要每次退出了再进。直接在下一次终端输入新的指令即可Claude 会记住当前会话的上下文。---四、常用命令与快捷键Claude Code 提供了一些内置的斜杠命令快速完成常见操作| 命令 | 作用 ||------|------||/bug| 扫描当前项目自动检测并修复潜在的 Bug ||/review| 对当前未提交的代码变更做 Code Review ||/test| 自动编写或运行项目的单元测试 ||/clear| 清空对话历史释放上下文省 Token 的好方法 ||/help| 查看帮助文档和所有可用命令 ||/exit| 退出 Claude Code |常用快捷键**Ctrl C**取消当前操作**Ctrl D**退出交互界面**↑/↓**浏览历史命令---五、实战技巧5.1 提问要精准好指令 动词 目标 约束条件 ❌ **不要这样问** 帮我加个邮箱校验 ✅ **要这样问** 在src/utils/validation.ts中添加一个邮箱格式校验函数isValidEmail用正则实现并用 Jest 写 3 个测试用例正常邮箱、缺少 的邮箱、空字符串。越精确Claude 给你的代码就越接近你想要的结果。5.2 利用 Git 联动修改完代码后可以直接说帮我把刚才的修改提交到 Git写一个规范的 Commit Message。Claude Code 会自动执行git add和git commit并根据变更内容生成有意义的提交信息。5.3 复杂任务分步走遇到比较大的需求比如给博客加个评论功能先让 Claude 出方案我想给博客添加评论功能请先给出技术方案和实现步骤。看完方案确认没问题后再说好的按步骤 1 开始实现。这种先计划再执行的方式比让它一口气做完要可控得多。5.4 省 Token 小技巧定期使用 /clear 清空对话历史旧的上下文会一直消耗 Token在项目根目录配置好 .claudeignore 文件排除 node_modules、大日志文件等不必要的目录问完一个问题后如果不需要上下文了果断 /clear---六、新手避坑指南6.1 永远要审查 AI 写的代码Claude 写代码速度快但它也会犯错——逻辑漏洞、安全隐患、不合理的架构决策都有可能。任何 AI 生成的代码**必须**经过你运行和验证才能上线。一个好的习惯让 Claude 帮你写完代码后用/review命令再让它自己审查一遍。6.2 注意 Token 消耗避免在包含超大文件的项目里直接抛出模糊问题。比如在一个有 100 万行日志文件的项目中问帮我看看有什么问题——Claude 会试图读完整个文件Token 飞涨。建议先用.claudeignore排除大文件。6.3 保护敏感信息不要在对话中粘贴 API Key、数据库密码、.env文件内容等敏感信息。确保.env、*.pem等敏感文件已被.gitignore忽略——这些规则同样适用于 Claude Code 的读取范围。6.4 分清楚问和做Claude Code 是执行型工具不是纯问答工具。纯聊天问问题比如React 和 Vue 的区别更适合用 Web 版 Claude省 Token 且不影响你的项目上下文。Claude Code 最适合的是**直接操作项目代码**的场景。 **核心建议** 把 Claude Code 当成你的结对编程伙伴。它擅长执行具体任务你负责制定方向、审查结果、做关键决策。---写在最后AI 不会取代程序员但会用 AI 的程序员一定会取代不用 AI 的程序员。Claude Code 拉近了想到和做到之间的距离让你可以把精力更多地花在思考和设计上而不是在繁琐的实现细节里打转。现在就打开终端试试吧npm install -g anthropic-ai/claude-code别担心犯错——反正有 AI 帮你兜底。