节约 90% Token 消耗，支持 OpenAI 及国产大模型接口的下一代 AI 编程助手。
Claude-ACE (Adaptive Context Engine) 是一个从第一性原理出发构建的 AI 编程助手。它以 Anthropic 官方发布的 Claude Code 源码为基线进行深度重构，通过引入活体语义图谱、自我修复能力、意图验证闭环等机制，彻底解决了传统 AI 编程助手过度消耗 Token、强绑定单一模型等痛点。
彻底抛弃低效的文本全量读取（Grep/Cat），使用 Tree-sitter 提取代码的 AST 骨架，并通过 ExpandSymbolTool 实现"按需展开"。
| 任务场景 | 传统全量读取 (Claude Code) | Claude-ACE (骨架+按需展开) | 节约比例 |
|---|---|---|---|
| 理解大文件架构 (2000行) | ~4,500 tokens | ~450 tokens | ~90% |
| 查找特定函数逻辑 | 2,521 tokens | 1,106 tokens | 56.1% |
| 理解模块职责 | 2,497 tokens | 849 tokens | 66.0% |
| 处理超大复杂文件 (1144行) | 182,843 tokens | 28,372 tokens | 84.5% |
注：文件越大，骨架压缩比越高，节约效果越明显。
不再强绑定 Anthropic 的 Claude 模型。Claude-ACE 默认支持任何兼容 OpenAI API 格式的大模型接口，让你自由选择性价比最高的模型。
| 提供商 | 申请地址 | 环境变量 OPENAI_BASE_URL |
推荐模型 (OPENAI_MODEL) |
|---|---|---|---|
| 智谱 GLM | 申请 API Key | https://open.bigmodel.cn/api/paas/v4/ |
glm-5-turbo (推荐) / glm-4-flash (免费) |
| 通义千问 | 申请 API Key | https://dashscope.aliyuncs.com/compatible-mode/v1 |
qwen-turbo / qwen-max / qwen-coder-plus |
| DeepSeek | 申请 API Key | https://api.deepseek.com/v1 |
deepseek-chat / deepseek-reasoner |
| MiniMax | 申请 API Key | https://api.minimax.chat/v1 |
MiniMax-Text-01 / abab6.5s-chat |
| Kimi | 申请 API Key | https://api.moonshot.cn/v1 |
moonshot-v1-8k / moonshot-v1-32k |
| OpenAI | 申请 API Key | https://api.openai.com/v1 |
gpt-4o-mini / gpt-4o |
✨ 首次启动配置向导
Claude-ACE v0.8.4 引入了交互式配置向导。首次启动时，系统会引导你一次性填写所有想使用的提供商的 API Key。
Key 会被安全地持久化保存到 ~/.ace-keys.json 中，重启后自动加载，无需重复配置。
🔄 无缝切换模型
配置完成后，在运行中随时输入 /model <模型名称>（例如 /model deepseek-chat），系统会自动加载对应提供商的 Key 和 Base URL，立即生效，无需重启。
如果需要更新或补充 Key，随时输入 /setup 即可重新进入配置向导。
| 维度 | Claude Code | Claude-ACE | 核心突破 |
|---|---|---|---|
| 一：上下文理解 | 文本检索 (Grep/Glob) | 活体系统语义图谱 | AST 骨架 + 按需展开 + CallGraph 蝴蝶效应分析，Token 直降 90% |
| 二：运行模式 | 被动唤醒的 REPL | 主动演化与自我修复 | 后台 Watchdog 守护进程，真实运行 npm test 并自动修复 |
| 三：代码生成 | 直接修改 → 报错 → 重试 | 意图驱动的验证闭环 | 意图 → 测试 → 实现 → 自愈，骨架失败自动降级全量上下文 |
| 四：架构思维 | 顺从的"打字员" | 批判性思维架构师 | CriticalArchitect 拒绝糟糕设计，主动提供安全/性能更优的建议 |
| 五：知识积累 | 仅限当前项目上下文 | 跨维度工程直觉 | CrossProjectMemory 持久化跨项目记忆 + 三问质量门控 |
- Node.js >= 18
- 兼容 OpenAI 格式的 API Key
# 1. 克隆仓库
git clone https://github.com/OpenDemon/claude-ace.git
cd claude-ace
# 2. 安装依赖并注册全局命令
npm install
npm link
# 3. 启动 Claude-ACE（之后在任意目录均可直接运行）
ace注：首次启动会自动弹出配置向导，引导你填写 API Key。启动时会自动检测 Key 的连通性，如果失效会立即提示更新。你也可以随时通过设置环境变量 OPENAI_API_KEY、OPENAI_BASE_URL 和 OPENAI_MODEL 来覆盖默认配置。
Claude-ACE 提供了对标 Claude Code 的完整 TUI 交互体验，输入 / 即可弹出交互式菜单：
Claude-ACE 的核心架构分为三层，共 10 个核心工具：
┌─────────────────────────────────────────────────────────────┐
│ Claude-ACE Agent Loop │
├──────────────────┬──────────────────┬───────────────────────┤
│ 感知层 │ 决策层 │ 执行层 │
│ (Perception) │ (Reasoning) │ (Execution) │
│ │ │ │
│ SemanticSearch │ CriticalArchitect│ IntentVerify │
│ FileRead (ACE) │ CrossProjectMemory BashTool │
│ ExpandSymbol │ WatchdogAgent │ FileWrite │
│ CallGraph │ │ GrepTool │
└──────────────────┴──────────────────┴───────────────────────┘
- 感知层 (Perception)：将物理文件转化为结构化语义图谱，支持按需展开和调用图（Call Graph）影响分析。
- 决策层 (Reasoning)：在修改代码前进行架构评估，并检索高质量的历史调试经验。
- 执行层 (Execution)：基于意图生成测试，代码必须通过测试才会被接受；后台 Watchdog 持续守护代码库健康。
- P0 安全修复 — GrepTool 命令注入：改用
spawnSync参数数组传递，彻底消除 shell 注入漏洞。 - P0 安全修复 — BashTool 过滤加强：黑名单从 3 条扩充到 20+ 条，新增 pipe-to-shell、系统目录写入、反弹 shell 等危险模式检测。
- P0 安全修复 — FileWriteTool 路径保护：路径
resolve()防穿越攻击，阻止写入/etc/、/bin/、C:\Windows\等系统目录和敏感文件。 - P1 修复 — IntentVerify / CriticalArchitect 动态模型：删除硬编码的
gpt-4.1-mini，改为每次请求动态读取用户当前配置的模型和 Key。 - P1 修复 — Watchdog 防重叠：加
_scanning标志位 +try/finally，防止多次扫描并发执行导致资源竞争。
- 全局
ace命令：支持通过npm link注册全局命令，在任意目录直接输入ace即可启动。 - 启动时静默连通性检测：启动时自动检测已保存 Key 的有效性，遇到 401/402 错误立即引导用户更新，避免等到第一次对话才报错。
- Worker Thread 架构：Agent 移至独立线程运行，主线程始终保持响应。支持在 Agent 执行任务期间输入新指令（如按
Ctrl+C取消当前任务）。 - 首次启动配置向导：自动引导填写各提供商 API Key，持久化保存至
~/.ace-keys.json，重启自动加载。 - 无缝模型切换：
/model命令切换模型时自动加载对应提供商的 Key，彻底解决 Key 混用导致的 401 错误。 - 新增
/setup命令：随时重新配置任意提供商的 API Key。 - 全面扩展国产模型支持：内置通义千问、DeepSeek、MiniMax、Kimi 等主流国产模型配置。
- 完整 CLI 体验：补全 19 个斜杠命令（
/status,/skills,/resume,/memory,/watchdog,/callgraph,/model,/compact,/export,/init,/doctor,/cost等）。 - 会话持久化：启动界面展示 Recent Activity，支持本地保存、恢复和重命名对话。
- 流式交互：打字机效果输出，Markdown 实时渲染与代码高亮。
- 全面集成：10 个核心工具全部接入 Agent 主流程，五大维度形成完整闭环。
- 新增
CallGraphTool：基于 AST 的调用图分析，支持callees、callers和impact（蝴蝶效应分析）。 - 升级
WatchdogAgent：真实运行npm test和eslint，自动捕获并修复真实错误。
- 新增
ExpandSymbolTool：骨架模式下按需展开任意函数完整实现，防止幻觉。 - 升级
IntentVerificationTool：新增 Fallback 策略，骨架失败自动降级为全量上下文。 - 升级
CrossProjectMemory：引入三问质量门控机制，拒绝通用知识，只存高价值经验。
- 五大维度初始原型实现。
- 真实 LLM API 回测：Token 消耗降低 84.5%。
- sanbuphy/claude-code-source-code — Claude Code 源码提取
- zxdxjtu/claude-code-sourcemap — 修复内部依赖的可运行版本
- Yeachan-Heo/oh-my-claudecode — Learner Skill 质量门控设计启发
MIT License
Built with ❤️ by OpenDemon