你有沒有遇到過這些情況？

• 每次打開新會(huì)話，又要跟 Claude 重新解釋一遍我們項(xiàng)目的命名規(guī)范
• Claude 突然跑去執(zhí)行了一條危險(xiǎn)命令，比如刪文件
• 讓 Claude 做代碼審查，結(jié)果它把整個(gè)項(xiàng)目都塞進(jìn)上下文，又慢又貴
• 你精心調(diào)教出來的一套 Claude 用法，新同事完全不知道怎么復(fù)用

這些問題，都可以用一套叫做 Agent Development Kit（ADK，智能體開發(fā)套件） 的結(jié)構(gòu)來解決。

它的核心就是 5 個(gè)文件夾，通過這 5 個(gè)文件夾我們可以把 Claude Code 變成一支有記憶、懂規(guī)矩、會(huì)分工、能復(fù)制的自動(dòng)化開發(fā)團(tuán)隊(duì)。

整體結(jié)構(gòu)：

你的項(xiàng)目/
├── CLAUDE.md/     ← 第一層：記憶
├── skills/        ← 第二層：知識(shí)
├── hooks/         ← 第三層：護(hù)欄
├── subagents/     ← 第四層：分工
└── plugins/       ← 第五層：復(fù)制

每一層解決一個(gè)具體問題，下面逐一拆解。

第一層：CLAUDE.md— 給 Claude 裝一塊長期記憶

問題是什么？

Claude 沒有跨會(huì)話記憶。你今天告訴它組件命名用大駝峰，明天開新會(huì)話它就忘了。

解決方案

在項(xiàng)目里放一個(gè) CLAUDE.md 文件，把所有不想重復(fù)說的事寫進(jìn)去。每次會(huì)話開始，Claude 自動(dòng)讀取它。

兩個(gè)文件，兩個(gè)作用范圍：

寫什么進(jìn)去？想想你最常對(duì) Claude 重復(fù)說的話：

# 項(xiàng)目：我的電商平臺(tái)
## 技術(shù)棧
- 前端：Next.js 14（App Router）
- 樣式：Tailwind CSS
- 數(shù)據(jù)庫：PostgreSQL + Prisma
## 命名規(guī)范
- 組件文件：大駝峰，如 `UserCard.tsx`
- 工具函數(shù)：小駝峰，如 `formatPrice.ts`
- API 路由：短橫線，如 `/api/user-profile`
## 注意事項(xiàng)
- 禁止使用 `any` 類型
- 所有異步函數(shù)必須有 try/catch
- 提交代碼前必須通過 ESLint 檢查
- 不要直接操作 `main` 分支
## 代碼風(fēng)格
- 縮進(jìn)：2 個(gè)空格
- 引號(hào)：單引號(hào)
- 函數(shù)優(yōu)先用箭頭函數(shù)

效果： 你再也不用在每次對(duì)話開頭粘貼一大段背景介紹了。

第二層：skills/— 把你的經(jīng)驗(yàn)存起來

問題是什么？

你每次讓 Claude 幫我寫一個(gè)新組件，它可能每次做法都不一樣——有時(shí)候加測試，有時(shí)候不加，有時(shí)候有 TypeScript 類型，有時(shí)候沒有。

解決方案

把標(biāo)準(zhǔn)做法寫成技能文件放進(jìn) skills/ 目錄，Claude 會(huì)根據(jù)你的任務(wù)描述，自動(dòng)匹配并調(diào)用對(duì)應(yīng)的技能，你不需要輸入任何命令。

目錄結(jié)構(gòu)：

skills/
├── SKILL.md              ← 技能索引（描述 + 觸發(fā)條件）
├── create-component.md   ← 創(chuàng)建 React 組件的標(biāo)準(zhǔn)流程
├── write-api.md          ← 寫接口的標(biāo)準(zhǔn)流程
└── fix-bug.md            ← 排查 Bug 的標(biāo)準(zhǔn)流程

一個(gè)技能文件長什么樣？

---
name: create-react-component
description: >
  當(dāng)用戶說"創(chuàng)建組件"、"新建頁面"、"寫一個(gè) UI"時(shí)，
  自動(dòng)調(diào)用此技能。
---
# 創(chuàng)建 React 組件的標(biāo)準(zhǔn)流程
## 步驟
1. 檢查 `src/components/` 下是否已存在同名組件
2. 用大駝峰命名新建 `.tsx` 文件
3. 必須定義 TypeScript interface，不允許 any
4. 同步在 `src/stories/` 下新建對(duì)應(yīng)的 Storybook 故事
5. 在 `__tests__/` 下新建單元測試文件
## 代碼模板
\`\`\`tsx
interface Props {
  // 在這里定義 props
}
export const ComponentName: React.FC<Props> = ({ }) => {
  return <div>{/* 內(nèi)容 */}</div>;
};
\`\`\`

效果： 你說幫我創(chuàng)建一個(gè)用戶卡片組件，Claude 自動(dòng)按照你團(tuán)隊(duì)的標(biāo)準(zhǔn)流程來做，測試、類型、文檔一個(gè)不漏。

通俗理解： 這就像給一個(gè)新員工寫了一本《操作手冊》，它照著手冊做事，不需要你每次盯著。

第三層：hooks/— 設(shè)一道不可繞過的護(hù)欄

問題是什么？

AI 有時(shí)候會(huì)做出一些你絕對(duì)不想要的操作——比如在生產(chǎn)環(huán)境直接刪數(shù)據(jù)庫，或者跑了一條 rm -rf 命令。這種事情靠在提示詞里說不要這樣做是不可靠的。

解決方案

Hooks 是在 Claude 每次工具調(diào)用前后自動(dòng)運(yùn)行的 Shell 腳本。它是純代碼邏輯，確定性執(zhí)行，AI 繞不過去。

三個(gè)核心文件：

hooks/
├── PreToolUse.sh    ← 工具調(diào)用「之前」運(yùn)行
├── PostToolUse.sh   ← 工具調(diào)用「之后」運(yùn)行
└── SessionStart.sh  ← 會(huì)話「開始時(shí)」運(yùn)行

PreToolUse.sh 示例 — 攔截危險(xiǎn)命令：

#!/bin/bash
# 檢查 Claude 準(zhǔn)備執(zhí)行的命令
TOOL_INPUT="$2"
# 禁止執(zhí)行 rm -rf /
if echo "$TOOL_INPUT" | grep -qE "rm\s+-rf\s+/"; then
  echo "已攔截：禁止執(zhí)行破壞性刪除命令" >&2
  exit 1
fi
# 禁止在沒有確認(rèn)的情況下操作生產(chǎn)數(shù)據(jù)庫
if echo "$TOOL_INPUT" | grep -q "prod_db" && echo "$TOOL_INPUT" | grep -qE "DROP|DELETE"; then
  echo "已攔截：生產(chǎn)數(shù)據(jù)庫的破壞性操作需要人工確認(rèn)" >&2
  exit 1
fi
exit 0

PostToolUse.sh 示例 — 保存文件后自動(dòng)格式化：

#!/bin/bash
# 每次 Claude 寫完文件，自動(dòng)跑 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 "已自動(dòng)格式化：$FILE_PATH"
      ;;
  esac
fi

效果：

• Claude 寫完代碼，自動(dòng)幫你 lint，不用你手動(dòng)跑
• 危險(xiǎn)命令在執(zhí)行前就被攔截，你連看都不用看
• 部署腳本跑完，自動(dòng)發(fā) Slack 通知給團(tuán)隊(duì)

通俗理解： 就像工廠流水線上的質(zhì)檢環(huán)節(jié)。產(chǎn)品出廠前強(qiáng)制過一遍，不符合規(guī)格的直接擋回去，不依賴工人的個(gè)人判斷。

第四層：subagents/— 讓專門的人做專門的事

問題是什么？

讓 Claude 在一個(gè)會(huì)話里同時(shí)做"代碼審查 + 跑測試 + 寫文檔"，上下文會(huì)越來越大，越來越慢，而且各種任務(wù)互相干擾。

解決方案

把不同任務(wù)拆分給獨(dú)立的子代理。每個(gè)子代理有自己獨(dú)立的上下文窗口、專屬的工具權(quán)限，只做一件事，做完匯報(bào)結(jié)果。

目錄結(jié)構(gòu)：

subagents/
├── code-reviewer.md   ← 專門做代碼審查
├── test-runner.md     ← 專門跑測試
└── doc-writer.md      ← 專門寫文檔

code-reviewer.md 示例：

---
name: code-reviewer
description: PR 需要代碼審查時(shí)調(diào)用此代理
tools:
  - read_file        # 只允許讀文件
permissions:
  - read_only        # 只讀權(quán)限，絕對(duì)不會(huì)誤操作
---
# 代碼審查專用代理
你是一名資深代碼審查員。你只會(huì)收到 git diff，不需要了解整個(gè)項(xiàng)目。
你沒有寫入權(quán)限，只能閱讀和分析。
## 審查清單
- [ ] 有沒有硬編碼的密鑰或密碼？
- [ ] 新函數(shù)有沒有對(duì)應(yīng)的單元測試？
- [ ] TypeScript 類型是否明確，有沒有 any？
- [ ] 異步操作有沒有錯(cuò)誤處理？
- [ ] 有沒有遺留的 console.log？
## 輸出格式
1. **總體評(píng)價(jià)**：一句話說清楚
2. **必須修改**：阻塞合并的問題
3. **建議優(yōu)化**：非阻塞的改進(jìn)項(xiàng)
4. **結(jié)論**：可以合并 / 需要修改

整體運(yùn)作流程：

你說："幫我審查這個(gè) PR 并運(yùn)行測試"
          │
          ├──→ 調(diào)用 code-reviewer 子代理
          │         獨(dú)立上下文，只看 diff，只讀權(quán)限
          │         返回：結(jié)構(gòu)化審查報(bào)告
          │
          ├──→ 調(diào)用 test-runner 子代理
          │         獨(dú)立上下文，有執(zhí)行測試的權(quán)限
          │         返回：測試通過/失敗摘要
          │
          └──→ 主會(huì)話匯總結(jié)果，上下文始終保持干凈

通俗理解： 就像一個(gè)包工頭。他自己不擼代碼，但他手下有專門的水電工、瓦工、木工。誰的活兒誰干，互不干擾，最后包工頭統(tǒng)一匯報(bào)進(jìn)度。

第五層：plugins/— 一鍵復(fù)制給全團(tuán)隊(duì)

問題是什么？

你花了好幾天把以上四層全部調(diào)教好了，但新同事入職，他怎么知道這套配置？難道要讓他再配置一遍？

解決方案

把整套系統(tǒng)打包成一個(gè)插件，新成員執(zhí)行一條命令，立刻擁有和你完全相同的 Claude Code 工作環(huán)境。

目錄結(jié)構(gòu)：

plugins/
├── manifest.json    ← 描述插件包含什么
├── marketplace.url  ← 分享鏈接
└── team.install     ← 一鍵安裝腳本

team.install 示例：

#!/bin/bash
echo "🚀 正在安裝團(tuán)隊(duì) ADK 配置..."

# 安裝項(xiàng)目級(jí) CLAUDE.md
cp ./CLAUDE.md/project.md ./.claude/CLAUDE.md

# 安裝所有技能
mkdir -p ./.claude/skills && cp -r ./skills/* ./.claude/skills/

# 安裝鉤子（記得加執(zhí)行權(quán)限）
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 已配置為團(tuán)隊(duì)模式。"

新同事入職第一天：

bash plugins/team.install

完畢。和你用的是完全一樣的 Claude Code。

通俗理解： 就像公司的"新員工電腦配置包"。IT 部門做好一個(gè)鏡像，新人一鍵安裝，環(huán)境和老員工一模一樣，不用挨個(gè)手動(dòng)配。

完整流程圖：5 層如何協(xié)同工作

開發(fā)者輸入任務(wù)
      │
      ▼
  CLAUDE.md        → 加載項(xiàng)目規(guī)范和背景知識(shí)
      │
      ▼
  skills/          → 匹配任務(wù)類型，調(diào)用對(duì)應(yīng)工作流
      │
      ▼
  hooks/PreToolUse → 執(zhí)行前檢查，攔截危險(xiǎn)操作
      │
      ▼
  subagents/       → 復(fù)雜任務(wù)拆分給專屬子代理執(zhí)行
      │
      ▼
  hooks/PostToolUse→ 執(zhí)行后處理，自動(dòng)格式化/通知
      │
      ▼
  plugins/         → 整套配置一鍵同步給所有團(tuán)隊(duì)成員

5 層對(duì)應(yīng)解決的問題匯總

常見問題

Q：Claude 官網(wǎng)和 API 有什么區(qū)別？

A：官網(wǎng)適合人直接使用，打開就能對(duì)話、上傳文檔、做分析；API 適合系統(tǒng)接入，能把 Claude 放進(jìn)自己的應(yīng)用、腳本和團(tuán)隊(duì)工具里。一個(gè)偏“人用”，一個(gè)偏“系統(tǒng)用”。

Q：Claude 更適合普通用戶還是開發(fā)者？

A：兩邊都適合，只是入口不同。普通用戶通常從官網(wǎng)開始，開發(fā)者更容易從 API 或 Claude Code 開始。Claude 的強(qiáng)項(xiàng)在于長上下文、復(fù)雜分析和持續(xù)保持任務(wù)狀態(tài)，所以不只是程序員能用。

Q：Claude Code 和 Claude 官網(wǎng)是什么關(guān)系？

A：它們底層都基于 Claude 模型，但使用形態(tài)不同。官網(wǎng)是對(duì)話入口，Claude Code 是終端里的開發(fā) Agent，能直接進(jìn)入代碼庫、讀寫文件、執(zhí)行命令、完成更完整的工程任務(wù)。

Q：免費(fèi)版夠不夠用，什么時(shí)候該升級(jí)？

A：如果你只是偶爾體驗(yàn)、低頻提問，免費(fèi)版可以先用；但只要開始處理長文檔、復(fù)雜任務(wù)，或者把 Claude 當(dāng)成日常主力工具，升級(jí)通常會(huì)明顯提升體驗(yàn)。

以上就是2026最新Claude Code開發(fā)配置詳細(xì)手冊的詳細(xì)內(nèi)容，更多關(guān)于Claude Code配置的資料請關(guān)注腳本之家其它相關(guān)文章！

最新評(píng)論