切换深色模式
基础入门
欢迎来到 Claude Code 基础入门模块。
Claude Code 是 Anthropic 推出的 AI 编程助手，适合在终端、IDE、桌面应用或网页环境中辅助开发者完成代码理解、功能开发、Bug 修复、测试、重构、提交和代码审查等任务。
如果你是第一次接触 Claude Code，不需要一开始就理解所有高级概念。你只需要先掌握：
- Claude Code 是什么
- 如何安装和启动
- 如何让它理解你的项目
- 如何让它安全地修改代码
- 如何配置项目规则
- 如何使用常用命令
- 如何避免新手常见错误
这个模块适合谁？
本模块适合 Claude Code 新手、前端开发者、后端开发者、全栈工程师、AI 产品经理、技术团队负责人，以及希望把 AI 编程助手引入实际项目的人。
本模块你会学到什么？
完成本模块后，你应该能够：
- 理解 Claude Code 和普通聊天式 AI 的区别
- 在本地项目中启动 Claude Code
- 让 Claude Code 阅读和解释代码库
- 让 Claude Code 做一次安全的小修改
- 理解 Claude Code 的基础工作方式
- 配置
CLAUDE.md项目说明文件 - 理解
.claude/settings.json的作用 - 管理权限、模型、环境变量等基础配置
- 使用
/init、/memory、/permissions、/plan、/model等常用命令 - 建立适合自己的 Claude Code 使用流程
推荐学习顺序
| 顺序 | 文章 | 适合解决的问题 |
|---|---|---|
| 1 | Claude Code 快速开始 | 从安装到第一次使用，完成第一个真实任务 |
| 2 | Claude Code 基础理论 | 理解 Claude Code 为什么能读代码、改文件、跑命令 |
| 3 | Claude Code 配置 | 学会配置 CLAUDE.md、settings.json、权限和环境变量 |
| 4 | Claude Code 常用命令与高效操作 | 掌握终端命令、斜杠命令和常见开发工作流 |
学习建议
如果你是第一次使用 Claude Code，建议不要跳过「快速开始」。
Claude Code 能直接读取和修改项目文件，因此比普通聊天机器人更需要理解权限、安全和 Git 工作流。
Claude Code 和普通 Claude 聊天有什么区别？
很多人已经用过 Claude 或 ChatGPT 这类聊天式 AI，但 Claude Code 的定位不同。
| 对比项 | 普通 Claude 聊天 | Claude Code |
|---|---|---|
| 使用场景 | 问答、写作、解释、总结 | 编程开发、代码修改、项目自动化 |
| 是否能读取项目文件 | 通常需要你手动上传或粘贴 | 可以在项目目录中读取代码库 |
| 是否能修改文件 | 通常不能直接改本地文件 | 可以在授权后编辑文件 |
| 是否能运行命令 | 通常不能直接运行本地命令 | 可以在授权后运行 shell 命令 |
| 适合任务 | 解释代码、生成片段 | 开发功能、修 Bug、写测试、重构、提交 |
| 风险 | 回答可能错误 | 回答错误 + 文件修改风险 + 命令执行风险 |
简单理解：
普通 Claude 更像一个聊天顾问，Claude Code 更像一个能进入项目现场工作的 AI 编程助理。
Claude Code 适合做什么？
Claude Code 特别适合以下任务：
- 阅读陌生代码库
- 解释项目结构
- 查找某个功能的实现位置
- 修复 Bug
- 添加小功能
- 批量修改代码
- 写单元测试
- 生成文档
- 重构函数
- 修复 lint 问题
- 处理 Git 提交
- 生成提交信息
- 做代码审查
- 分析错误日志
- 自动化重复开发任务
例如：
请先阅读这个项目结构，告诉我它的主要模块分别负责什么。请帮我修复这个登录页的报错。先分析原因，不要直接改代码。请为 auth 模块补充单元测试，运行测试并修复失败用例。请检查当前 diff，指出可能的 Bug 和安全风险。Claude Code 不适合做什么？
Claude Code 很强，但不适合无约束地做所有事情。
不建议直接让它：
- 在没有 Git 备份的项目中大范围修改
- 操作生产环境数据库
- 删除重要文件
- 处理未脱敏客户数据
- 读取
.env、密钥、凭证文件 - 自动合并复杂分支
- 直接部署生产环境
- 修改安全、支付、权限相关代码后不做人工审查
- 在你不理解变更的情况下提交代码
重要提醒
Claude Code 可以编辑文件和执行命令。新手使用时，建议先让它「分析和计划」，再确认是否允许它修改代码。
基础入门的核心心智模型
学习 Claude Code，不要把它只当成“更会写代码的聊天机器人”。
更准确的心智模型是：
Claude Code = AI 编程助手 + 项目上下文 + 工具调用 + 权限控制 + 开发工作流它的典型工作方式是：
你描述目标
↓
Claude Code 阅读项目文件
↓
它分析代码结构
↓
它制定修改计划
↓
你确认计划
↓
它修改文件
↓
它运行测试或检查
↓
你审查结果
↓
提交代码新手最应该掌握的 5 个习惯
1. 先让它读项目，不要直接改
不推荐：
帮我把登录功能改好。推荐：
请先阅读项目结构和登录相关代码，告诉我登录流程是怎么实现的。暂时不要修改文件。2. 大任务先进入计划模式
复杂任务不要直接让 Claude Code 执行。
推荐：
请先制定实现方案，列出你打算修改哪些文件、为什么修改、风险是什么。等我确认后再开始改代码。3. 每次只做一个明确任务
不推荐：
帮我优化整个项目。推荐：
请只优化 src/utils/date.ts 这个文件的可读性，保持功能不变，并补充必要测试。4. 让它运行验证
Claude Code 的优势之一是可以结合测试、lint、类型检查等工具验证结果。
例如：
修改完成后，请运行 npm test 和 npm run lint。如果失败，请先解释原因，再尝试修复。5. 最终一定要人工审查
无论 Claude Code 输出看起来多合理，正式合并前都应该人工检查：
- diff 是否符合预期
- 是否误删代码
- 是否引入安全问题
- 是否影响已有功能
- 是否通过测试
- 是否符合团队规范
本模块之后应该学什么？
完成基础入门后，可以继续学习：
| 目标 | 推荐模块 |
|---|---|
| 想写出更好的 Claude Code 指令 | 提示工程基础 |
| 想掌握高效开发流程 | 工作流实战 |
| 想管理大型任务 | Plan Mode、Subagents、并行任务 |
| 想接入外部工具 | MCP |
| 想自动化团队规范 | Hooks、Skills |
| 想用于企业团队 | 权限、安全、团队配置 |
| 想深入开发者能力 | Claude API 与 Agent SDK |
最小学习路径
如果你时间不多，可以只先学习这三篇：
1. Claude Code 快速开始
2. Claude Code 配置
3. Claude Code 常用命令与高效操作学完后，你就能在真实项目里开始安全使用 Claude Code。
完整学习路径
如果你希望系统入门，建议按下面顺序学习：
1. Claude Code 快速开始
2. Claude Code 基础理论
3. Claude Code 配置
4. Claude Code 常用命令与高效操作完整学完后，再进入提示工程、工作流、MCP、Hooks、Skills、Subagents 等进阶模块会更顺畅。
小结
Claude Code 的基础入门重点不是记住所有命令，而是建立正确的使用方式。
你需要先掌握三件事：
- 让 Claude Code 理解项目
- 让 Claude Code 先计划再修改
- 让 Claude Code 的变更经过测试和人工审查
当你能安全完成一次「阅读项目 → 制定计划 → 修改代码 → 运行验证 → 审查 diff」的流程时，就已经具备了使用 Claude Code 的基础能力。