这是《手把手教你做一个 Mini Code Agent：从工具调用、上下文到 MCP 与多代理》的配套源码仓库。
本仓库包含三个可以独立运行的 TypeScript 项目：
| 目录 | 对应内容 | 是否需要 API Key |
|---|---|---|
mini-agent/ |
主线项目：最小 Code Agent，支持读文件、写文件、跑命令、搜索、上下文与权限 | 启动真实对话需要 ANTHROPIC_API_KEY；测试不需要 |
project-analyzer-mcp/ |
MCP Server 示例：暴露项目结构、依赖、复杂度分析工具 | 不需要 |
multi-agent-review/ |
多代理 Review 示例：Coordinator + Security/Performance/Style Worker | 运行真实审查需要 ANTHROPIC_API_KEY；测试不需要 |
- Node.js 20+
- npm 10+
- 一个 Anthropic API Key（真实对话需要）
git clone https://github.com/jiji262/mini-code-agent.git
cd mini-code-agent/mini-agent
npm ci
npm run buildexport ANTHROPIC_API_KEY="sk-ant-..."
npm start -- --cwd . --no-session看到欢迎界面后，输入第一条 prompt：
请读取 package.json，告诉我这个项目有哪些 npm scripts。
预期现象：
- 终端出现
[Tool] ReadFile(...)。 - 工具返回
package.json内容摘要。 - Agent 用自然语言列出
build、start、dev、typecheck、test等脚本。
npm run typecheck
npm test
npm run build这三条命令不会调用模型，只验证 TypeScript、工具注册表、文件读写、搜索、命令执行、权限判断等本地逻辑。
在仓库根目录运行：
./scripts/smoke.sh该脚本会依次进入三个项目执行：
npm ci
npm run typecheck
npm test
npm run build全部通过时输出：
All smoke checks passed.
真实对话需要先设置 API Key：
export ANTHROPIC_API_KEY="sk-ant-..."如果你只想验证本地代码是否能跑，执行 npm test 即可，不需要 API Key。
请先安装 Node.js 20+。安装后确认：
node -v
npm -v先安装并构建：
npm ci
npm run buildproject-analyzer-mcp 的 stdio 输出是 JSON-RPC 协议通道。不要在 stdio 入口里用 console.log 打调试日志，日志应写到 stderr。
mini-agent/：本教程原创教学实现。project-analyzer-mcp/：本教程原创 MCP 示例。multi-agent-review/：本教程原创多代理示例。
教程会参考 Claude Code 的公开架构与使用体验来解释设计取舍，但本仓库不是 Claude Code 源码复刻，也不承诺与 Claude Code 内部实现逐行一致。