claude code的源码解析仓库目录导读
仓库地址：
https://github.com/zkbaba/claude-code-source-code-interpretation/tree/main仓库目录导读
本目录包含针对 claude-code-source-code-main 的分目录说明文档。生成时覆盖仓库中除 docs/folder-guides/ 自身之外的全部现有目录，每个目录单独一份 Markdown，内容基于实际文件、导入关系、导出符号、文件规模和目录结构汇总而成。
深度文档
仓库整体判断
- 这是一个以
src/main.tsx为核心启动点、以src/entrypoints/cli.tsx为 CLI 快路径入口的终端代理应用。 src/commands.ts负责 slash/子命令注册，src/tools.ts负责模型工具注册，src/QueryEngine.ts负责消息循环与工具调用编排。src/components、src/screens、src/ink构成终端 UI；src/services、src/utils、src/tasks构成执行与基础设施；src/services/mcp、src/server、src/bridge承担外部集成。
分层视图
| 层级 | 代表目录 | 作用 |
|---|---|---|
| 入口层 | src/entrypoints、src/main.tsx、src/cli |
解析启动参数、处理快路径、初始化运行环境和入口上下文 |
| 编排层 | src/QueryEngine.ts、src/query、src/commands.ts、src/tools.ts |
维护消息循环、命令注册、工具注册、token/预算与主流程控制 |
| 能力层 | src/tools、src/services、src/utils、src/tasks |
执行文件/Shell/Web/MCP/代理/后台任务等实际能力 |
| 交互层 | src/components、src/screens、src/ink、src/hooks、src/context |
构建终端 UI、对话框、消息渲染、快捷键和全局状态共享 |
| 扩展层 | src/plugins、src/skills、src/outputStyles、src/memdir |
接入插件、技能、输出风格和记忆能力 |
| 集成层 | src/server、src/bridge、src/remote、src/services/mcp、vendor |
与远程环境、本地直连、MCP 服务和外部原生能力对接 |
| 文档与构建层 | docs、scripts、stubs、顶层 README* |
提供分析报告、多语言说明、构建脚本与编译期桩模块 |
整体框图
CLI Entrypoint
src/entrypoints/cli.tsx
src/main.tsx
启动初始化
Bootstrap / Config / State
src/bootstrap + src/state + src/constants
Command Registry
src/commands.ts + src/commands
Tool Registry
src/tools.ts + src/tools
Query Engine
src/QueryEngine.ts + src/query
Services
src/services
Utilities
src/utils
Tasks / Agents / Swarm
src/tasks + src/tools/AgentTool + src/utils/swarm
Memory / Skills / Plugins
src/memdir + src/skills + src/plugins
UI Layer
src/components + src/screens + src/ink + src/hooks + src/context
MCP / Remote / Server
src/services/mcp + src/server + src/bridge + src/remote
External Systems
Claude API / MCP Servers / Shell / Filesystem / Vendor Bindings
目录索引
| 目录 | 直接文件 | 直接子目录 | 文档 |
|---|---|---|---|
. |
9 | 8 | 查看 |
docs |
0 | 4 | 查看 |
scripts |
4 | 0 | 查看 |
src |
18 | 35 | 查看 |
stubs |
4 | 0 | 查看 |
tools |
0 | 5 | 查看 |
types |
1 | 0 | 查看 |
utils |
3 | 0 | 查看 |
vendor |
0 | 4 | 查看 |
docs/en |
5 | 0 | 查看 |
docs/ja |
5 | 0 | 查看 |
docs/ko |
5 | 0 | 查看 |
docs/zh |
5 | 0 | 查看 |
src/assistant |
1 | 0 | 查看 |
src/bootstrap |
1 | 0 | 查看 |
src/bridge |
31 | 0 | 查看 |
src/buddy |
6 | 0 | 查看 |
src/cli |
6 | 2 | 查看 |
src/commands |
15 | 86 | 查看 |
src/components |
113 | 31 | 查看 |
src/constants |
21 | 0 | 查看 |
src/context |
9 | 0 | 查看 |
src/coordinator |
1 | 0 | 查看 |
src/entrypoints |
5 | 1 | 查看 |
src/hooks |
83 | 2 | 查看 |
src/ink |
43 | 5 | 查看 |
src/keybindings |
14 | 0 | 查看 |
src/memdir |
8 | 0 | 查看 |
src/migrations |
11 | 0 | 查看 |
src/moreright |
1 | 0 | 查看 |
src/native-ts |
0 | 3 | 查看 |
src/outputStyles |
1 | 0 | 查看 |
src/plugins |
1 | 1 | 查看 |
src/query |
4 | 0 | 查看 |
src/remote |
4 | 0 | 查看 |
src/schemas |
1 | 0 | 查看 |
src/screens |
3 | 0 | 查看 |
src/server |
3 | 0 | 查看 |
src/services |
16 | 20 | 查看 |
src/skills |
3 | 1 | 查看 |
src/state |
6 | 0 | 查看 |
src/tasks |
4 | 5 | 查看 |
src/tools |
1 | 42 | 查看 |
src/types |
7 | 1 | 查看 |
src/upstreamproxy |
2 | 0 | 查看 |
src/utils |
298 | 31 | 查看 |
src/vim |
5 | 0 | 查看 |
src/voice |
1 | 0 | 查看 |
tools/OverflowTestTool |
1 | 0 | 查看 |
tools/TerminalCaptureTool |
1 | 0 | 查看 |
tools/TungstenTool |
1 | 0 | 查看 |
tools/VerifyPlanExecutionTool |
1 | 0 | 查看 |
tools/WorkflowTool |
1 | 0 | 查看 |
vendor/audio-capture-src |
1 | 0 | 查看 |
vendor/image-processor-src |
1 | 0 | 查看 |
vendor/modifiers-napi-src |
1 | 0 | 查看 |
vendor/url-handler-src |
1 | 0 | 查看 |
src/cli/handlers |
6 | 0 | 查看 |
src/cli/transports |
7 | 0 | 查看 |
src/commands/add-dir |
3 | 0 | 查看 |
src/commands/agents |
2 | 0 | 查看 |
src/commands/ant-trace |
1 | 0 | 查看 |
src/commands/autofix-pr |
1 | 0 | 查看 |
src/commands/backfill-sessions |
1 | 0 | 查看 |
src/commands/branch |
2 | 0 | 查看 |
src/commands/break-cache |
1 | 0 | 查看 |
src/commands/bridge |
2 | 0 | 查看 |
src/commands/btw |
2 | 0 | 查看 |
src/commands/bughunter |
1 | 0 | 查看 |
src/commands/chrome |
2 | 0 | 查看 |
src/commands/clear |
4 | 0 | 查看 |
src/commands/color |
2 | 0 | 查看 |
src/commands/compact |
2 | 0 | 查看 |
src/commands/config |
2 | 0 | 查看 |
src/commands/context |
3 | 0 | 查看 |
src/commands/copy |
2 | 0 | 查看 |
src/commands/cost |
2 | 0 | 查看 |
src/commands/ctx_viz |
1 | 0 | 查看 |
src/commands/debug-tool-call |
1 | 0 | 查看 |
src/commands/desktop |
2 | 0 | 查看 |
src/commands/diff |
2 | 0 | 查看 |
src/commands/doctor |
2 | 0 | 查看 |
src/commands/effort |
2 | 0 | 查看 |
src/commands/env |
1 | 0 | 查看 |
src/commands/exit |
2 | 0 | 查看 |
src/commands/export |
2 | 0 | 查看 |
src/commands/extra-usage |
4 | 0 | 查看 |
src/commands/fast |
2 | 0 | 查看 |
src/commands/feedback |
2 | 0 | 查看 |
src/commands/files |
2 | 0 | 查看 |
src/commands/good-claude |
1 | 0 | 查看 |
src/commands/heapdump |
2 | 0 | 查看 |
src/commands/help |
2 | 0 | 查看 |
src/commands/hooks |
2 | 0 | 查看 |
src/commands/ide |
2 | 0 | 查看 |
src/commands/install-github-app |
14 | 0 | 查看 |
src/commands/install-slack-app |
2 | 0 | 查看 |
src/commands/issue |
1 | 0 | 查看 |
src/commands/keybindings |
2 | 0 | 查看 |
src/commands/login |
2 | 0 | 查看 |
src/commands/logout |
2 | 0 | 查看 |
src/commands/mcp |
4 | 0 | 查看 |
src/commands/memory |
2 | 0 | 查看 |
src/commands/mobile |
2 | 0 | 查看 |
src/commands/mock-limits |
1 | 0 | 查看 |
src/commands/model |
2 | 0 | 查看 |
src/commands/oauth-refresh |
1 | 0 | 查看 |
src/commands/onboarding |
1 | 0 | 查看 |
src/commands/output-style |
2 | 0 | 查看 |
src/commands/passes |
2 | 0 | 查看 |
src/commands/perf-issue |
1 | 0 | 查看 |
src/commands/permissions |
2 | 0 | 查看 |
src/commands/plan |
2 | 0 | 查看 |
src/commands/plugin |
17 | 0 | 查看 |
src/commands/pr_comments |
1 | 0 | 查看 |
src/commands/privacy-settings |
2 | 0 | 查看 |
src/commands/rate-limit-options |
2 | 0 | 查看 |
src/commands/release-notes |
2 | 0 | 查看 |
src/commands/reload-plugins |
2 | 0 | 查看 |
src/commands/remote-env |
2 | 0 | 查看 |
src/commands/remote-setup |
3 | 0 | 查看 |
src/commands/rename |
3 | 0 | 查看 |
src/commands/reset-limits |
1 | 0 | 查看 |
src/commands/resume |
2 | 0 | 查看 |
src/commands/review |
4 | 0 | 查看 |
src/commands/rewind |
2 | 0 | 查看 |
src/commands/sandbox-toggle |
2 | 0 | 查看 |
src/commands/session |
2 | 0 | 查看 |
src/commands/share |
1 | 0 | 查看 |
src/commands/skills |
2 | 0 | 查看 |
src/commands/stats |
2 | 0 | 查看 |
src/commands/status |
2 | 0 | 查看 |
src/commands/stickers |
2 | 0 | 查看 |
src/commands/summary |
1 | 0 | 查看 |
src/commands/tag |
2 | 0 | 查看 |
src/commands/tasks |
2 | 0 | 查看 |
src/commands/teleport |
1 | 0 | 查看 |
src/commands/terminalSetup |
2 | 0 | 查看 |
src/commands/theme |
2 | 0 | 查看 |
src/commands/thinkback |
2 | 0 | 查看 |
src/commands/thinkback-play |
2 | 0 | 查看 |
src/commands/upgrade |
2 | 0 | 查看 |
src/commands/usage |
2 | 0 | 查看 |
src/commands/vim |
2 | 0 | 查看 |
src/commands/voice |
2 | 0 | 查看 |
src/components/ClaudeCodeHint |
1 | 0 | 查看 |
src/components/CustomSelect |
10 | 0 | 查看 |
src/components/DesktopUpsell |
1 | 0 | 查看 |
src/components/FeedbackSurvey |
9 | 0 | 查看 |
src/components/HelpV2 |
3 | 0 | 查看 |
src/components/HighlightedCode |
1 | 0 | 查看 |
src/components/LogoV2 |
15 | 0 | 查看 |
src/components/LspRecommendation |
1 | 0 | 查看 |
src/components/ManagedSettingsSecurityDialog |
2 | 0 | 查看 |
src/components/Passes |
1 | 0 | 查看 |
src/components/PromptInput |
21 | 0 | 查看 |
src/components/Settings |
4 | 0 | 查看 |
src/components/Spinner |
12 | 0 | 查看 |
src/components/StructuredDiff |
2 | 0 | 查看 |
src/components/TrustDialog |
2 | 0 | 查看 |
src/components/agents |
13 | 1 | 查看 |
src/components/design-system |
16 | 0 | 查看 |
src/components/diff |
3 | 0 | 查看 |
src/components/grove |
1 | 0 | 查看 |
src/components/hooks |
6 | 0 | 查看 |
src/components/mcp |
12 | 1 | 查看 |
src/components/memory |
2 | 0 | 查看 |
src/components/messages |
33 | 1 | 查看 |
src/components/permissions |
15 | 15 | 查看 |
src/components/sandbox |
5 | 0 | 查看 |
src/components/shell |
4 | 0 | 查看 |
src/components/skills |
1 | 0 | 查看 |
src/components/tasks |
12 | 0 | 查看 |
src/components/teams |
2 | 0 | 查看 |
src/components/ui |
3 | 0 | 查看 |
src/components/wizard |
5 | 0 | 查看 |
src/entrypoints/sdk |
3 | 0 | 查看 |
src/hooks/notifs |
16 | 0 | 查看 |
src/hooks/toolPermission |
2 | 1 | 查看 |
src/ink/components |
18 | 0 | 查看 |
src/ink/events |
10 | 0 | 查看 |
src/ink/hooks |
12 | 0 | 查看 |
src/ink/layout |
4 | 0 | 查看 |
src/ink/termio |
9 | 0 | 查看 |
src/native-ts/color-diff |
1 | 0 | 查看 |
src/native-ts/file-index |
1 | 0 | 查看 |
src/native-ts/yoga-layout |
2 | 0 | 查看 |
src/plugins/bundled |
1 | 0 | 查看 |
src/services/AgentSummary |
1 | 0 | 查看 |
src/services/MagicDocs |
2 | 0 | 查看 |
src/services/PromptSuggestion |
2 | 0 | 查看 |
src/services/SessionMemory |
3 | 0 | 查看 |
src/services/analytics |
9 | 0 | 查看 |
src/services/api |
20 | 0 | 查看 |
src/services/autoDream |
4 | 0 | 查看 |
src/services/compact |
11 | 0 | 查看 |
src/services/extractMemories |
2 | 0 | 查看 |
src/services/lsp |
7 | 0 | 查看 |
src/services/mcp |
23 | 0 | 查看 |
src/services/oauth |
5 | 0 | 查看 |
src/services/plugins |
3 | 0 | 查看 |
src/services/policyLimits |
2 | 0 | 查看 |
src/services/remoteManagedSettings |
5 | 0 | 查看 |
src/services/settingsSync |
2 | 0 | 查看 |
src/services/teamMemorySync |
5 | 0 | 查看 |
src/services/tips |
3 | 0 | 查看 |
src/services/toolUseSummary |
1 | 0 | 查看 |
src/services/tools |
4 | 0 | 查看 |
src/skills/bundled |
17 | 0 | 查看 |
src/tasks/DreamTask |
1 | 0 | 查看 |
src/tasks/InProcessTeammateTask |
2 | 0 | 查看 |
src/tasks/LocalAgentTask |
1 | 0 | 查看 |
src/tasks/LocalShellTask |
3 | 0 | 查看 |
src/tasks/RemoteAgentTask |
1 | 0 | 查看 |
src/tools/AgentTool |
14 | 1 | 查看 |
src/tools/AskUserQuestionTool |
2 | 0 | 查看 |
src/tools/BashTool |
18 | 0 | 查看 |
src/tools/BriefTool |
5 | 0 | 查看 |
src/tools/ConfigTool |
5 | 0 | 查看 |
src/tools/EnterPlanModeTool |
4 | 0 | 查看 |
src/tools/EnterWorktreeTool |
4 | 0 | 查看 |
src/tools/ExitPlanModeTool |
4 | 0 | 查看 |
src/tools/ExitWorktreeTool |
4 | 0 | 查看 |
src/tools/FileEditTool |
6 | 0 | 查看 |
src/tools/FileReadTool |
5 | 0 | 查看 |
src/tools/FileWriteTool |
3 | 0 | 查看 |
src/tools/GlobTool |
3 | 0 | 查看 |
src/tools/GrepTool |
3 | 0 | 查看 |
src/tools/LSPTool |
6 | 0 | 查看 |
src/tools/ListMcpResourcesTool |
3 | 0 | 查看 |
src/tools/MCPTool |
4 | 0 | 查看 |
src/tools/McpAuthTool |
1 | 0 | 查看 |
src/tools/NotebookEditTool |
4 | 0 | 查看 |
src/tools/PowerShellTool |
14 | 0 | 查看 |
src/tools/REPLTool |
2 | 0 | 查看 |
src/tools/ReadMcpResourceTool |
3 | 0 | 查看 |
src/tools/RemoteTriggerTool |
3 | 0 | 查看 |
src/tools/ScheduleCronTool |
5 | 0 | 查看 |
src/tools/SendMessageTool |
4 | 0 | 查看 |
src/tools/SkillTool |
4 | 0 | 查看 |
src/tools/SleepTool |
1 | 0 | 查看 |
src/tools/SyntheticOutputTool |
1 | 0 | 查看 |
src/tools/TaskCreateTool |
3 | 0 | 查看 |
src/tools/TaskGetTool |
3 | 0 | 查看 |
src/tools/TaskListTool |
3 | 0 | 查看 |
src/tools/TaskOutputTool |
2 | 0 | 查看 |
src/tools/TaskStopTool |
3 | 0 | 查看 |
src/tools/TaskUpdateTool |
3 | 0 | 查看 |
src/tools/TeamCreateTool |
4 | 0 | 查看 |
src/tools/TeamDeleteTool |
4 | 0 | 查看 |
src/tools/TodoWriteTool |
3 | 0 | 查看 |
src/tools/ToolSearchTool |
3 | 0 | 查看 |
src/tools/WebFetchTool |
5 | 0 | 查看 |
src/tools/WebSearchTool |
3 | 0 | 查看 |
src/tools/shared |
2 | 0 | 查看 |
src/tools/testing |
1 | 0 | 查看 |
src/types/generated |
0 | 2 | 查看 |
src/utils/background |
0 | 1 | 查看 |
src/utils/bash |
15 | 1 | 查看 |
src/utils/claudeInChrome |
7 | 0 | 查看 |
src/utils/computerUse |
15 | 0 | 查看 |
src/utils/deepLink |
6 | 0 | 查看 |
src/utils/dxt |
2 | 0 | 查看 |
src/utils/filePersistence |
2 | 0 | 查看 |
src/utils/git |
3 | 0 | 查看 |
src/utils/github |
1 | 0 | 查看 |
src/utils/hooks |
17 | 0 | 查看 |
src/utils/mcp |
2 | 0 | 查看 |
src/utils/memory |
2 | 0 | 查看 |
src/utils/messages |
2 | 0 | 查看 |
src/utils/model |
16 | 0 | 查看 |
src/utils/nativeInstaller |
5 | 0 | 查看 |
src/utils/permissions |
24 | 0 | 查看 |
src/utils/plugins |
44 | 0 | 查看 |
src/utils/powershell |
3 | 0 | 查看 |
src/utils/processUserInput |
4 | 0 | 查看 |
src/utils/sandbox |
2 | 0 | 查看 |
src/utils/secureStorage |
6 | 0 | 查看 |
src/utils/settings |
16 | 1 | 查看 |
src/utils/shell |
10 | 0 | 查看 |
src/utils/skills |
1 | 0 | 查看 |
src/utils/suggestions |
5 | 0 | 查看 |
src/utils/swarm |
13 | 1 | 查看 |
src/utils/task |
5 | 0 | 查看 |
src/utils/telemetry |
9 | 0 | 查看 |
src/utils/teleport |
4 | 0 | 查看 |
src/utils/todo |
1 | 0 | 查看 |
src/utils/ultraplan |
2 | 0 | 查看 |
src/components/agents/new-agent-creation |
1 | 1 | 查看 |
src/components/mcp/utils |
1 | 0 | 查看 |
src/components/messages/UserToolResultMessage |
8 | 0 | 查看 |
src/components/permissions/AskUserQuestionPermissionRequest |
7 | 0 | 查看 |
src/components/permissions/BashPermissionRequest |
2 | 0 | 查看 |
src/components/permissions/ComputerUseApproval |
1 | 0 | 查看 |
src/components/permissions/EnterPlanModePermissionRequest |
1 | 0 | 查看 |
src/components/permissions/ExitPlanModePermissionRequest |
1 | 0 | 查看 |
src/components/permissions/FileEditPermissionRequest |
1 | 0 | 查看 |
src/components/permissions/FilePermissionDialog |
5 | 0 | 查看 |
src/components/permissions/FileWritePermissionRequest |
2 | 0 | 查看 |
src/components/permissions/FilesystemPermissionRequest |
1 | 0 | 查看 |
src/components/permissions/NotebookEditPermissionRequest |
2 | 0 | 查看 |
src/components/permissions/PowerShellPermissionRequest |
2 | 0 | 查看 |
src/components/permissions/SedEditPermissionRequest |
1 | 0 | 查看 |
src/components/permissions/SkillPermissionRequest |
1 | 0 | 查看 |
src/components/permissions/WebFetchPermissionRequest |
1 | 0 | 查看 |
src/components/permissions/rules |
8 | 0 | 查看 |
src/hooks/toolPermission/handlers |
3 | 0 | 查看 |
src/tools/AgentTool/built-in |
6 | 0 | 查看 |
src/types/generated/events_mono |
0 | 3 | 查看 |
src/types/generated/google |
0 | 1 | 查看 |
src/utils/background/remote |
2 | 0 | 查看 |
src/utils/bash/specs |
8 | 0 | 查看 |
src/utils/settings/mdm |
3 | 0 | 查看 |
src/utils/swarm/backends |
9 | 0 | 查看 |
src/components/agents/new-agent-creation/wizard-steps |
12 | 0 | 查看 |
src/types/generated/events_mono/claude_code |
0 | 1 | 查看 |
src/types/generated/events_mono/common |
0 | 1 | 查看 |
src/types/generated/events_mono/growthbook |
0 | 1 | 查看 |
src/types/generated/google/protobuf |
1 | 0 | 查看 |
src/types/generated/events_mono/claude_code/v1 |
1 | 0 | 查看 |
src/types/generated/events_mono/common/v1 |
1 | 0 | 查看 |
src/types/generated/events_mono/growthbook/v1 |
1 | 0 | 查看 |