一张图讲透 Claude Code 项目结构：CLAUDE.md、Skills 与 Agents 全解析

Aiden_Tech_Ai · x · 2026-10-24

一张流传较广的信息图系统梳理了 Claude Code 的推荐项目目录结构与各配置文件的分工：

CLAUDE.md：每次会话自动加载，写项目概览、技术栈与编码规范；CLAUDE.local.md 存放不进 git 的个人偏好
.mcp.json：MCP 服务器集成（GitHub、JIRA、Slack、数据库），放项目根目录随 git 共享
settings.json / settings.local.json：权限、hooks（PreToolUse/PostToolUse 可实现自动 lint 与分支保护）等配置
commands/.md：自定义斜杠命令，支持 $ARGUMENTS 用户输入，适合 PR 审查、部署、脚手架等重复流程
skills/<name>/SKILL.md：按任务上下文自动触发或用 /skill-name 手动调用，按需加载以保持上下文轻量
agents/.md：拥有独立 system prompt、工具与权限的专职子 agent，用 @agent-name 调用，重活不占用主会话上下文

「编程与Agent」频道最新