claude-code-from-scratch

环境要求

• Node.js 与 npm（TypeScript 版需要）
• Python 3.11+（Python 版需要）
• 支持 Anthropic 格式或 OpenAI 兼容格式的 API Key
• git 用于克隆仓库

安装与启动步骤

1. 1克隆项目仓库

   把仓库克隆到本地并进入根目录，后续 npm 命令都在此目录执行。

   git clone https://github.com/Windy3f3f3f3f/claude-code-from-scratch.git
   cd claude-code-from-scratch

   复制

2. 2构建 TypeScript 版

   在根目录安装 npm 依赖并编译，产出可运行的命令行工具。

   npm install && npm run build

   复制

3. 3安装 Python 版

   进入 python 子目录，用 editable 模式安装，需 Python 3.11+，详见 python/README.md。

   cd python
   pip install -e .

   复制

4. 4配置 API 密钥

   二选一即可，程序按环境变量自动识别后端；Anthropic 格式为推荐方式，base url 可选。

   export ANTHROPIC_API_KEY="sk-ant-xxx"
   export ANTHROPIC_BASE_URL="https://aihubmix.com"

   复制

5. 5启动 TypeScript 版

   在项目根目录运行，进入交互式 REPL 模式（推荐）。

   npm start

   复制

6. 6启动 Python 版

   在任意目录运行 mini-claude-py，这是 Python 版专用入口，避免与 TS 版命令冲突。

   mini-claude-py

   复制

关键配置

如何确认成功

执行 npm start 或 mini-claude-py 后进入交互式 REPL，输入问题能得到模型回复即表示配置成功。

常见问题

注意事项

• 本项目是学习项目，参照 Claude Code 公开可观察行为手写，不保证与真实内部实现一致，与 Anthropic 无关联。
• --yolo 会跳过安全确认并自动执行危险命令，仅在可信环境中使用。
• 命令行参数优先级高于环境变量，例如 --model 会覆盖 MINI_CLAUDE_MODEL。
• README 提到每个代码章都能一条命令跑起来且不用 API key，具体方式请查看教程中的「每章代码都能跑」一节。