klaatcode
KlaatAI/klaatcode加载项目详情…
本应用为开源项目，仅供学习研究，请遵守其开源协议。
微信扫码咨询客服
POMOAI — 让开源 AI 即刻运行
加载项目详情…
本应用为开源项目，仅供学习研究，请遵守其开源协议。
如果你曾在深夜的服务器上独自调试一个报错，突然希望身边有个经验丰富的工程师能即时指点——但你又不想离开终端去打开浏览器问 AI——那么 Klaat Code 可能是你一直在寻找的那个"人"。
2024 年，Anthropic 推出 Claude Code，让开发者第一次在命令行里感受到了"有记忆、会读代码、能直接改文件"的沉浸式 AI 编程体验。这款工具迅速走红，但也带来了一个核心问题：Claude Code 只绑定了 Claude 一个模型，而不同任务对模型能力的需求差异巨大。简单文件重命名用 GPT-4o mini 足够了，复杂架构设计则需要 Claude Opus，调试性能瓶颈可能 DeepSeek R1 更有性价比。
KlaatAI 团队正是看到了这一痛点，于 2025 年推出了 Klaat Code——一个开源的终端原生 AI 编程 Agent，核心创新是智能模型路由（Smart Model Routing）。它不是简单地在多个模型里挑一个，而是根据任务复杂度自动分类，分配到最合适的模型层级，在保持 Claude Code 级别准确度的同时，官方声称成本降低 10 倍。
项目发布后迅速在 GitHub 积累 356 颗星，Fork 数达 137 次，在开源 AI Coding Agent 细分领域形成了与 OpenCode、Claude Code 的三足鼎立态势。
Klaat Code 的核心差异化在于六层路由体系（Six-Tier Routing）：
| 路由层级 | 适用场景 | 典型模型 |
|---|---|---|
nano | trivial turns、代码补全 | GPT-4o mini、Qwen2.5-Coder |
fast | 快速问答、小改动 | GPT-4o mini、DeepSeek V3 |
code | 默认层 — 大部分编程工作 | GPT-4o、Claude Sonnet |
reason | 调试、架构设计、复杂逻辑 | Claude 3.7 Sonnet、o3-mini |
heavy | 大型重构、最高难度问题 | Claude 3.5/3.7 Opus、o1 |
titan | 前沿能力（Kimi K3 2.5T，选配） | Kimi K3 |
用户可以通过 /tier 命令锁定特定层级，或用 /why 命令查看上一次路由决策的理由，用 /cost 查看当前会话消费情况和路由节省的金额。
路由决策由 Klaatu（项目内部的路由引擎）自动完成，每次请求都会被分类到对应层级，界面右上角会显示当前响应的层级徽章，让用户对"谁在回答"一目了然。
项目采用 TypeScript + Bun 构建，代码组织高度模块化：
src/
├── main.tsx # CLI 入口，处理登录/登出/交互式 REPL
├── agent/ # 核心 Agent 引擎
│ ├── personas.ts # 子 Agent 人格定义（explore/read-only 等）
│ ├── system-prompt.ts # 分层系统提示词（静态前缀 + 环境块 + 项目规则）
│ ├── compaction.ts # 上下文压缩，控制 token 消耗
│ ├── verify.ts # 工具输出验证
│ ├── collapse-check.ts # 重复操作折叠
│ └── headless-agent.ts # 无头模式（CI/CD 场景）
├── engine/ # TUI 渲染引擎
│ ├── app.ts, terminal.ts, layout.ts, widgets/ # 终端 UI 框架
│ └── theme.ts # 主题系统（支持东京之夜等）
├── api/
│ └── client.ts # KlaatAI 后端通信客户端
├── mcp/ # Model Context Protocol 支持
│ ├── client.ts # MCP 客户端实现
│ ├── presets.ts # 预置 MCP 服务器（filesystem、github 等）
│ └── import.ts # MCP 配置导入
├── commands/ # CLI 命令（login/logout/whoami/completions）
├── auth/ # 认证体系（credentials、refresh、oauth）
└── tools/ # 工具集
├── apply-patch.ts # 代码补丁应用
├── edit-engine.ts # 编辑引擎
├── diagnostics.ts # 诊断工具
└── exploration-planner.ts # 探索规划器
Klaat Code 支持两种认证模式：
klaatcode login 打开浏览器，在 KlaatAI 网站完成 OAuth 授权，回调写入本地凭证，全程无需管理 API Key，适合个人用户凭证通过 ~/.klaatai/ 本地存储，klaatcode whoami 可实时查看认证状态。
项目内置了 Model Context Protocol（MCP） 支持，通过 /mcp enable <preset> 命令可一键启用预置服务器：
filesystem — 项目目录读写（通过 @modelcontextprotocol/server-filesystem）github — GitHub 仓库浏览、Issue/PR 管理everything — 全局文件搜索postgres — PostgreSQL 数据库连接puppeteer — 浏览器自动化这些 MCP 服务器通过 npx 按需启动，无需全局安装，体现了项目"零依赖前置"的设计哲学。
# 安装（npm/global）
npm install -g klaatai
# 启动（浏览器授权）
klaatcode
# 指定项目目录
klaatcode ~/projects/my-app
# 无头模式 / CI 场景
klaatcode run "Fix all TS errors"
# 查看认证状态
klaatcode whoami
项目基于自研的 TUI 引擎（src/engine/）构建了交互式终端界面，支持：
| 维度 | Claude Code | Klaat Code |
|---|---|---|
| 模型绑定 | 仅 Claude | 6+ 模型自动路由 |
| 成本控制 | 无差别使用强模型 | 简单任务用 mini 模型 |
| MCP 支持 | 无原生 MCP | 完整 MCP 协议集成 |
| 开源 | 闭源 | MIT 开源 |
| 自定义模型 | 不支持 | 支持接入任意第三方模型 |
尽管 Klaat Code 展现出了令人印象深刻的工程设计，但以下几点值得潜在使用者关注：
路由策略黑盒化：路由决策由项目自行实现，准确性高度依赖任务分类算法的质量。官方 benchmark 在 bench/ 目录中有自测报告，但缺乏第三方独立验证。
商业云依赖：默认使用 KlaatAI 云端网关进行路由，核心路由逻辑不开源。纯本地部署（不依赖 KlaatAI 服务）的可行性未在文档中明确说明。
TypeScript Only：项目完全基于 TypeScript + Bun，不支持 Python 等其他语言生态，对多语言项目团队来说有一定局限。
许可证存疑：README 标题写 MIT，但根目录 LICENSE 文件实际内容需核实。从 package.json 看 "license": "MIT"，但 GitHub API 返回 "License": "NOASSERTION"，存在不一致。
项目官方 Logo，终端原生 AI 编程 Agent 的代表性图标
Klaat Code 终端界面，展示了智能路由层级徽章和交互式 REPL
Klaat Code 的出现代表了 2025 年 AI Coding Agent 领域的一个主流趋势——从"单模型霸权"走向"智能路由经济"。随着 Claude Code、OpenCode（OpenAI）、Klaat Code 等产品的竞争加剧，模型路由层的优化将成为下一个技术军备竞赛焦点：
项目目前的 356 星和 137 Fork 规模说明市场已验证了"路由"这一价值主张，但能否在 Claude Code 和 OpenCode 的双重压力下持续增长，取决于 KlaatAI 团队能否在路由算法的透明度和本地化部署上给出更清晰的答案。
总结：如果你是一个注重成本控制、需要在终端里完成大部分编码工作的开发者，Klaat Code 值得尝试——它用"让对的模型做对的事"这一朴素理念，在 AI 编程工具的红海中找到了一个清晰的位置。