iCode Agent · 常见问题
问题,逐一解答。
如何安装 iCode Agent?
安装 Node.js 22 或更高版本,然后运行 npm install -g @icodehq/icode-agent。参见快速开始。
iCode Workbench 和 iCode Agent 有什么区别?
iCode Workbench(Pre-1.0)是桌面 ADE:它并行运行 Claude Code、Codex 和 OpenCode,各自拥有独立的 Git 工作树,并带有跨项目的任务、审核和 Mira。iCode Agent 是本常见问题中介绍的专注终端智能体。它们是独立的产品,各自都可以单独使用。
使用 Agent 需要 Workbench 吗?
不需要。iCode Agent 是独立的 CLI——用 npm 安装后即可在任何仓库中运行。Workbench 目前不会包装或启动 iCode Agent。
我可以使用哪些模型?
iCode Agent 使用 openai 和 anthropic 协议,因此可搭配官方 API 和任何兼容端点。使用 /model 配置一个模型。
我需要 Bun 吗?
不需要。Bun 是开发 iCode Agent 本身所用的运行时。发布的包运行在 Node.js 22 或更高版本上。
哪些平台已经过验证?
Windows、macOS 和 Linux 的跨平台兼容性已经实现。自动化验证在 Linux 上执行;Windows 和 macOS 原生验证仍待完成。
iCode Agent 会上传我的代码吗?
它在本地运行,只使用你提供的 API 密钥与你配置的模型端点通信。你的源代码会作为所运行任务的上下文发送到该端点;提供商自己的数据政策适用。
运行成本是多少?
iCode Agent 本身免费且开源(Apache-2.0)。你只需为使用的 token 向模型提供商付费——而 iCode Agent 的构建目标就是在长任务中压低这个数字。
iCode Agent 如何控制 token 用量?
上下文在每个边界都受到管理:输出在产生时就被设限,较早的工具结果只在请求会超出预算时才被缩减,溢出的历史会被总结并保留最近的尾部。参见上下文是如何管理的。
缩减上下文会丢失信息吗?
被收起的结果会被替换为一个标记,指明完整输出仍然所在的位置,因此智能体可以把它读回来。失败证据和错误绝不会被收起,缩减只会改变发送的请求——保存的会话保留每一个结果。
我的工作保存在哪里?
会话会自动保存在配置目录(~/.icode-agent/)下。使用 --continue 恢复最近一个会话,使用 --resume <id> 恢复指定会话,或使用 /session 管理会话。
它能与哪些智能体或编辑器配合?
iCode Agent 是独立的终端智能体——你直接使用它,而不是通过另一个智能体。它的配置和会话只由 CLI 和 TUI 读取。
它适合生产环境使用吗?
iCode Agent 处于早期实验开发阶段,变化很快。每个版本包含的内容请参见更新日志。