CC

ClaudeCode Source Analysis

关键文件与术语

索引

把高价值文件和关键术语固定下来，后续阅读会快很多

这页适合作为长期书签页。每次你忘记“某个核心抽象定义在哪”或“某条链路应该从哪读起”，可以先回到这里。

关键文件索引

src/main.tsx

主入口与高层装配中心，决定产品模式、命令/工具装配和运行路径分流。

src/setup.ts

会话环境准备层，负责 cwd、hook、worktree、tmux、terminal 恢复等运行前提。

src/entrypoints/init.ts

基础设施初始化层，负责 settings、安全环境变量、网络、OAuth、scratchpad 等。

src/replLauncher.tsx

REPL 渲染入口桥，衔接高层装配和交互界面启动。

src/interactiveHelpers.tsx

交互辅助逻辑聚合点，帮助理解 REPL 入口附近的 UI 编排。

src/commands.ts

命令来源聚合器，统一 built-in、workflow、skills、plugin commands。

src/tools.ts

工具全集定义与按 feature / 环境装配的中心。

src/Tool.ts

工具协议定义地，ToolUseContext 和 buildTool() 默认行为都在这里。

src/QueryEngine.ts

会话级 façade，负责 transcript、usage、abort 和 headless 路径语义。

src/query.ts

turn 级共享执行内核，负责 compact、budget、API 调用和 tool loop。

src/hooks/useCanUseTool.tsx

权限判定入口之一，能看清 rules、classifier、interactive handler 怎样组合。

src/services/tools/toolExecution.ts

工具执行总调度点，权限、hooks、telemetry 和结果封装都汇聚于此。

src/services/mcp/config.ts

MCP 配置合并与去重中心，能看清企业/托管优先级。

src/utils/plugins/pluginLoader.ts

插件安装、校验、缓存和 marketplace 路径治理中心。

src/tools/AgentTool/runAgent.ts

子 agent 运行时装配点，适合观察 transcript、MCP、skills、cleanup 如何组合。

src/screens/REPL.tsx

最大集成壳，运行态复杂度热点，也是理解真实产品行为的关键窗口。

术语表

REPL

终端交互主界面，不只是文本输入框，而是集成 query、任务、权限、通知和消息渲染的运行壳。

QueryEngine

会话级 façade，负责 headless/SDK 路径下的 transcript、usage、abort 和恢复语义；它不是唯一执行入口。

query()

共享执行内核，真正的 turn 级状态机；REPL 与 QueryEngine 都会进入这里。

ToolUseContext

工具执行上下文，是工具层和应用层之间最关键的协议之一。

AppState

统一运行态容器，包含 UI、任务、MCP、插件、notifications、prompt suggestion 等。

Skill

markdown/frontmatter 驱动的 prompt command，偏流程知识与提示复用。

MCP

外部能力协议层，可提供 tools、resources、prompts、auth，属于一等扩展通道。

Worktree

用于隔离 agent 或 session 执行环境的 git 工作树，也是安全与并行执行策略的一部分。

← 上一页：学习路径 回到首页 →