directory structure

Claude Code 的完整源码目录结构。

根目录

claude-code/
├── src/                    # 源代码
├── docs/                   # 文档
├── tests/                  # 测试
├── .kiro/                  # 配置和扩展
├── package.json            # 项目配置
├── tsconfig.json           # TypeScript 配置
├── bunfig.toml             # Bun 配置
└── README.md               # 项目说明

src/ 目录

src/
├── main.tsx                # 主入口
├── query.ts                # Query Loop
├── QueryEngine.ts          # Query Engine
├── Tool.ts                 # 工具接口
├── Task.ts                 # 任务系统
├── commands.ts             # 命令定义
│
├── state/                  # 状态管理
│   ├── store.ts            # 状态存储
│   └── AppStateStore.ts    # 状态类型
│
├── tools/                  # 工具实现
│   ├── FileEditTool/
│   ├── BashTool/
│   ├── AgentTool/
│   ├── ReadCodeTool/
│   └── ...
│
├── services/               # 服务层
│   ├── compact/            # 上下文压缩
│   ├── tools/              # 工具服务
│   ├── permissions/        # 权限服务
│   ├── mcp/                # MCP 客户端
│   └── coordinator/        # 协调器
│
├── bridge/                 # Bridge 系统
│   ├── bridgeMain.ts
│   ├── bridgeMessaging.ts
│   └── trustedDevice.ts
│
├── commands/               # CLI 命令
│   ├── add-dir/
│   ├── agents/
│   ├── assistant/
│   └── ...
│
├── components/             # UI 组件
│   ├── ChatView.tsx
│   ├── ToolExecutionView.tsx
│   └── ...
│
├── hooks/                  # React Hooks
│   ├── useStore.ts
│   └── ...
│
├── utils/                  # 工具函数
│   ├── fileSystem.ts
│   ├── tokenCount.ts
│   └── ...
│
├── constants/              # 常量
│   ├── prompts.ts
│   └── config.ts
│
└── entrypoints/            # 入口点
    └── cli.tsx

.kiro/ 目录

.kiro/
├── config.json             # 主配置
├── settings/               # 设置
│   └── mcp.json            # MCP 配置
├── skills/                 # Skills
│   ├── frontend-design.md
│   └── ...
├── plugins/                # Plugins
│   ├── my-plugin.ts
│   └── ...
├── hooks/                  # Hooks
│   ├── lint-on-save.json
│   └── ...
├── agents/                 # 自定义 Agent
│   └── code-reviewer.json
└── cache/                  # 缓存
    ├── prompts/
    └── tools/

tests/ 目录

tests/
├── unit/                   # 单元测试
│   ├── tools/
│   ├── services/
│   └── utils/
├── integration/            # 集成测试
│   ├── query/
│   └── bridge/
└── e2e/                    # 端到端测试
    └── scenarios/

关键目录说明

src/tools/

包含所有内置工具的实现，每个工具通常有独立的目录。

src/services/

提供各种核心服务，如上下文压缩、权限检查、MCP 集成等。

src/bridge/

Bridge 模式的完整实现，支持远程控制和 IDE 集成。

src/commands/

CLI 命令的实现，每个命令通常有独立的目录。

.kiro/

用户配置和扩展目录，包含 Skills、Plugins、Hooks 等。

下一步

• 查看 关键文件索引 了解重要文件

• 参考 术语表 理解概念

• 浏览 参考资源 获取更多信息