你有没有遇到过这些情况每次打开新会话又要跟 Claude 重新解释一遍我们项目的命名规范Claude 突然跑去执行了一条危险命令比如删文件让 Claude 做代码审查结果它把整个项目都塞进上下文又慢又贵你精心调教出来的一套 Claude 用法新同事完全不知道怎么复用这些问题都可以用一套叫做 Agent Development KitADK智能体开发套件 的结构来解决。它的核心就是 5 个文件夹通过这 5 个文件夹我们可以把 Claude Code 变成一支有记忆、懂规矩、会分工、能复制的自动化开发团队。整体结构你的项目/ ├── CLAUDE.md/ ← 第一层记忆 ├── skills/ ← 第二层知识 ├── hooks/ ← 第三层护栏 ├── subagents/ ← 第四层分工 └── plugins/ ← 第五层复制层级目录 / 文件作用核心意义类比理解第1层CLAUDE.md/智能体的全局规则与记忆中心定义 AI 的行为规范、项目背景、开发约束AI 项目操作手册architecture.rules架构规则定义规定代码结构、命名规范、目录设计技术团队编码规范global.md全局共享记忆所有项目都生效的长期规则AI 的长期记忆project.md当前项目专属记忆当前仓库的业务背景、特殊要求项目 README 的增强版第2层skills/技能模块目录给 AI 注入专业能力AI 的技能库SKILL.md技能描述文件告诉 AI 什么情况下调用该技能技能说明书scripts/技能脚本目录存放自动化脚本与模板工具箱context.md技能上下文提供技能运行时需要的背景知识专业知识库第3层hooks/Hook 钩子系统在执行前后自动插入检查逻辑自动安全审计PreToolUse.sh工具执行前钩子执行命令前做校验危险操作确认器PostToolUse.sh工具执行后钩子执行完成后自动处理自动格式化、通知SessionStart.sh会话启动钩子初始化开发环境IDE 启动脚本第4层subagents/子智能体目录拆分不同专业 AgentAI 团队协作系统code-reviewer.md代码审查 Agent专门负责代码 ReviewReviewer 工程师test-runner.md测试 Agent自动运行测试QA 测试工程师explorer.md探索型 Agent分析代码库结构技术调研员第5层plugins/插件系统将能力模块化分发AI 应用市场manifest.json插件配置清单定义插件元数据npm package.jsonmarketplace.url插件市场地址插件下载与共享入口应用商店team.install团队安装脚本一键同步团队环境DevOps 初始化脚本每一层解决一个具体问题下面逐一拆解。第一层CLAUDE.md— 给 Claude 装一块长期记忆问题是什么Claude 没有跨会话记忆。你今天告诉它组件命名用大驼峰明天开新会话它就忘了。解决方案在项目里放一个CLAUDE.md文件把所有不想重复说的事写进去。每次会话开始Claude 自动读取它。两个文件两个作用范围文件位置作用范围~/.claude/CLAUDE.md你电脑上的所有项目都生效项目根目录 .claude/CLAUDE.md只对这一个仓库生效写什么进去想想你最常对 Claude 重复说的话# 项目我的电商平台 ## 技术栈 - 前端Next.js 14App Router - 样式Tailwind CSS - 数据库PostgreSQL Prisma ## 命名规范 - 组件文件大驼峰如 UserCard.tsx - 工具函数小驼峰如 formatPrice.ts - API 路由短横线如 /api/user-profile ## 注意事项 - 禁止使用 any 类型 - 所有异步函数必须有 try/catch - 提交代码前必须通过 ESLint 检查 - 不要直接操作 main 分支 ## 代码风格 - 缩进2 个空格 - 引号单引号 - 函数优先用箭头函数效果你再也不用在每次对话开头粘贴一大段背景介绍了。第二层skills/— 把你的经验存起来问题是什么你每次让 Claude 帮我写一个新组件它可能每次做法都不一样——有时候加测试有时候不加有时候有 TypeScript 类型有时候没有。解决方案把标准做法写成技能文件放进skills/目录Claude 会根据你的任务描述自动匹配并调用对应的技能你不需要输入任何命令。目录结构skills/ ├── SKILL.md ← 技能索引描述 触发条件 ├── create-component.md ← 创建 React 组件的标准流程 ├── write-api.md ← 写接口的标准流程 └── fix-bug.md ← 排查 Bug 的标准流程一个技能文件长什么样--- name: create-react-component description: 当用户说创建组件、新建页面、写一个 UI时 自动调用此技能。 --- # 创建 React 组件的标准流程 ## 步骤 1. 检查 src/components/ 下是否已存在同名组件 2. 用大驼峰命名新建 .tsx 文件 3. 必须定义 TypeScript interface不允许 any 4. 同步在 src/stories/ 下新建对应的 Storybook 故事 5. 在 __tests__/ 下新建单元测试文件 ## 代码模板 \\\tsx interface Props { // 在这里定义 props } export const ComponentName: React.FCProps ({ }) { return div{/* 内容 */}/div; }; \\\效果你说帮我创建一个用户卡片组件Claude 自动按照你团队的标准流程来做测试、类型、文档一个不漏。通俗理解这就像给一个新员工写了一本《操作手册》它照着手册做事不需要你每次盯着。第三层hooks/— 设一道不可绕过的护栏问题是什么AI 有时候会做出一些你绝对不想要的操作——比如在生产环境直接删数据库或者跑了一条rm -rf命令。这种事情靠在提示词里说不要这样做是不可靠的。解决方案Hooks 是在 Claude 每次工具调用前后自动运行的 Shell 脚本。它是纯代码逻辑确定性执行AI 绕不过去。三个核心文件hooks/ ├── PreToolUse.sh ← 工具调用「之前」运行 ├── PostToolUse.sh ← 工具调用「之后」运行 └── SessionStart.sh ← 会话「开始时」运行PreToolUse.sh 示例 — 拦截危险命令#!/bin/bash # 检查 Claude 准备执行的命令 TOOL_INPUT$2 # 禁止执行 rm -rf / if echo $TOOL_INPUT | grep -qE rm\s-rf\s/; then echo 已拦截禁止执行破坏性删除命令 2 exit 1 fi # 禁止在没有确认的情况下操作生产数据库 if echo $TOOL_INPUT | grep -q prod_db echo $TOOL_INPUT | grep -qE DROP|DELETE; then echo 已拦截生产数据库的破坏性操作需要人工确认 2 exit 1 fi exit 0PostToolUse.sh 示例 — 保存文件后自动格式化#!/bin/bash # 每次 Claude 写完文件自动跑 lint 和格式化 TOOL_NAME$1 FILE_PATH$2 if [ $TOOL_NAME write_file ]; then case $FILE_PATH in *.ts|*.tsx|*.js|*.jsx) npx eslint --fix $FILE_PATH npx prettier --write $FILE_PATH echo 已自动格式化$FILE_PATH ;; esac fi效果Claude 写完代码自动帮你 lint不用你手动跑危险命令在执行前就被拦截你连看都不用看部署脚本跑完自动发 Slack 通知给团队通俗理解就像工厂流水线上的质检环节。产品出厂前强制过一遍不符合规格的直接挡回去不依赖工人的个人判断。第四层subagents/— 让专门的人做专门的事问题是什么让 Claude 在一个会话里同时做代码审查 跑测试 写文档上下文会越来越大越来越慢而且各种任务互相干扰。解决方案把不同任务拆分给独立的子代理。每个子代理有自己独立的上下文窗口、专属的工具权限只做一件事做完汇报结果。目录结构subagents/ ├── code-reviewer.md ← 专门做代码审查 ├── test-runner.md ← 专门跑测试 └── doc-writer.md ← 专门写文档code-reviewer.md 示例--- name: code-reviewer description: PR 需要代码审查时调用此代理 tools: - read_file # 只允许读文件 permissions: - read_only # 只读权限绝对不会误操作 --- # 代码审查专用代理 你是一名资深代码审查员。你只会收到 git diff不需要了解整个项目。 你没有写入权限只能阅读和分析。 ## 审查清单 - [ ] 有没有硬编码的密钥或密码 - [ ] 新函数有没有对应的单元测试 - [ ] TypeScript 类型是否明确有没有 any - [ ] 异步操作有没有错误处理 - [ ] 有没有遗留的 console.log ## 输出格式 1. **总体评价**一句话说清楚 2. **必须修改**阻塞合并的问题 3. **建议优化**非阻塞的改进项 4. **结论**可以合并 / 需要修改整体运作流程你说帮我审查这个 PR 并运行测试 │ ├──→ 调用 code-reviewer 子代理 │ 独立上下文只看 diff只读权限 │ 返回结构化审查报告 │ ├──→ 调用 test-runner 子代理 │ 独立上下文有执行测试的权限 │ 返回测试通过/失败摘要 │ └──→ 主会话汇总结果上下文始终保持干净通俗理解就像一个包工头。他自己不撸代码但他手下有专门的水电工、瓦工、木工。谁的活儿谁干互不干扰最后包工头统一汇报进度。第五层plugins/— 一键复制给全团队问题是什么你花了好几天把以上四层全部调教好了但新同事入职他怎么知道这套配置难道要让他再配置一遍解决方案把整套系统打包成一个插件新成员执行一条命令立刻拥有和你完全相同的 Claude Code 工作环境。目录结构plugins/ ├── manifest.json ← 描述插件包含什么 ├── marketplace.url ← 分享链接 └── team.install ← 一键安装脚本team.install 示例#!/bin/bash echo #x1f680; 正在安装团队 ADK 配置... # 安装项目级 CLAUDE.md cp ./CLAUDE.md/project.md ./.claude/CLAUDE.md # 安装所有技能 mkdir -p ./.claude/skills cp -r ./skills/* ./.claude/skills/ # 安装钩子记得加执行权限 mkdir -p ./.claude/hooks cp -r ./hooks/* ./.claude/hooks/ chmod x ./.claude/hooks/*.sh # 安装子代理 mkdir -p ./.claude/subagents cp -r ./subagents/* ./.claude/subagents/ echo 安装完成Claude Code 已配置为团队模式。新同事入职第一天bash plugins/team.install完毕。和你用的是完全一样的 Claude Code。通俗理解就像公司的新员工电脑配置包。IT 部门做好一个镜像新人一键安装环境和老员工一模一样不用挨个手动配。完整流程图5 层如何协同工作开发者输入任务 │ ▼ CLAUDE.md → 加载项目规范和背景知识 │ ▼ skills/ → 匹配任务类型调用对应工作流 │ ▼ hooks/PreToolUse → 执行前检查拦截危险操作 │ ▼ subagents/ → 复杂任务拆分给专属子代理执行 │ ▼ hooks/PostToolUse→ 执行后处理自动格式化/通知 │ ▼ plugins/ → 整套配置一键同步给所有团队成员5 层对应解决的问题汇总层级文件夹解决什么问题类比第一层CLAUDE.md/Claude 每次都忘记项目规范员工手册第二层skills/同类任务每次做法不一致操作手册第三层hooks/危险操作无法防范流水线质检第四层subagents/复杂任务上下文膨胀专业分工第五层plugins/配置无法在团队复用新人入职包快速上手今天就能做的 3 件事如果你觉得一次全部配置太复杂可以先从最高回报的开始第 1 步5 分钟建一个CLAUDE.md把你最常跟 Claude 重复说的项目背景都写进去。第 2 步10 分钟建一个hooks/PreToolUse.sh加入几条你最不想 Claude 执行的危险命令的拦截规则。第 3 步30 分钟把你最常做的一类任务比如创建组件写成第一个skills/文件积累你的团队标准。附官网使用全流程如果你是第一次接触 Claude最自然的入口还是官网。官网路线的优点很直接你不需要自己写代码不需要先理解 SDK也不用一开始就思考“怎么接到业务系统里”。注册、登录、升级之后直接就能开始对话、上传文档、做总结、写内容、拆方案。对大多数非开发型用户或者只是想先感受 Claude 能力的人来说这条路门槛最低。第一步进入官网Claude 的官方入口是claude.ai。从这里开始你可以直接注册账号并进入对话界面。第二步完成账号验证官网注册流程的核心通常是 3 步邮箱、邮件验证、手机号验证。真正让很多国内用户卡住的其实是后两步尤其是手机号验证和后续的稳定性问题。通常会用到这些准备项海外邮箱稳定的网络环境可用于验证的海外手机号如果你只是轻量体验免费版可以先试但只要你开始认真使用尤其是处理长文档、长上下文、多轮复杂任务付费版和免费版的差距会很快体现出来。第三步看懂套餐差异Claude 官网这套使用方式大致可以分成 Free、Pro、Max 以及 API 按量几类。把它理解成“不同层级的使用深度”会更容易方式门槛适合人群主要用途Free低初次体验用户轻量试用、基础问答Pro中高频个人用户长文档、深度对话、日常生产力Max较高重度用户、团队核心成员更高强度、更高吞吐使用API 按量中开发者、产品团队把 Claude 接进项目或服务其中最常见的个人使用升级路径还是从免费版到 Pro。如果你的使用方式主要是看文档、提问题写总结、周报、文章草稿让它帮你分析一批文本或方案偶尔讨论代码思路那官网通常就是最省事的入口。官网适合什么人一句话概括官网适合“先把 Claude 当生产力助手用起来”的人。你不需要先做技术接入也不需要搭环境。很多人第一次真正感受到 Claude 的优势就是在官网里把一篇长文、一个复杂需求、一个项目背景喂进去然后发现它不仅能回答还能持续保持上下文不容易在长对话里失焦。如果你只是想先感受 Claude而不想马上去处理注册、订阅和环境问题也可以先从更低门槛的体验入口入手。比如 Cursor 的文档页里就有过 Claude 的集成体验适合先试模型风格和对话质量。API 与开发者接入当你开始想把 Claude 放进自己的产品、脚本、工作流或者团队工具里时官网就不够了这时候该看的是 API。API 最大的价值不是“换个地方提问”而是让 Claude 从一个聊天入口变成你的应用能力层。你可以把它接到客服系统、代码审查工具、知识库问答、文档处理流水线、IDE 插件、企业内部助手里。也就是说官网解决的是“人如何使用 Claude”API 解决的是“系统如何使用 Claude”。什么情况下该用 API如果你有下面这些需求基本都属于 API 场景想把 Claude 集成进自己的产品或网站想做自动化内容处理、批量摘要、分类、分析想给内部工具、IDE、企业系统接入智能能力想把提示词、上下文、调用逻辑都掌握在自己手里这类场景里API 的灵活性远高于官网。你不仅能控制输入输出格式还能自己设计系统提示词、业务流程、错误处理和成本策略。最小 SDK 调用示例如果你用 Python最小接入通常长这样import anthropic client anthropic.Anthropic(api_keyyour-api-key) response client.messages.create( modelclaude-sonnet-4-6, max_tokens1024, messages[ {role: user, content: 帮我分析这段代码的潜在问题} ] ) print(response.content)这类调用方式适合先快速打通先把模型跑起来再逐步补充系统提示词、流式输出、异常处理、日志记录和成本监控。API 的成本怎么理解API 通常按 token 计费。简单理解就是输入多少、输出多少分别按模型计费。模型越强价格越高任务越复杂、输出越长成本也越高。一个比较实用的选择思路是轻量任务优先用 Haiku大多数正式生产任务优先用 Sonnet只有真的需要最复杂推理、重度代码分析时再上 Opus这样既能控制成本也不会一上来就把所有请求都压到最贵模型上。Claude Code 和 API 是什么关系很多人第一次接触 Claude Code 时会误以为它只是“Claude 的命令行皮肤”。其实不是。Claude Code 更接近一个终端里的自主 Agent。它不是单纯补全代码而是能在项目目录里读取文件、理解结构、执行命令、跨文件修改、跑测试、根据结果继续修正。也就是说官网适合人直接对话API 适合系统调用而 Claude Code 适合把 Claude 放进真实工程环境里干活。从能力理解上你可以把它看成 Claude 在开发工作流里的落地形态。它为什么常被拿来和 Cursor、Copilot 放在一起比较因为大家都在解决“ AI 如何进入开发流程”这个问题。但 Claude Code 的重点不是编辑器补全而是任务闭环。国内使用落地方案如果只看产品层面Claude 的入口其实很清楚官网、API、Claude Code。但一落到国内使用问题马上就变成另一套了。很多人不是不懂官网和 API 的区别而是卡在“我知道该怎么用但我就是用不上”。这时候真正需要看的是落地路线而不是产品宣传。官网路线的门槛官网路线最直接但门槛也最集中注册需要处理邮箱和手机号验证使用过程依赖稳定网络环境升级订阅通常涉及海外支付账号稳定性和风控也需要长期维护如果你能接受这套成本官网路线当然是最原生的但只要你想长期用、稳定用维护成本往往比第一次注册更麻烦。API 路线的门槛开发者这边的问题又不太一样。API 本身并不复杂真正麻烦的是如何创建和维护可用的 Key如何处理支付与充值服务端怎么稳定访问 endpoint团队里怎么统一配置、统一调用方式很多团队不是接不了 Claude而是接上之后很难把这条链路稳定运营起来。三种常见落地思路把国内常见路线压缩一下大致可以看成这 3 种路线门槛适合谁主要特点官网直连高重度个人用户、对原生体验要求高的人功能完整但注册、支付、风控压力最大低门槛体验入口低想先试 Claude 的人上手快但能力或次数通常有限API 转发 / 中转中开发者、团队、想减少折腾的人更适合接入工作流但要选兼容性与稳定性更好的方式不过说实话官方订阅和 API 对国内用户都不算省心——支付、网络和稳定性都需要自己处理。如果嫌麻烦想找个更省事的入口可以看看 Code80真实订阅帐号转 API换个 endpoint 就能直接用体验方式和官方一致。详情可以到官网了解code.ai80.vip这类路线适合的不是“完全不懂 Claude 的人”而是已经明确知道自己要官网能力、要 API 兼容、要更低接入摩擦的人。常见问题QClaude 官网和 API 有什么区别A官网适合人直接使用打开就能对话、上传文档、做分析API 适合系统接入能把 Claude 放进自己的应用、脚本和团队工具里。一个偏“人用”一个偏“系统用”。QClaude 更适合普通用户还是开发者A两边都适合只是入口不同。普通用户通常从官网开始开发者更容易从 API 或 Claude Code 开始。Claude 的强项在于长上下文、复杂分析和持续保持任务状态所以不只是程序员能用。QClaude Code 和 Claude 官网是什么关系A它们底层都基于 Claude 模型但使用形态不同。官网是对话入口Claude Code 是终端里的开发 Agent能直接进入代码库、读写文件、执行命令、完成更完整的工程任务。Q免费版够不够用什么时候该升级A如果你只是偶尔体验、低频提问免费版可以先用但只要开始处理长文档、复杂任务或者把 Claude 当成日常主力工具升级通常会明显提升体验。Q国内怎么更方便地用上 ClaudeA如果你愿意自己处理网络、手机号和支付问题可以走官网或官方 API如果你更在意接入省事、调用兼容和团队统一配置国内也可以通过 Code80 这类兼容官方调用方式的入口更方便地使用。
