README.md

Mini Claude Code — Python 版

与 TypeScript 版功能 99% 一致的 Python 实现。需要 Python >= 3.11。

📖 完整教程文档见 claude-code-from-scratch（文档中所有代码块均支持 TypeScript / Python 切换）

快速开始

# 安装（需要 Python 3.11+）
cd python
uv pip install -e .

# 设置 API Key。DeepSeek 使用 OpenAI 兼容格式
export OPENAI_API_KEY="你的 DeepSeek API Key"
export OPENAI_BASE_URL="https://api.deepseek.com"

# 运行：不用手动 source .venv/bin/activate
uv run mini-claude-py --model deepseek-v4-flash "hello" # 一次性模式
uv run mini-claude-py --model deepseek-v4-flash         # 交互式 REPL
uv run mini-claude-py --yolo "list files"               # 跳过确认
uv run mini-claude-py --plan "refactor this"            # 计划模式

# 如果当前终端有不兼容的代理变量，可以先临时关闭
unset HTTP_PROXY HTTPS_PROXY ALL_PROXY http_proxy https_proxy all_proxy

文件结构

Python 文件	对应 TypeScript	说明
agent.py	agent.ts	Agent 核心循环、双后端、4 层压缩
tools.py	tools.ts	10 个工具 + 5 种权限模式
__main__.py	cli.ts	CLI 入口与 REPL
ui.py	ui.ts	终端 UI（rich）
prompt.py	prompt.ts	系统提示词构造
session.py	session.ts	会话管理
memory.py	memory.ts	记忆系统
skills.py	skills.ts	技能系统
subagent.py	subagent.ts	子 Agent
frontmatter.py	frontmatter.ts	YAML frontmatter 解析

依赖

• anthropic — Anthropic SDK（流式）
• openai — OpenAI SDK（兼容后端）
• rich — 终端彩色输出