README

本章介绍 Claude Code 的核心设计理念和架构思想。

章节内容

• 架构设计 - 整体架构和模块划分

• 设计哲学 - 核心设计原则和权衡

• 技术栈 - 技术选型和依赖关系

核心思想

Claude Code 的设计围绕三个核心思想展开：

1

终端即 IDE

传统的 AI 编程助手通常以 IDE 插件的形式存在，但 Claude Code 选择了不同的路径：

• 将终端作为第一公民

• 使用 React + Ink 构建富交互 TUI

• 保持命令行工作流的连贯性

2

安全第一的自主性

Claude Code 在自主性和安全性之间找到了平衡：

• 三层权限模型（规则层、模式层、工具层）

• 2600+ 行 Bash 命令权限检查

• 分类器辅助的智能审批

• 用户始终拥有最终控制权

3

上下文是稀缺资源

在 token 预算有限的情况下，Claude Code 采用了激进的上下文管理策略：

• 五层压缩机制

• 智能内容裁剪

• 动态上下文加载

• 缓存边界优化

设计权衡

Claude Code 在多个维度上做出了明确的设计选择：

维度	选择	原因
UI	终端 TUI	保持开发者工作流连贯性
架构	异步生成器	流式响应，更好的用户体验
工具	插件化	可扩展性和模块化
安全	权限优先	保护用户系统安全
性能	启动速度	首次交互时间 < 1 秒

关键创新

1. Query Loop - 基于异步生成器的执行引擎

2. Streaming Tools - 并发工具执行 + 实时反馈

3. Context Collapse - 激进的上下文压缩策略

4. Bash Permissions - 细粒度的命令权限控制

5. MCP Integration - 完整的 Model Context Protocol 实现

下一步，深入了解 架构设计。