pengchengneo/claude-code

定位与入口

这是从 @anthropic-ai/claude-code source map 还原的可运行 TypeScript CLI，目标是研究 Claude Code 的本地代理、终端 UI 和受门控的内部能力。开发入口为 src/entrypoints/cli.tsx，主应用装配在 src/main.tsx 与 src/setup.ts；另有初始化与 MCP 入口：src/entrypoints/init.ts、src/entrypoints/mcp.ts。

交互式 CLI 与状态层

CLI 使用 React/TSX 终端界面，根屏幕和 REPL 分别位于 src/components/App.tsx、src/screens/REPL.tsx。仓库内置 Ink 渲染/终端事件实现（而非仅依赖外部 UI）：src/ink/ink.tsx、src/ink/renderer.ts。会话级 UI 状态集中在 src/state/AppState.tsx、src/state/AppStateStore.ts，输入经 src/utils/processUserInput/processUserInput.ts 分流为文本提示、shell 输入或斜杠命令。

Agent 查询循环、工具与权限边界

核心控制流是：用户消息 → 查询/模型流 → 工具调用 → 权限决策 → 工具结果回注会话。查询编排的关键边界在 src/QueryEngine.ts、src/query.ts、src/query/transitions.ts；工具执行由 src/services/tools/toolOrchestration.ts 和 src/services/tools/StreamingToolExecutor.ts 统一调度。具体能力以工具模块实现，如 src/tools/BashTool/BashTool.tsx、src/tools/FileEditTool/FileEditTool.ts、src/tools/AgentTool/AgentTool.tsx。权限规则与模式在 src/utils/permissions/permissions.ts、src/utils/permissions/PermissionMode.ts，交互审批 UI 位于 src/components/permissions/PermissionPrompt.tsx；这是模型行为与本地文件/进程副作用之间的主要安全边界。

命令、扩展与上下文持久化

斜杠命令注册/路由以 src/commands.ts 为中心，命令实现位于 src/commands/；它们改变会话、配置或调用服务，而非独立应用入口。插件、技能和 MCP 是三条扩展边界：src/services/plugins/PluginInstallationManager.ts、src/skills/loadSkillsDir.ts、src/services/mcp/MCPConnectionManager.tsx。本地记忆与上下文压缩分别由 src/memdir/memdir.ts、src/services/compact/compact.ts、src/services/SessionMemory/sessionMemory.ts 管理，以控制长会话 token 与跨会话信息复用。

并发代理与远程会话

任务抽象统一本地 shell、工作流、子代理与远程代理，核心类型/生命周期在 src/tasks/types.ts、src/tasks/LocalAgentTask/LocalAgentTask.tsx、src/tasks/RemoteAgentTask/RemoteAgentTask.tsx。多 Agent coordinator 通过 src/coordinator/coordinatorMode.ts 和 src/coordinator/workerAgent.ts 将主代理限制为委派/通信/停止角色。远程会话由 src/remote/RemoteSessionManager.ts、src/remote/SessionsWebSocket.ts 管理；远程控制 bridge 则通过 src/bridge/bridgeMain.ts、src/bridge/bridgeMessaging.ts、src/bridge/bridgePermissionCallbacks.ts 同步消息、状态与审批。

外部依赖、平台与功能门控

运行要求 Bun 与 Node；终端 UI 使用 React/Ink，原生能力通过本地兼容包连接，例如 shims/color-diff-napi/index.ts、shims/ant-computer-use-mcp/index.ts。网络边界包括 Claude API 客户端（src/services/api/claude.ts、src/services/api/client.ts）、OAuth（src/services/oauth/client.ts）、MCP server/client、WebSocket/SSE transport（src/cli/transports/WebSocketTransport.ts、src/cli/transports/SSETransport.ts），并支持 AWS Bedrock/Google Vertex 模型路径。功能可被编译开关、USER_TYPE 和 GrowthBook 远程实验共同限制；实验接入集中于 src/services/analytics/growthbook.ts，因此功能存在并不等于外部运行时可用。