iCode Agent · 终端

不会烧光你的上下文窗口的编码智能体。

iCode Agent 直接在你的仓库中工作:它阅读代码、做出修改、运行测试并验证自己的工作——而你在终端中观看并引导它。长任务是最难的情况,上下文是它要守住的预算。

npm install -g @icodehq/icode-agent
cd ~/my-project
icode-agent

Node.js 22+ · Apache-2.0 · 一个包支持 Windows、macOS 和 Linux

icode-agent — example session

一段示意会话,展示探索 → 修改 → 验证的循环。亲自走一遍你的第一个任务 →

持久的上下文

运行长任务正是编码智能体掉链子的地方:窗口里塞满旧的文件读取和命令输出,智能体开始忘记自己做过什么,而且每次请求都更贵。iCode Agent 把上下文当作要守住的预算,而不是随意灌满的桶。

  • 从源头设限——过大的输出在产生时就被限制上限,并溢出到文件,只保留一段简短预览。
  • 在请求时缩减——只有当请求会超出预算时,较早的结果才会变成紧凑的标记,从最旧的开始。
  • 持久总结——当历史确实溢出时,较早的轮次会被总结,并保留最近的尾部。

被收起的结果仍保留一条回到完整输出的路径,失败证据绝不会被隐藏,缩减也绝不会改写你保存的会话。

你可以做什么

工作流

修复失败的测试

运行测试套件,读取失败信息,修复代码,并证明它已通过。

阅读指南 →
工作流

重构模块

梳理调用方,然后通过经过审核的 diff 进行聚焦重构。

阅读指南 →
自动化

在 CI 中自动化

使用 -p 以无头模式运行,使用 --mode json 流式输出事件。

阅读指南 →

自带模型

iCode Agent 使用 openai 和 anthropic 协议,因此可搭配官方 API 和任何兼容端点。智能体在本地运行;你的代码只会发送到你配置的模型端点。

免费且开源(Apache-2.0)。你只需向模型提供商付费。

与 iCode Workbench 如何配合。

Workbench(Pre-1.0)是面向智能体团队的桌面环境——Claude Code、Codex 和 OpenCode 在隔离的工作树中运行,并配有任务、审核和 Mira。Agent 是专注的终端界面:一个仓库、一个会话、没有窗口。它们是各自独立的产品,遵循同样的原则,也可以单独使用。

探索 iCode Workbench →

iCode Agent · 守住线索,约束成本。