KlaatAI/klaatcode

Klaat Code – 终端原生 AI 编码助手

它是什么 – Klaat Code 是一个命令行工具，让您可以直接从终端与 AI 编码代理对话。您输入请求（例如 “fix all TypeScript errors”），代理会读取您的项目、编辑文件、执行命令并检查结果，同时让您保持控制权。

它是如何运作的 – 每个用户消息都会发送到 Klaatu-o1，这是一个托管的“路由器”模型。Klaatu 会决定六种成本层级模型（nano、fast、code、reason、heavy、titan）中哪一种适合该请求，并将提示转发到该处。如果任务比预期更困难，路由器可以自动升级到更强大的层级，并在不再需要额外能力时降级。只有用户消息计入您的配额；所有工具调用（文件读取、Shell 命令、网页搜索等）都是免费的。

主要差异化优势

1. 按请求智能路由 – 您无需预先选择模型；服务会选择能解决该回合的最便宜层级，并仅在必要时升级。
2. 代码图索引 – 项目被索引为语义调用图。代理可以查询符号、调用者、被调用者和影响范围，而无需加载整个文件，减少 5-15 倍的 Token 使用量。
3. 无限工具轮次 – 与许多在固定次数工具调用后停止的 CLI 代理不同，Klaat Code 允许模型自由迭代；服务器会检测真实循环并以恢复指导中止它们。
4. 内置成本防护 – 实时消耗率监控、按任务成本细分、硬性会话上限，以及用于 CI 流水线的 --max-cost 标志。
5. 带验证的上下文压缩 – 当对话超过模型的上下文窗口时，客户端会自动总结丢失的部分，验证摘要，并精确告知模型遗忘了什么。
6. 可重现的基准测试 – 仓库附带一个基准测试工具（bun run bench），可针对 Claude Code、Cursor、opencode 等重现已发布的成本和速度数据。

主要功能

• 丰富的终端 UI – 语法高亮 Markdown、即时 Token/成本计数器、鼠标可拖动代码块、14 种配色主题、Vim 模式，以及显示路由分析的侧边栏。
• 斜线命令 – /tier, /model, /why, /cost, /context, /compact, /diff, /review, /commit, /undo, /checkpoint, /rollback, /skill, /plugin, /mcp 等。
• 工具集 – 读/写文件、应用补丁、glob/grep、执行 Shell 命令（权限控制）、网页获取/搜索、项目图查询、语义搜索、影响范围分析、浏览器自动化，以及为范围内工作生成子代理的委派系统。
• Git 集成 – AI 生成的 diff、审查、提交消息，以及轻松的撤销/回滚。
• 可扩展性 – 自定义工具（JavaScript 插件）、可重用的提示模板（技能）、生命周期钩子和全项目规则文件。
• 权限与安全 – 三层权限模型、沙盒写入、危险命令拒绝列表，以及自动检测失控循环。

安装 – 可作为全局 npm 包、单行脚本、Homebrew 公式或 Windows PowerShell 安装程序使用。安装的二进制文件无需 Node/Bun 运行环境即可运行；CLI 本身是一个编译后的二进制文件，与一个小型辅助工具（klaatai）一起发布。

典型工作流程

klaatcode login               # 开启浏览器，登录您的 KlaatAI 账户
klaatcode                     # 在当前仓库中启动交互式会话
# 示例请求
> fix all TypeScript errors
# 代理：
#   • 读取项目图
#   • 执行 TypeScript 编译器
#   • 编辑文件
#   • 再次执行 linter
#   • 返回 diff 和摘要

对于 CI，您可以执行无头模式：

klaatcode run "apply eslint fixes" --max-cost 0.10

如果运行超过预算，它会以特定的代码退出，以便您的流水线可以安全地失败。

基准测试（2026 年 7 月） – 在 33 个任务套件中，代理以每个任务平均 $0.027（约 52K Token）的成本和 23 秒的中位数延迟解决了 33/33 个任务。这比 Claude Code 便宜约 5.4 倍，比最接近的竞争对手便宜约 1.7 倍，同时保持了完美的解决率。

适用场景 – 需要生活在终端中的 AI 结对程序员、需要细粒度成本控制，以及在 Token 预算重要的代码库（例如大型 Monorepo、CI 流水线）中工作的开发人员。它也服务于希望保持路由智能专有，同时将客户端开源的团队。

文档与支持 – 完整参考请见 https://klaatai.com/docs、即时 Discord 社区，以及公开的基准测试仪表板。