个人claude code使用记录持续更新文章目录一、claude code相关基础背景概念1、claude code诞生背景---AI 模型能力已远超 代码补全 产品形态2、claude code是什么---Anthropic推出面向开发者AI编程Agent3、claude code同类型对比与适用场景---更工程化适合大型项目构建重构问题排查二、claude code工作逻辑1、claude code基础工作流程---收集信息-采取行动-验证结果2、claude code上下文管理—知识按需加载、子代理上下文隔离、三层上下文压缩3、claude code可执行能力—工具热注册、Skill 文件系统、插件与扩展架构4、claude code任务分解调度—TodoWritenag、子任务委托、DAG任务图、后台异步执行、多Agent团队5、claude code硬约束与闭环反馈—路径沙箱、操作审批门控、Shutdown 握手三、claude code基础使用操作1、claude code命令输入方式2、claude code常用基础命令3、claude code 项目目录结构四、claude code的扩展机制1、SKILL---特定任务按固定流程做事操作说明书参考一、claude code相关基础背景概念1、claude code诞生背景—AI 模型能力已远超 “代码补全” 产品形态Claude Code 并非 Anthropic 规划已久的大项目而是由工程师Boris Cherny在 2024 年 9 月启动的个人实验。他最初只是想做一个简单的 API 测试工具帮助自己处理音乐播放列表却意外发现大模型能力远超当时的 “代码补全” 产品形态。Anthropic团队敏锐发现AI 模型能力已超越现有产品形态具备直接编写完整代码、处理复杂工程任务的潜力。2、claude code是什么—Anthropic推出面向开发者AI编程AgentClaude Code是 Anthropic 于 2025 年推出的终端原生 AI 编程智能体核心定位是全链路工程助手而非简单的代码补全工具Claude Code 的核心目标是理解你的整个项目并参与到真实的编码、修改和重构过程中。Claude Code 代表了 AI 编程工具的下一代范式—— 从 “被动补全” 到 “主动执行”从 “代码片段” 到 “项目全局”。它的核心优势在于超长上下文理解、终端原生体验和自主执行能力使其在处理复杂工程任务时远超同类产品。3、claude code同类型对比与适用场景—更工程化适合大型项目构建重构问题排查claude code相对同类型产品比较1定位从从 “补全工具” 到 “工程伙伴”能完成从需求到部署的全流程工作2超长上下文100 万 token 的 “全景视角”一次性处理数十万行代码自动构建完整项目地图3在复杂问题解决能力上领先其他工具4-14 个百分点SWE-bench Verified尤其擅长处理需要深度逻辑推理和架构理解的任务。简单来说优势大型项目重构、复杂 BUG 排查、工程级自动化、全局架构理解目前全球第一劣势轻量化日常补全、图形化交互、国内原生网络体验、上手门槛不如传统工具。二、claude code工作逻辑Claude Code 就像一个超级聪明的编程搭档它能在你的电脑上自动帮你写代码、改 bug、运行命令、搜索文件……几乎所有你在终端里能做的事它都能干。Claude Code基本框架如下Claude Code一个 agent loop 工具(bash, read, write, edit, glob, grep, browser...) 按需 skill 加载 上下文压缩 子 agent 派生 带依赖图的任务系统 异步邮箱的团队协调 worktree 隔离的并行执行 权限治理1、claude code基础工作流程—收集信息-采取行动-验证结果当你给 Claude 一个任务时它会像人类一样循环思考三个步骤1收集上下文看你的代码、文件、错误信息2采取行动编辑文件、运行命令、搜索等3验证结果检查是否成功哪里还需要调整。这三个步骤会不断循环直到任务完成当然我们也可以随时可以打断它、给新指示或者说换个方法试试。2、claude code上下文管理—知识按需加载、子代理上下文隔离、三层上下文压缩Claude Code 的上下文窗口大小为 1,000,000 tokens100 万 token。它容纳了 Claude 在当前会话中看到的一切内容Claude Code 针对对话上下文容易无限膨胀、信息杂乱冗余的问题做了三层精细化管控设计1知识按需加载不会把所有技术规范、项目规则、开发清单等知识一次性全部塞入固定提示词而是采用模块化知识与分层索引结构只在当前任务匹配到对应需求时才临时加载相关领域知识和项目详情避免无关信息占用上下文空间。2子代理上下文隔离每个子任务都会启用独立的会话消息空间专门负责代码检索、命令执行等中间操作任务完成后仅向上层返回精简摘要不会把子任务产生的大量文件内容、命令日志污染到主上下文。3三层上下文压缩面对长期开发产生的海量文件读取、命令执行记录设置递进式压缩机制从无感自动精简到主动人工规整把冗余对话信息移出活跃上下文并完整留存记录由模型自主完成内容凝练既控制上下文长度又不丢失关键业务信息。3、claude code可执行能力—工具热注册、Skill 文件系统、插件与扩展架构Claude Code 适配不同项目、不同开发场景的差异化需求搭建了一套可无限扩展的执行体系无需底层硬编码改造1工具热注册采用统一的映射调度机制新增命令行、代码检索等执行工具时只需补充对应处理逻辑和参数规则不用改动核心运行流程同时统一设置路径安全约束从底层规范所有工具的操作范围。2Skill 文件系统将各类行业规范、项目开发知识做成可插拔的模块化文件和普通执行工具共用一套调用逻辑可随取随用实现知识的灵活加载与复用。3插件与扩展架构支持标准化外部服务协议MCP接入、第三方插件集成能够无缝对接浏览器控制、数据库查询、外部接口调用等能力统一调用调度规则实现多元外部功能的快速接入。4、claude code任务分解调度—TodoWritenag、子任务委托、DAG任务图、后台异步执行、多Agent团队面对复杂多步骤开发任务Claude Code 具备完善的任务拆分、排序与并行调度能力避免任务遗漏、跑题或串行低效1任务目标锁定提醒内置任务清单管理机制TodoWrite同一时段仅聚焦单个进行中任务防止多线混乱nag机制若多轮对话无任务推进会主动注入提醒信息强制锚定开发目标避免重复工作和偏离需求。2子任务委托执行自动将大型复杂任务拆解为多个细小子任务分派给独立子代理处理上层只关注最终结果屏蔽中间繁琐执行过程实现任务逻辑解耦。3结构化任务依赖编排摒弃简单平面任务清单采用DAG持久化任务关系图可定义任务间先后依赖、并行执行关系合理排布开发流程适配真实项目复杂的工序逻辑。4后台异步执行对依赖安装、镜像构建、批量测试等耗时操作采用后台线程异步运行不阻塞主线开发流程实现多类工作同步推进提升整体效率。5多代理分工隔离多角色代理协同分工处理不同类型工作同时为并行任务分配独立工作空间避免多任务操作互相篡改文件、产生环境冲突。5、claude code硬约束与闭环反馈—路径沙箱、操作审批门控、Shutdown 握手Claude Code 从架构层面设置硬性边界同时建立完整操作反馈闭环规避越界风险、规范操作流程1路径沙箱约束在文件操作底层统一设置安全路径校验规则从机制上限制文件读写、修改的范围无论指令如何构造都无法跳出指定工作目录杜绝误删、乱改跨目录文件的问题。2操作审批闭环针对删除核心文件、高危命令执行、变更关键配置等高风险操作设置统一的审批流程若操作被驳回会同步返回明确反馈依据引导重新调整方案形成拒绝、优化、再提交的完整闭环。3优雅退出握手机制不会直接强制终止运行进程而是通过标准化交互指令通知相关代理在任务节点自然收尾退出避免突然中断导致文件写入不完整、配置状态错乱等问题。三、claude code基础使用操作安装了 Claude Code 及配置好 API 后在任何目录打开cmd输入claude登陆claude code1、claude code命令输入方式2、claude code常用基础命令一个项目的典型开发流程进入项目执行 /init 完成初始化开发新功能时启用 EnterPlanMode先探索代码、输出设计方案审批通过后再进行功能实现通过 TaskCreate 拆解为用户登录、表单验证、编写测试等细分任务代码提交前执行安全审查并使用 simplify 工具优化代码质量随后执行 git 暂存提交创建 GitHub PR最后定时每 3 分钟查看 PR 状态监控 CI 校验运行情况。# 1. 项目启动/init# 分析项目结构自动生成 CLAUDE.md/resume# 恢复上一次会话按目录管理首次之后可以用resume恢复之前会话# 2. 日常会话管理/clear# 清空当前对话历史重新开始/compact# 压缩上下文释放 token 空间并保留关键摘要!shell命令# 在终端直接执行命令结果返回到对话中# 3. 编码辅助/mention# 引用文件或目录到对话上下文中/todos# 查看/管理当前会话的任务列表EnterPlanMode# 进入计划模式探索代码库→设计方案→等待审批后实现TaskCreate# 拆解复杂任务为步骤跟踪执行进度/fast# 切换快速模式Opus 4.6 独占输出提速# 4. 代码审查/review# 审查当前分支 PR/security-review# 对当前分支变更做安全审查simplify(skill)# 代码质量审查自动修复复用性、效率类问题# 5. 自动化与定时任务/loop间隔命令# 定时重复执行命令例/loop 5m /reviewCronCreate# 创建一次性/可重复持久化 cron 定时任务CronList# 列出所有定时任务CronDelete# 删除指定定时任务# 6. Git 与分支管理/worktree# 创建隔离 git worktree临时分支安全实验ghprcreate# 通过 GitHub CLI 创建 Pull Requestghprview# 查看 PR 详情gh api# 调用 GitHub API操作 issues、评论等# 7. 配置与个性化/config# 交互式修改主题、默认模型等设置/statusline# 配置终端状态栏展示内容/permissions# 管理工具权限策略允许/拒绝指定操作update-config(skill)# 直接编辑 settings.json 配置环境与权限keybindings-help(skill)# 自定义键盘快捷键及和弦绑定/upgrade# 升级 Claude Code 至最新版本# 8. 特定领域技能通过 /skill-name 调用扩展 Claude Code 的能力。claude-api(skill)# Claude API 开发、模型版本迁移适配fewer-permission-prompts(skill)# 生成权限白名单减少授权弹窗# 9. Shell 快捷技巧拖拽文件到终端# 自动填充文件路径供 Claude Code 读取管道输入# echo 问题描述 | claude 管道交互式调用3、claude code 项目目录结构一个典型的 Claude Code 项目目录结构如下your-project/ ├── CLAUDE.md ← 团队共享指令提交到git├── CLAUDE.local.md ← 个人覆盖被git忽略 └── .claude/ ├── settings.json ← 权限 配置提交到git├── settings.local.json ← 个人权限被git忽略 ├── commands/ ← 自定义斜杠命令 │ ├── review.md → /project:review │ ├── fix-issue.md → /project:fix-issue │ └── deploy.md → /project:deploy ├── rules/ ← 模块化指令文件全局生效 │ ├── code-style.md │ ├── testing.md │ └── api-conventions.md ├── skills/ ← 自动调用的工作流 │ ├── security-review/ │ │ └── SKILL.md │ └── deploy/ │ └── SKILL.md └── agents/ ← 子代理角色定义 ├── code-reviewer.md └── security-auditor.md四、claude code的扩展机制1、SKILL—特定任务按固定流程做事操作说明书skill是Anthropic于25年推出的Claude扩展机制并快速被其他厂商跟进。Agent Skills 本质上是一个模块化的 Markdown 文件能教会 AI 工具 如 Claude、GitHub Copilot等 执行特定任务且支持自动触发、团队共享与工程化管理彻底告别重复的提示词输入。核心形式一个 Skill 就是一个文件夹里面必须有一个 SKILL.md 文件包含说明和元数据可选其他资源文件如脚本、示例、参考文档。SKILL的优势1可复用流程固话可以重复稳定使用2可分享相互传递安装SKILL包3可自动触发Claude可以根据description自动判断是否调用也能手动运行my-skill/ ├── SKILL.md# 必需指令 元数据├── scripts/# 可选可执行代码├── references/# 可选文档资料└── assets/# 可选模板、资源通用SKILL.md典型内容如下Claude SKILL有更多关键字 如 是否支持自动触发等参考官方文档https://code.claude.com/docs/zh-CN/overviewCLI 命令参考官方文档https://code.claude.com/docs/en/cli-reference斜杠命令大全官方文档https://code.claude.com/docs/en/commands5分钟安装ClaudeCode并接入DeepSeekhttps://www.bilibili.com/video/BV1KjoxBoEQJClaude Code 入门教程https://www.runoob.com/claude-code/claude-code-tutorial.htmllearn-claude-code项目https://github.com/shareAI-lab/learn-claude-code/blob/main/README-zh.md开源地址https://github.com/anthropics/claude-code手把手教你在Claude Code中熟练使用SKILL技能https://www.bilibili.com/video/BV1BFouBYERu/