MiniCC

极简版 Claude Code，用于教学。

想知道 Claude Code 这类 AI 编程助手是怎么实现的？ 看这个项目就够了。核心代码约 1400 行，架构清晰，注释充分。

能干嘛

• 读写文件、搜索代码、执行 shell 命令
• 创建子任务并行处理
• 终端 UI 界面，支持流式输出

技术栈

• pydantic-ai - Agent 框架
• Textual - TUI 框架

快速开始

# 设置 API Key
export ANTHROPIC_API_KEY="your-key"
# 或 export OPENAI_API_KEY="your-key"

# 直接运行（无需安装）
uvx minicc

# 或者安装后运行
uv pip install minicc
minicc

开发

git clone https://github.com/TokenRollAI/miniCC.git
cd miniCC
uv sync
uv run minicc

项目结构

minicc/
├── app.py       # TUI 主程序
├── agent.py     # Agent 定义
├── tools.py     # 工具实现 (文件操作、搜索、bash)
├── config.py    # 配置管理
├── schemas.py   # 数据模型
└── ui/          # UI 组件

配置

配置文件在 ~/.minicc/config.json：

{
  "provider": "anthropic",
  "model": "claude-sonnet-4-20250514"
}

Prompt Cache (Anthropic)

按照 pydantic-ai Anthropic 指南 可以在配置里开启 prompt caching：

{
  "provider": "anthropic",
  "model": "claude-sonnet-4-20250514",
  "prompt_cache": {
    "instructions": true,
    "tool_definitions": "1h",
    "messages": true
  }
}

• instructions 缓存系统提示词；tool_definitions 缓存工具定义；messages 缓存最近一条用户消息
• true 表示 5 分钟 TTL，或显式写 "5m" / "1h"
• Anthropic 最多支持 4 个 cache points，pydantic-ai 会按指南自动裁剪超出的 CachePoint

工具列表

工具	作用
read_file	读文件
write_file	写文件
update_file	改文件
search_files	按模式搜索文件
grep	正则搜索内容
bash	执行命令
spawn_agent	创建子任务

License

MIT