本文使用 Mac 进行演示。主要是在安装环节有环境差异。1. Claude Code 简介Claude Code 是 Anthropic 推出的面向开发者的 AI 编程协作工具。Claude Code 的核心目标是理解你的整个项目并参与到真实的编码、修改和重构过程中。Claude Code 不是一个代码生成器而是一个能读项目、懂上下文、遵守约束的 AI 编程工具。它不是网页里的聊天框而是直接在你的终端(Terminal)里运行,读取你整个项目的代码理解文件之间的关系直接修改代码文件执行你的指令并给出建议。2. Claude Code 特性上下文感知不仅理解单个文件而是理解整个项目结构工程化导向关注可维护性、规范、测试而不是一次性代码可定制行为通过 Skills技能包让 AI 遵守你的规则最底层还是模型的能力Claude Code 只是一个 CLI 工具2.1. Claude Code 核心能力全局上下文感知不仅能读单个文件还能理解整个项目的结构、文件间的依赖关系及架构。工程级代码修改可以直接读取并修改代码文件如批量替换var为let、拆分函数、添加错误处理而不仅仅是给出建议。深度分析与解释能结合上下文解释代码逻辑、排查报错原因及分析性能瓶颈。可定制行为 (Skills)通过“技能包”将团队的编码规范、注释要求、测试标准等固化下来让 AI 自动遵守。局限性不能替用户做最终技术决策不能保证 100% 无 Bug无法理解未明确说明的业务语义3. 安装教程3.1. 安装 Claude Code使用官方脚本curl -fsSL https://claude.ai/install.sh | bashmac 安装npm install -g anthropic-ai/claude-code安装后验证claude --version3.2.Coding Plan订阅目前是学习阶段、可以找一个性价比当前最高的。好多模型都没有优化价格、另外有一些优惠的模型也需要限时抢购。下面选择一个性价比当前最高的https://maas.xfyun.cn/packageSubscription 讯飞星火模型其他模型有对应的配置接下来就配置该模型。具体配置方式配置 Claude Code配置文件路径~/.claude/settings.json{ env: { ANTHROPIC_AUTH_TOKEN: 您的Coding Plan API Key, ANTHROPIC_BASE_URL: https://maas-coding-api.cn-huabei-1.xf-yun.com/anthropic, CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC: 1, API_TIMEOUT_MS: 600000, ANTHROPIC_MODEL: astron-code-latest, ANTHROPIC_SMALL_FAST_MODEL: astron-code-latest }, permissions: { allow: [], deny: [] } }重新打开一个新的终端使环境变量配置生效通过上面步骤就完成了 Claude Code 的配置。接下来就开始练习如何使用。3.3. 在各种工具中安装 Claude Code 插件如果不习惯 Claude Code 的命令行模型可以在 VS Code 编辑器中安装 Claude Code。在 VS Code 中安装 Claude Code 插件上面就是在 VS Code 安装好了 Claude Code 插件。下面是三种权限模式正常模式默认Claude 每次要操作前都会先问你同不同意。Plan Mode计划模式Claude 先告诉你它打算怎么做得到你批准后才动手修改。自动接受模式Claude 直接编辑不再每次询问其他一些小功能直接用提到文件或文件夹可以拖拉文件到对话框关于其执行环境与界面环境默认在本地运行拥有最高权限。也支持在云端虚拟机或远程环境中运行。界面可以在多种界面中使用如命令行终端、VS Code 扩展、JetBrains IDE 插件等其底层工作原理完全相同。4. 使用教程4.1. 基础命令命令描述其他esc 键执行推出/resume恢复刚才的对话/列出所有命令/clear清除会话/cost查看当前会话消耗防止无意识烧 Token/compact压缩上下文/reset切换任务时非常重要/review检查 Git 暂存区改动4.2. 键盘快捷键分类快捷键/操作核心功能常规控制CtrlC取消当前输入/生成CtrlD退出会话CtrlL清屏保留历史CtrlO切换详细输出显示工具执行日志CtrlR反向搜索命令历史OptionP/AltP切换模型不清空提示文本编辑CtrlK/CtrlU删除到行尾/删除整行删除内容可粘贴CtrlY粘贴CtrlK/CtrlU删除的内容AltB/AltF光标按单词前后移动需 Meta 键配置主题显示CtrlT切换代码块语法高亮仅/theme菜单内有效多行输入\Enter / ShiftEnter换行输入ShiftEnter 在 iTerm2/WezTerm 等终端免配置CtrlJ多行换行符快速命令/开头触发斜杠命令详见斜杠命令文档!开头直接运行 Bash 命令输出计入会话触发文件路径自动补4.3. 检查点Claude 修改文件前会自动备份。只要按两次Esc或说撤销刚才的修改就能回到之前状态4.4. 创建一个静态网站项目案例创建一个项目上面使用工具完成了一个小项目。可以直接使用 git 进行管理。4.5. git 管理Claude Code 本身是一个基于终端的 AI 助手它可以直接执行 shell 命令包括git# 初始化仓库 git init # 添加所有文件 git add . # 提交更改 git commit -m Initial commit # 查看状态 git status # 创建分支并切换 git checkout -b feature/new-feature # 推送代码到远程仓库 git push origin main提示你可以直接在 Claude Code 中输入类似“请帮我提交当前目录的所有更改”它会自动生成并执行对应的 git 命令5. Claude Code 的工作逻辑5.1.核心工作机制代理循环Claude Code 的核心是一个代理循环。当你给它一个任务时它不会只给出一段代码建议而是会像人类程序员一样自主地、循环地执行以下步骤直到任务完成收集上下文读取你的项目文件、代码、错误日志等全面理解当前状况。采取行动根据理解规划并执行具体操作如编辑文件、运行终端命令、搜索信息等。验证结果检查上一步行动的结果判断任务是否成功或哪里还需要调整。这个“思考 → 行动 → 验证”的循环会不断重复形成一个自主规划和执行的闭环使其能够处理复杂的多步骤任务这个循环由两个关键部分驱动模型和工具5.1.1.模型Claude 的大脑功能负责理解代码、进行复杂推理、规划任务步骤。它能理解项目整体结构并将一个大目标拆解成可执行的小步骤。模型选择Sonnet适合日常编码速度快性价比高。Opus适合处理特别复杂的架构设计和深度推理任务。国内模型切换由于官方模型在国内访问可能不便可以通过配置环境变量或启动命令将底层模型替换为 DeepSeek、阿里通义千问等国内模型。5.1.2.工具Claude 的双手工具赋予了 Claude Code 实际操作的能力让它不再仅仅是“纸上谈兵”。主要内置工具包括文件操作读取、修改、创建、重命名文件。(项目的文件夹和所有子文件)搜索在项目中按文件名或正则表达式查找代码。执行命令在终端运行npm、git、测试脚本、启动服务器等。当前git状态、分之、未提交修改、提交历史等网络搜索查询在线文档或错误信息。代码智能与语言服务器协议LSP集成实现查看类型错误、跳转定义等功能。一个典型的修复Bug的流程就是这些工具的协同工作运行测试 → 阅读错误日志 → 搜索相关文件 → 理解代码逻辑 → 修改代码 → 再次运行测试验证。进阶扩展可以用 skills技能、MCP外部服务、hooks自动化、subagents子助手等能力。5.1.3. Claude 的能力CLAUDE.md文件可以写项目专属规则让 Claude 每次都记住; 重要规则写进CLAUDE.md)MEMORY.md 自动记录能力记住项目习惯。上下文Claude 有上下文容量限制当快满时它会自动压缩旧内容可以输入/compact手动压缩输入/context查看当前占用情况,用 skills 和 subagents 减少不必要的上下文占用5.2.灵活的会话操作Claude Code 提供了三种会话管理方式让你能灵活地继续工作或尝试新方案恢复会话使用claude --continue或claude --resume命令可以从上次中断的地方无缝继续完整恢复聊天历史。分叉会话使用claude --continue --fork-session命令可以基于当前对话历史创建一个全新的、独立的会话。这在你想尝试另一种实现方案又不想影响原有对话时非常有用。多终端共享会话可以在多个终端窗口中同时使用同一个会话但需谨慎操作以避免冲突6. 项目应用6.1. 项目初始化 init/init命令的核心作用是为当前项目创建一个名为CLAUDE.md的持久化配置文件。这个文件相当于给 Claude Code 提供了一份专属的“项目说明书”或“长期记忆”确保它在每次会话中都能理解项目的背景、结构和规范。CLAUDE.md 文件详解当你在项目根目录下执行/init命令后Claude Code 会自动分析你的代码库并生成一个CLAUDE.md文件。这个文件通常包含以下内容项目描述项目的目标和主要功能。技术栈使用的编程语言、框架和核心库。代码风格项目的命名约定、缩进规则等编码偏好。架构模式项目的目录结构和关键模块的组织方式。工作流程如测试、构建、提交等常用命令和规范。主要优势建立上下文让 Claude Code 在开始工作前就快速理解整个项目的结构无需在每次对话中重复解释。保持一致性确保 Claude 生成的代码或建议始终遵循项目既定的代码风格和架构模式。提升效率显著减少重复性的上下文设置让开发者能更专注于核心业务逻辑的开发。使用建议首次使用建议在开始一个新项目或首次使用 Claude Code 处理一个现有项目时立即运行/init命令。动态更新CLAUDE.md文件并非一成不变。你可以随时通过自然语言与 Claude 对话要求它更新或完善这份说明书例如“请将‘使用 Jest 进行测试’这条规则添加到 CLAUDE.md 中”。团队协作将生成的CLAUDE.md文件提交到代码仓库可以帮助团队新成员或其他开发者快速了解项目规范实现开发环境的一致性。6.2. 项目结构一个典型的 Claude Code 项目目录结构如下CLAUDE.md 放置在项目根目录所有团队成员共享它告诉 Claude这个项目是什么、如何运行、有什么约定CLAUDE.local.md 存放只与你本人相关的偏好或临时指令不应共享给团队。比如本地调试的数据库连接信息等.claude/settings.json -- 权限与配置中心团队共享的配置文件控制 Claude允许或禁止执行哪些操作作为团队安全基线。比如禁止命令 “rm -rf *”.claude/commands/ -- 自定义斜杠命令目录下每个.md文件自动映射为一条/project:文件名命令。.claude/commands/是团队将重复性任务标准化的核心机制.claude/rules/-- 模块化行为规则,将 CLAUDE.md 中的规则拆分模块化存放Claude 在整个会话中始终遵守。适合存放长期稳定执行的行为约定避免 CLAUDE.md 过于臃肿.claude/skills/-- 自动调用的工作流,Skills 是更高级的复合工作流。当 Claude 判断某个任务适合某个 skill 时会自动读取并执行对应的 SKILL.md无需手动调用。每个 skill 是一个子目录目录内包含SKILL.md.claude/agents/ -- 子代理角色,定义可被主 Claude 实例派遣的专业子代理。在复杂任务中主代理将子任务委派给对应专家角色实现多代理协作。子代理在隔离上下文中运行拥有独立的权限范围。6.3. Claude Code 交互模式三大核心交互模式Ask、Plan、EditAsk 是搞清楚问题Plan 是避免走弯路Edit 是谨慎执行。Claude 很强但依然可能产生错误或幻觉。Claude Code 根据任务性质引入了三种思维模式开发者需在 Prompt 中明确意图系统会自动或手动切换模式Claude Code 根据任务性质引入了三种思维模式开发者需在 Prompt 中明确意图系统会自动或手动切换模式。6.3.1.Ask 模式只看不动只读分析定位默认安全模式如同“双手放在背后的高级工程师”。适用场景看不懂代码、接手新项目、定位 Bug 原因、确认逻辑合理性。特点可读取和分析代码但绝不修改文件或执行 Shell 命令。示例指令“解释一下 src/auth.ts 里的 JWT 验证流程”。6.3.2.Plan 模式谋定后动只规划定位架构师思维模式核心价值是“先写代码变成先达成共识”。适用场景新增核心模块、重构接口、引入新技术如缓存、涉及多文件改动。特点不直接改代码先给出完整实施方案通常为步骤列表/TODO需用户确认后才执行。示例指令“我想给现有 API 增加 Redis 缓存层请先给我一个实施方案”。Plan 模式用得越多返工概率就越低。6.3.3.Edit 模式直接执行可写代码定位动手执行阶段用户角色是“代码的最终审查者”。适用场景改动目标明确、风险可控知道改哪里、改成什么样。特点生成精确 Diff可能请求执行测试/构建命令所有写入需用户确认。示例指令“把登录接口的响应码从 200 改为 201”。7. 操作应用7.1./执行内置操作比如/cost7.2.引用具体文件、代码或目录7.3.!-- Bash 命令通过在输入前加上!直接运行 bash 命令无需通过 Claude8. 用法不要把它当成简单的聊天机器人而要把它视为一位执行力极强、但需要明确约束的工程师。原则提问越模糊回答越泛泛提问越具体背景、目标、约束产出越精准8.1.场景一学代码 (像导师一样请教)Claude Code 擅长把复杂概念讲清楚关键在于设定“受众”和“深度”。新手视角的解释错误问法“这段代码什么意思”容易得到跳过细节的总结正确问法“假设我是刚学 Python 的新手请用通俗易懂的方式逐行解释这个函数的执行流程。”强制其减少术语使用类比方案对比与审美培养用法当你觉得代码“能跑但不够好”时要求它提供 2-3 种实现方式进行对比如当前写法 vs 函数式写法。收益从可读性、性能、扩展性三个维度建立代码审美。逐行拆解复杂逻辑用法针对复杂的if/else或状态机要求“逐行解释输入、输出和副作用”并指出潜在的 Bug 点。8.2.️ 场景二写代码 (像架构师一样描述)写代码时切忌直接追求完美应从小而确定的需求开始明确输入、输出和约束。高质量的需求描述公式输入是什么 输出是什么 约束条件如不依赖第三方库。示例“写一个 Python 函数输入邮箱字符串输出布尔值。要求不依赖第三方库仅使用正则。”边界控制明确告诉它模块的职责边界例如“只负责数据转换不处理 IO”防止过度设计。生成测试用例强烈推荐让 Claude 参考项目现有的测试风格补充单元测试覆盖正常情况和边界情况。这是初学者养成的最好习惯之一。8.3.️ 场景三改代码 (像资深同事一样审查)修改代码比写新代码更难核心原则是“控制变量”即明确什么能改什么绝对不能动。安全重构关键指令“在不改变现有逻辑/行为的前提下重构这个函数。”目标重命名变量、拆分逻辑块、消除重复代码。提升可读性指令“哪些地方可以加注释或拆成小函数请帮我把这个长函数拆分成职责清晰的模块。”统一风格指令“按照当前项目的风格规范统一这几个文件的格式、命名和结构不要改动逻辑。”8.4.终极提问模板 (建议收藏)为了限制 Claude 的“自由发挥”如自动补全功能或过度重构请养成使用结构化提问的习惯背景我现在在做什么上下文目标我希望达到什么效果约束不能做什么 / 必须遵守什么例如不要引入新库、不要改变函数签名输出要求代码 / 解释 / 步骤9. Claude Code MCP 能力MCPModel Context Protocol是 Claude Code 连接本地环境与外部世界的桥梁。如果说基础版 Claude 是一个被隔离的“代码顾问”那么配置了 MCP 的 Claude 则进化为拥有“手和脚”的全能工程师——它能直接读写你的本地文件、操作数据库、甚至控制浏览器。MCP 本质上是一个标准化的通信协议。它允许 Claude Code 安全地连接到本地服务器或远程 API从而获取上下文信息并执行操作。9.1. 核心价值本地化能力不再局限于对话框能直接访问你的项目文件、Git 仓库和系统日志。工具扩展通过安装不同的 MCP 服务器赋予 Claude 操作数据库、浏览器或第三方服务如 GitHub、Slack的能力。标准化无论是连接 PostgreSQL 还是调用 Fetch API都遵循统一的配置格式。9.2. 场景描述场景一、浏览器自动化利用 Puppeteer 让 Claude 具备“眼睛”能进行网页测试或数据抓取。功能网页截图、DOM 操作、自动化测试。配置命令claude mcp add puppeteer -s user -- npx -y modelcontextprotocol/server-puppeteer实战用途“打开这个 URL截图首页并分析 CSS 布局问题”、“帮我抓取这个页面的所有 H2 标题”。场景二、数据库直连让 Claude 直接查询数据无需通过中间层。功能执行 SQL 查询、管理表结构以 PostgreSQL 为例。配置命令claude mcp add postgres -s user -e DATABASE_URLpostgresql://user:passlocalhost/db -- npx -y modelcontextprotocol/server-postgres实战用途“查询最近一小时内注册的用户数量”、“帮我生成一个迁移脚本来添加user_status字段”。9.3. 管理MCPMCP 的配置通常存储在~/.claude.json或项目级的.claude/mcp.json中。常用管理命令查看已安装服务claude mcp list移除服务claude mcp remove server_name测试连接claude mcp test server_nameMCP 是 Claude Code 从“玩具”走向“生产力”的关键一步。通过简单的配置你可以将 Claude 嵌入到你的开发工作流中让它不仅能“写代码”还能“跑代码”、“测代码”和“管代码”10. 记忆系统Claude Code 的记忆系统并非简单的“聊天记录保存”而是一套精密的分层记忆架构。它让 Claude 从一个每次重启都“归零”的聊天机器人进化为能够随着时间推移、不断积累项目知识与用户偏好的“长期结对编程伙伴”10.1. CLAUDE.md你给 Claude 的“家规”性质由用户手动编写的指令文件。用途定义项目规范、代码风格、构建命令等“硬性规则”。位置通常位于项目根目录或用户全局配置目录。示例内容“本项目使用pnpm而非npm”、“所有组件必须使用 TypeScript 编写”。10.2. MEMORY.mdClaude 自己的“工作笔记”性质由Claude 自动创建并维护的笔记本。用途记录跨会话的动态知识如调试经验、架构决策背后的原因、用户临时表达的偏好。机制Claude 会在工作中自动判断哪些信息值得保存并写入该文件。示例内容“上次修复 Bug #123 时发现数据库连接池需配置为 10”、“用户喜欢用简短的英文提交信息”。核心区别CLAUDE.md是你告诉 Claude该怎么做。MEMORY.md是 Claude 记录已经学到了什么10.3. 上下文即资源上下文窗口是稀缺资源Claude Code 采用了精细化管理策略。压缩机制使用/compact命令可将冗长的对话历史压缩为结构化摘要释放空间并重新加载核心记忆。查看状态使用/context查看当前窗口占用情况使用/memory检查已加载的记忆文件。子智能体记忆隔离当 Claude 调用子智能体处理复杂任务时子智能体拥有独立的记忆目录~/.claude/agent-memory/。这确保了子任务的调研过程不会污染主会话的记忆任务结束后仅回传摘要与结论。10.4. 最佳实践各司其职将团队共识写入CLAUDE.md让 Claude 自动积累经验到MEMORY.md。保持精简定期检查MEMORY.md删除错误或过时的记录避免“噪音”干扰。隐私保护使用CLAUDE.local.md存储私有的本地配置如测试数据路径并将其加入.gitignore。适度原则记忆并非越多越好。精准、清晰的记忆比海量的堆砌更能提升 Claude 的表现11. 材料参考菜鸟教程https://www.runoob.com/claude-code/claude-code-intro.html官方文档https://code.claude.com/docs/en/overview中文文档https://code.claude.com/docs/zh-CN/overviewGithub 开源https://github.com/anthropics/claude-code12. 最后总结本文档详尽介绍了 Anthropic 推出的 AI 编程代理工具 Claude Code。内容涵盖其安装配置含国内模型替代方案、核心特性全局上下文感知、工程化修改、工作逻辑代理循环、交互模式Ask/Plan/Edit及项目应用。文档还阐述了其记忆系统、MCP 扩展能力及与 Git 的集成旨在指导开发者利用该工具进行高效的代码理解、编写与重构。到此结束、感谢阅读。