cuckoo-code

项目概述

Cuckoo Code 是一个零 Token 成本的 AI Agent 桌面端。它通过 Electron 把 AI 网页版（DeepSeek、Claude、ChatGPT 等）嵌入本地窗口并注入侧边覆盖层，用系统提示词引导 AI 生成工具调用代码块，经你确认后在本地沙箱中执行，再把结果回传给 AI。整个过程不需要 API Key，也不产生按 Token 计费的调用费用，用的是网页版账号。它不只是聊天，AI 可以读写文件、搜索代码、执行命令、查询数据库与调用 MCP 工具，并依据执行结果继续下一步，形成完整的 Agent 循环。

把网页版 AI 变成能读写项目、执行命令的本地 Agent，且不花一分 API 费用。

主要功能

• 零 Token 成本：不调用 AI 平台 API，直接复用网页版聊天能力
• 多平台 Provider：内置 DeepSeek、Claude、ChatGPT 三个平台，并支持导入自定义 Provider
• 真正的 Agent 循环：AI 可读写文件、搜索代码、执行命令、查询数据库与调用 MCP 工具，并依结果继续下一步
• 多窗口管理：每个窗口拥有独立 Profile 上下文，可勾选默认在启动时自动打开
• 项目初始化：选择项目目录后，AI 获得目录树与系统提示词，操作基于真实项目上下文
• Skill 支持：项目级与用户级技能目录，初始化时注入名称、描述与路径，按需读取全文
• Agent 支持：主对话可把任务委派给独立上下文的子代理，只回摘要
• Rules 支持：规则可绑定文件路径，只在 AI 读到相关文件时注入
• 工具调用系统：支持读写文件、查找、替换、执行命令、抓取网页与查询数据库等工具
• MCP 支持：采用 Claude Desktop 兼容格式，支持 stdio 与 http 类型的 server
• 覆盖层面板：显示命令预览、执行结果与历史记录，可快速切换
• 会话与压缩：长会话自动压缩，登录状态与设置持久化保存
• 自动重试：回复被截断时按退避重试，并通过看门狗催促静默的流
• 安全机制：命令与沙箱超时、输出缓冲上限与危险命令确认

适用人群

• 想用网页版 AI 操作本地项目的开发者
• 希望避免 API 计费的用户
• 需要 Skill、Agent 与 Rules 等机制扩展 AI 能力的进阶用户

快速上手

1. 从 Releases 下载最新版本安装包，或按源码方式自行运行
2. 启动应用，选择平台（DeepSeek、Claude 或自定义 Provider）
3. 正常登录对应平台的网页版账号
4. 点击「初始化项目」选择项目目录，AI 会获得目录树与系统提示词
5. 与 AI 对话，让它帮你修改文件、运行命令或查询代码
6. AI 回复中的工具调用会被自动检测，经确认后在沙箱执行，结果自动回传并继续下一步

核心优势

• 不花 API 费用：复用网页版账号能力，只有网页版本身的限额，没有按 Token 计费的接口开销
• 可真正动手：从聊天升级为可读写文件、执行命令的 Agent，能完成实际开发任务
• 机制对齐：Skill、Agent 与 Rules 与 Claude Code 的目录约定一致，迁移成本低
• 上下文可控：子代理隔离上下文，长会话自动压缩，缓解超长对话带来的卡顿

系统要求

项目	要求
操作系统	Windows、macOS
运行环境	Node.js 16.0.0 及以上（建议 18+）与 npm，源码运行时需要
账号	需要可用的 AI 平台网页版账号

注意事项

• 应用不自带 AI 能力，使用前需自行登录对应平台的网页版账号
• 工具执行在你的本地项目目录中进行，请谨慎确认每一次工具调用
• 危险命令会要求确认，但请勿在重要目录中放任 AI 执行破坏性操作
• 安装依赖时若 electron 与 esbuild 的 postinstall 被拦截，需先批准再重新安装
• 本项目为第三方工具，与所接入的各 AI 平台官方无关联