AI编程正在从“辅助写代码”走向“参与完成任务”，而Claude Code 正是这一趋势下的代表工具。它通过自然语言与开发者协作，能够理解项目、修改代码并执行操作，让编程方式发生根本变化。本书围绕这一变化，手把手教你从零上手并高效使用Claude Code。 全书共6章，按照“认知—搭建—操作—进阶—复用—实战”的逻辑逐步展开。第1章从基础认知入手，帮助读者理解Claude Code的本质、能力边界及其与传统工具的区别；第2章聚焦国内环境，详细讲解安装配置和常见错误排查，确保可以稳定使用该工具；第3章进入核心操作层面，系统地讲解交互方式、项目管理、Git协作及调试测试等高频功能；第4章重点提升效率，通过CLAUDE.md、上下文管理、提示词工程与自动化命令，让AI真正“听懂你”；第5章深入讲解Skills系统，帮助读者将一次性操作沉淀为可复用能力，构建个人或团队级AI工具体系；第6章通过多个真实案例，完整地呈现AI在代码重构、Bug排查、测试生成与项目开发中的实际应用流程。 本书内容通俗易懂、重在实操，适合开发者及AI爱好者阅读，帮助你把AI真正变成提升效率的“代码助手”。

第1章　认识Claude Code 1 1.1　什么是Claude Code 2 1.1.1　终端里的智能程序员：与聊天机器人、IDE插件的本质区别 2 1.1.2　核心能力全景：代码理解、跨文件编辑、命令行操作、Git集成 3 1.2　Claude Code的典型用途与边界 5 1.2.1　典型用途：重构、调试、测试生成、项目导航、自动化脚本 5 1.2.2　主要局限：业务逻辑误判、依赖误判、上下文限制及人工审阅 7 第2章　国内环境搭建与配置 10 2.1　环境准备 11 2.1.1　安装Node.js 11 2.1.2　安装Git 13 2.1.3　安装Claude Code 14 2.1.4　设置环境变量：Linux/macOS/Windows永久生效的方法 21 2.1.5　常见错误排查：401、Connection refused、Timeout解决方案 23 2.2　首次启动与页面预览 27 2.2.1　首次启动与主题选择 28 2.2.2　基础指令速查：/help、/clear、exit等 30 第3章　基础操作与核心功能 33 3.1　启动与运行模式 34 3.1.1　一次性任务：claude -p "query"快速执行 34 3.1.2　继续对话：claude -c恢复最近会话 34 3.1.3　恢复历史：claude -r选择历史对话 36 3.2　核心交互技巧 37 3.2.1　使用自然语言下达指令：从“修复Bug”到“实现接口” 37 3.2.2　Claude Code常用快捷键 39 3.2.3　中断操作：按Esc停止AI当前任务 41 3.2.4　图片处理：粘贴截图让Claude分析UI或错误界面 42 3.3　文件与项目管理 43 3.3.1　让Claude理解项目结构：扫描目录、分析依赖 43 3.3.2　单文件修改：如何精确指定修改位置 45 3.3.3　跨文件协同修改：统一配置、重命名变量、迁移代码 46 3.3.4　实战：将散落的配置整合为单一YAML文件 48 3.3.5　风险控制：修改前必须执行的Git操作 53 3.4　Git与命令行操作 54 3.4.1　自然语言操作Git：创建分支、提交、推送、解决冲突 54 3.4.2　执行Shell命令：安装依赖、启动服务、批量处理 57 3.4.3　权限控制：默认请求确认与--dangerously-skip-permissions模式 59 3.4.4　Safe YOLO模式：何时使用及风险警示 60 第4章　进阶技巧与效率提升 62 4.1　CLAUDE.md：项目级AI记忆体 63 4.1.1　CLAUDE.md的作用：让AI记住技术栈、代码风格、规范 63 4.1.2　CLAUDE.md的典型内容结构 64 4.1.3　多级配置：项目根、子目录、用户全局、本地覆盖 67 4.2　会话管理与上下文控制 69 4.2.1　清除聊天上下文：/clear的使用时机 69 4.2.2　上下文压缩：/compact减少token占用 70 4.2.3　恢复历史会话：/resume切换不同的对话 71 4.3　提示词工程——让AI更懂你 72 4.3.1　XML标签结构化提示：、、 73 4.3.2　预激活：先让AI学习再动手（阅读模块→总结→执行） 75 4.3.3　强制深度思考：think harder、ultrathink、step-by-step reasoning 75 4.3.4　提供清晰的需求文档：功能点、接口定义、边界条件 77 4.3.5　输出多个方案：让AI提供优缺点对比 78 4.4　自定义命令 79 4.4.1　用户级命令：~/.claude/commands/（通用） 79 4.4.2　项目级命令：.claude/commands/（专用） 81 4.5　MCP（模型上下文协议）简介 83 4.5.1　添加MCP服务：连接Postgres、网页、图像处理等 83 4.5.2　管理MCP：claude mcp list、get、remove 86 4.6　并行任务处理：Git Worktrees 87 4.6.1　什么是Git Worktrees：同一仓库多分支独立工作区 88 4.6.2　创建新Worktree并启动独立的Claude Code会话 90 4.6.3　管理Worktrees：列出、删除、环境初始化 92 第5章　Skills系统——让AI能力可复用 94 5.1　Skills是什么 95 5.1.1　从“一次性指令”到“可复用资产”：Skills的核心价值 95 5.1.2　用Skills替代MCP：减少token消耗的新思路 97 5.1.3　Skills vs其他自定义功能（CLAUDE.md、Slash commands、Subagents） 98 5.2　Skills的存储与加载机制 100 5.2.1　四层存储位置：Personal、Project、Plugin、Enterprise 100 5.2.2　物理结构：每个Skill对应一个目录，核心是SKILL.md文件 103 5.2.3　按需加载机制：先加载元数据，匹配后才加载完整指令 106 5.3　Skills的生命周期管理 108 5.3.1　创建Skills：手动编写SKILL.md文件 108 5.3.2　加载Skills：重启Claude Code或使用调试模式验证 109 5.3.3　触发Skills：Claude Code根据用户意图自动匹配description 110 5.3.4　调试Skills：使用claude --debug查看加载日志 112 第6章　实战案例全流程解析 114 6.1　案例一：Python项目配置系统重构 115 6.1.1　需求描述与现状分析 115 6.1.2　让Claude Code扫描项目并给出重构方案 116 6.1.3　人工审阅 118 6.1.4　测试验证与问题修复 120 6.1.5　经验总结：如何安全高效地使用AI重构 123 6.2　案例二：WebSocket偶发断连问题定位 124 6.2.1　问题复现与日志分析 125 6.2.2　将相关模块交给Claude Code审查 127 6.2.3　修复问题与验证 129 6.3　案例三：为老项目自动生成单元测试 130 6.3.1　项目背景 130 6.3.2　编写Prompt：指定测试框架、覆盖率目标 130 6.3.3　处理生成的测试代码：调整与集成 131