从零实现一个本地 Claude Code Agent 系统(mini 版),接入任意 Anthropic 兼容 API 即可运行。
- Python >= 3.12(如果本地已有兼容版本,直接复用,不会重复安装)
- 无需预先安装任何依赖库(Git、uv 等均由脚本自动处理)
.env配置文件可以随时编辑,只需在启动3m-core之前配置好 API Key 即可
git clone git@github.com:Vincent-chk/3M_claude.git
cd 3M_claude
docker build -t 3mclaude .
docker run -it --rm -e ANTHROPIC_API_KEY=$ANTHROPIC_API_KEY 3mclaude# 1. 克隆项目
git clone git@github.com:Vincent-chk/3M_claude.git
cd 3M_claude
# 2. 配置 LLM API Key
cp .env.example .env
# 编辑 .env,填入你的 API Key(如 ANTHROPIC_API_KEY 或对应模型密钥)
# 3. 一键安装(自动检测 Git/uv/Python,缺什么装什么)
bash scripts/install.sh
# 4. 启动守护进程(终端 A,前台运行)
3m-core
# 5. 在另一个终端,体验 TUI 界面
3m-tui在 PowerShell 中执行(右键 → 以管理员身份运行):
# 1. 克隆项目
git clone git@github.com:Vincent-chk/3M_claude.git
cd 3M_claude
# 2. 配置 LLM API Key
copy .env.example .env
# 用记事本编辑 .env,填入你的 API Key
# 3. 一键安装(自动检测 Git/uv/Python,缺什么装什么)
powershell -ExecutionPolicy Bypass -File .\scripts\install.ps1注意: 如果安装过程中遇到 SSL 证书错误(常见于企业网络),脚本已内置
UV_NATIVE_TLS=true环境变量自动使用系统证书。若仍有问题,可手动设置:$env:UV_NATIVE_TLS = "true"然后重新运行安装脚本。
启动方式与 macOS/Linux 相同:
# 终端 A — 启动守护进程
3m-core
# 终端 B — 启动 TUI 界面
3m-tuimake install # 等同于 bash scripts/install.sh
make uninstall # 卸载全局命令
make test # 运行单元测试
make lint # 代码检查| 命令 | 说明 |
|---|---|
3m --version |
查看版本 |
3m ping |
ping 守护进程 |
3m-tui |
启动 TUI 终端界面(主要入口) |
3m-core |
启动守护进程 |
3m run --goal "..." |
执行一次 Agent 任务 |
3m chat |
多轮对话 |
3m trace |
查看系统日志 |
3m core start |
后台启动守护进程 |
3m core stop |
停止守护进程 |
3m core status |
查看守护进程状态 |
| 平台 | 命令 |
|---|---|
| macOS / Linux | bash scripts/uninstall.sh |
| Windows | powershell -File .\scripts\uninstall.ps1 |
在 TUI 对话中直接输入 /skill名 即可调用对应能力:
| 命令 | 说明 |
|---|---|
/init |
分析当前项目,生成 .3m/context.md 初始内容 |
/plan |
启动规划模式,通过 HITL 交互生成结构化实施规划文档 |
/orchestrate |
用 planner → executor → reviewer 三阶段多 Agent 工作流完成复杂任务 |
/review |
对指定路径做代码审查,输出严重/建议/可选三级分类 |
/summarize |
将当前 session 对话压缩为人类可读摘要 |
/meeting-summary |
读取会议记录文件,生成结构化的 HTML 会议纪要 |
/skill-create |
引导创建新的自定义 skill,输出规范化的 SKILL.md 文件 |
自定义 skill 可放入 skills/ 目录,格式参考内置 skill 的 SKILL.md。
3mClaude 的最终形态是:
- 用户通过
3mCLI 或3m-tui连接到常驻的3m-core守护进程 - 真正执行任务的是 Core daemon,CLI 和 TUI 只是客户端
这意味着:
- TUI 崩了,Agent 任务不一定要跟着死
- 后续可以同时接 CLI、TUI、Web 前端
- 所有任务过程都能通过事件流订阅
- 所有命令、响应、事件都要通过类型化协议通信
- Agent 的工具调用、会话记忆、权限审批、上下文压缩,都在同一条运行链路里完成
用户目标
→ CLI / TUI
→ JSON-RPC over NDJSON
→ 3m-core daemon
→ AgentRunner
→ AgentLoop
→ LLM Provider
→ ToolRegistry
→ PermissionManager
→ EventBus
→ Session Store
→ TUI 实时渲染 / events.jsonl 持久化 / trace 回放
不是单次调用大模型,而是实现了完整的本地 Agent 运行时链路:
- 用户输入一个目标,Agent 能自己规划下一步
- 模型不是只回答文本,而是能主动发起工具调用
- 工具调用不是直接裸跑,而是有参数校验和权限审批
- 执行过程不是黑盒,而是通过事件流实时展示到 TUI
- 每一次 run 都能留下 events、trace、session 记录,方便复盘和排查
- 多轮会话不是简单拼接历史,而是有 thread、notes、context 分层记忆
- 上下文快爆了,不是粗暴截断,而是有水位检测和 compact 压缩
- 复杂任务可以交给子 Agent,外部工具可以通过 MCP 接进来