Klaat Code
终端原生 AI 编程代理：按请求智能路由模型层级，以约十分之一的成本实现 Claude Code 级别的代码修改准确性，并可复现验证。
权限模型（三层确认、allow once/session/always/deny、项目目录沙箱、硬拒系统路径、before_tool hook 可阻断）在 README 与 SECURITY.md 中有具体描述，得 2；但所有消息均发送至闭源的 Klaatu 托管服务，路由/计费逻辑不可审计，且 curl|bash 安装脚本与闭源依赖削弱最小权限与依赖安全证据（dependency_security 仅 1）；/undo、/checkpoint、/rollback 提供回滚路径；许可证含商标条款与版权声明，署名清楚，但 publisher 未经验证，仅按文件证据给 2。
CI 覆盖 typecheck、单元测试、bench selfcheck 与构建，失败信息与 /doctor 诊断命令有文档支撑；但 package. 与 README/许可证之间存在自相矛盾（license 字段 MIT vs LICENSE Apache 2.0，包名 klaatai vs npm klaatcode），扣至 1；依赖极少但无锁文件、无依赖审计或 SBOM 证据，dependency_availability 1；错误提示文档化程度中等，2。
受众与场景说明充分：终端开发者、CI（--max-cost、GitHub Actions 示例）、headless/API server/浏览器模式、BYOM（OpenAI 兼容端点）、MCP、多平台安装，给 3；能力边界（titan 需显式请求、Plan 模式只读工具、titan 有每日上限）有说明但部分依赖闭源服务行为，2；触发精度（路由分级、doom-loop 检测）描述具体但不可静态验证，2；环境覆盖 macOS/Linux/Windows 及 shell 补全，2。
信息架构极佳：功能、命令、配置、目录结构分节清晰，3；安装说明覆盖 npm/脚本/Homebrew/Windows 含 EACCES 故障排查，3；命名不稳定——README 主推 klaatcode 而 package. bin 是 klaatai，license 字段与 LICENSE 文件冲突，扣至 1；示例丰富但 FAQ 缺失，2；已知局限仅有零散'honesty notes'指向外部文档，1；license 元数据自相矛盾（NOASSERTION、package. 写 MIT、实际 Apache 2.0），1；CHANGELOG.md 被引用但不在证据文件中，版本 2.5.0 无 changelog 内容佐证，1；维护责任有 SECURITY.md 的响应时限与 issue 路由，2。
输出可用性有大量 UI/UX 描述（diff 渲染、流式、会话导出），2；边际价值主张（按请求路由、成本护栏、代码图）具体且与同类工具对比明确，但这些是闭源服务端实现的主张，2；成本收益有量化基准与可复现脚本（bun run bench），但基准结果本身不可静态核实，2。
基准声称附方法论文档与复现命令，claim_traceability 2；关键主张（服务端路由、免费工具轮次、效果数据）依赖闭源后端与外部站点，无法在仓库内交叉印证，cross_source_corroboration 1；事实与推断分离做得较好——README 明确标注'est'估算、honesty notes、advisory-only bot 声明，2。
- 所有对话与代码上下文都会发送至闭源的 Klaatu 托管服务，路由与计费逻辑不可审计，敏感代码项目需评估数据外发风险。
- 推荐安装方式包含 curl|bash 远程脚本执行，供应链风险高于纯 npm 安装。
- license 元数据自相矛盾（仓库标 NOASSERTION，package. 写 MIT，实际文件为 Apache 2.0），使用前需确认实际许可条款与商标限制。
- 基准成绩与'5.4× 更便宜'等主张依赖闭源服务端与自建 fixtures，无法从仓库静态核实，采纳前应自行运行 bench。
- 包名/命令名（klaatcode vs klaatai）与 CHANGELOG 引用不一致，npm 包与仓库的对应关系需自行确认。
这个 Agent 能做什么，适合哪些场景？
Klaat Code 是 KlaatAI 开源的终端编程代理，安装一次后可在任意项目中读取代码、编辑文件、运行命令并自行验证结果，所有请求经其托管的 Klaatu 路由服务按六个成本层级（nano/fast/code/reason/heavy/titan）自动分发。客户端本身是薄终端，路由决策、模型健康跟踪、代码图谱索引等智能均在服务端（klaatai.com）实现。它内置代码调用图谱与语义检索，使代理通过符号、调用方和影响面查询代替整文件读取，官方称每任务可省 5–15 倍 token。项目提供可复现的基准测试（bun run bench）、完整的斜杠命令体系、MCP 客户端（stdio 与 Streamable HTTP，含 OAuth 2.1）、Git 集成、技能（Skills）、钩子（Hooks）、插件以及 headless/CI 和 API 服务器模式。许可为 Apache 2.0，但核心智能依赖 KlaatAI 托管服务，需要 KlaatAI 账号登录使用。
安装后运行 klaatcode（或别名 klaatai）在当前目录打开会话；浏览器 OAuth 登录 KlaatAI 账号后，代理通过 read_file、edit_file/multi_edit、apply_patch、glob/grep/list_dir、run_command（需权限确认）、web_search/web_fetch、project_graph_query、plan_exploration、impact_check、delegate_task、browser_* 等内置工具完成读码、改码、执行与验证。每次请求由 Klaatu 分类并路由到成本层级，难度上升时自动升级层级。编辑后自动运行项目的类型检查器/代码规范工具（如 eslint、ruff、gofmt、shellcheck 等）并将错误回传给模型当场修复。会话支持 /compact 上下文压缩与自检、/cost 实时花费监控、/diff /review /commit /checkpoint 等 Git 工作流、.klaatai/mcp. 的 MCP 服务器管理、/sessions /resume 会话恢复，以及 klaatcode run 的 headless 模式与 klaatcode serve 的 API 服务器模式。
- 需要在终端中自动修复类型错误、重构代码并自行验证的开发者，尤其是希望每次编辑后立即得到 lint/类型检查反馈的团队
- 预算敏感的个人开发者或学生，想让琐碎提问走低价层级、只有真正难题才调用前沿模型
- 需要在 CI 中自动化修复 lint 错误或安全审查的工程团队，可用 klaatcode run 配合 --max-cost 和 GitHub Actions secrets
- 维护大型代码库的工程师，借助代码调用图谱与 impact_check 在改动前评估影响面，减少 token 消耗
- 需要代理并行处理子任务的场景，可用 delegate_task 在后台派出子代理，同时继续与主会话对话
- 已有 OpenAI 兼容自建模型端点的用户，可用 /model add 按会话切换到自己的模型
这个 Agent 有哪些优点和局限？
- 按请求智能模型路由：琐碎请求走 nano/fast 层级，难题自动升级到 reason/heavy/titan，官方基准显示每解决任务成本 $0.027，比 Claude Code（Sonnet 5）便宜 5.4 倍且 33/33 全解
- 代码知识图谱与 plan_exploration：通过符号/调用方/影响面查询代替整文件读取，官方称每任务省 5–15 倍 token
- 完善的成本防护：燃烧率监控（3× 会话均值告警）、阶段预算、会话硬上限（maxSessionCost）、CI 用 --max-cost，以及针对重复失败调用的死循环熔断
- 工具调用不计费且无 Continue 按钮：单条用户消息算一次请求，工具轮次免费且无限，卡死时服务端检测并由 CLI 注入恢复建议
- 压缩可感知：/compact 前快照任务与文件、压缩后验证摘要，并告知模型丢失了什么及在哪里恢复；/context 可查看窗口内容
- 可复现基准：克隆仓库运行 bun run bench 即可自行验证与 Claude Code、Cursor、opencode、Grok Build 的对比
- 核心智能完全依赖 KlaatAI 托管路由服务（Klaatu），无法本地运行路由逻辑，离线或服务不可用时无法工作
- 必须注册 KlaatAI 账号并登录使用，属于商业服务绑定，需接受其配额与订阅计划（titan 层级有每日上限）
- GitHub API 标注 License 为 NOASSERTION，README 声称 Apache 2.0 但商标（KlaatAI/Klaat Code/Klaatu 名称与标识）不在许可范围内，采用前应核实仓库实际许可证文件
- README 中的基准数据由项目方自行运行（最新标注日期为 2026-07-20），虽然提供了复现脚本，但第三方独立验证仍属缺失
- 项目级语义搜索标注为 Pro 功能，免费用户的代码检索能力受限
如何安装或部署这个 Agent？
任选其一：npm install -g klaatcode（需 Node ≥ 18 或 Bun ≥ 1）；或 curl -fsSL https://klaatai.com/api/install | bash（macOS/Linux）；或 PowerShell 中 irm https://klaatai.com/api/install-windows | iex；或 brew install KlaatAI/klaatcode/klaatcode。所有方式安装独立编译的二进制，运行时无需 Node/Bun。macOS 遇到 EACCES 可加 sudo 或修改 npm 全局 prefix。
如何使用这个 Agent？
安装后运行 klaatcode login 完成浏览器 OAuth 登录（无需管理 API key）；klaatcode 打开当前目录，klaatcode ~/projects/my-app 打开指定项目；klaatcode run "Fix all TS errors" 以 headless 模式运行；/tier 切换或锁定路由层级，/cost 查看花费，/mcp 管理 MCP 服务器，/skill 调用提示模板，Tab 切换 Plan/Build 模式。首次可用 /init 根据技术栈生成项目规则 .klaatai/rules.md。
这个 Agent 与同类方案有什么区别？
README 将其与 Claude Code、opencode、Codex CLI、Aider、Cursor 和 Grok Build 归为同类，并在同一基准中对比：同 33 个任务上 Klaat Code 33/33 全解、每任务 $0.027（Claude Code $0.146，约便宜 5.4 倍）、中位耗时 23s；与 Claude Code 的差异还包括无 Continue 按钮、工具轮次免费，以及可复现的 bench 脚本；Cursor Composer 2.5 标准版虽成本接近但中位耗时约 113s，比 Klaat Code 慢约 5 倍。