claude code基础用法总结

个人claude code使用记录，持续更新

一、claude code相关基础背景概念

1、claude code诞生背景—AI 模型能力已远超 “代码补全” 产品形态

Claude Code 并非 Anthropic 规划已久的大项目，而是由工程师Boris Cherny在 2024 年 9 月启动的个人实验。他最初只是想做一个简单的 API 测试工具，帮助自己处理音乐播放列表，却意外发现大模型能力远超当时的 “代码补全” 产品形态。Anthropic团队敏锐发现：AI 模型能力已超越现有产品形态，具备直接编写完整代码、处理复杂工程任务的潜力。

2、claude code是什么？—Anthropic推出面向开发者AI编程Agent

Claude 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 tokens（100 万 token）。它容纳了 Claude 在当前会话中"看到"的一切内容：

Claude Code 针对对话上下文容易无限膨胀、信息杂乱冗余的问题，做了三层精细化管控设计：
1）知识按需加载：不会把所有技术规范、项目规则、开发清单等知识一次性全部塞入固定提示词，而是采用模块化知识与分层索引结构，只在当前任务匹配到对应需求时，才临时加载相关领域知识和项目详情，避免无关信息占用上下文空间。
2）子代理上下文隔离：每个子任务都会启用独立的会话消息空间，专门负责代码检索、命令执行等中间操作；任务完成后仅向上层返回精简摘要，不会把子任务产生的大量文件内容、命令日志污染到主上下文。
3）三层上下文压缩：面对长期开发产生的海量文件读取、命令执行记录，设置递进式压缩机制，从无感自动精简到主动人工规整，把冗余对话信息移出活跃上下文并完整留存记录，由模型自主完成内容凝练，既控制上下文长度，又不丢失关键业务信息。

3、claude code可执行能力—工具热注册、Skill 文件系统、插件与扩展架构

Claude Code 适配不同项目、不同开发场景的差异化需求，搭建了一套可无限扩展的执行体系，无需底层硬编码改造：
1）工具热注册：采用统一的映射调度机制，新增命令行、代码检索等执行工具时，只需补充对应处理逻辑和参数规则，不用改动核心运行流程；同时统一设置路径安全约束，从底层规范所有工具的操作范围。
2）Skill 文件系统：将各类行业规范、项目开发知识做成可插拔的模块化文件，和普通执行工具共用一套调用逻辑，可随取随用，实现知识的灵活加载与复用。
3）插件与扩展架构：支持标准化外部服务协议MCP接入、第三方插件集成，能够无缝对接浏览器控制、数据库查询、外部接口调用等能力，统一调用调度规则，实现多元外部功能的快速接入。

4、claude code任务分解调度—TodoWrite+nag、子任务委托、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 code：

1、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/overview
CLI 命令参考（官方文档）：https://code.claude.com/docs/en/cli-reference
斜杠命令大全（官方文档）：https://code.claude.com/docs/en/commands
5分钟安装ClaudeCode并接入DeepSeek：https://www.bilibili.com/video/BV1KjoxBoEQJ
Claude Code 入门教程：https://www.runoob.com/claude-code/claude-code-tutorial.html
learn-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/