用途
Kolega Code 是一个运行在终端里的编程智能体（coding agent），定位为本地优先（local-first）。它面向需要在代码仓库中完成调查、修改、迁移、审查等任务的开发者。对于单个智能体循环难以覆盖的宽泛任务，它提供 Gigacode 引擎，让模型自行编写多智能体编排程序。
主要能力
Gigacode：模型自写的编排
针对仓库级审查、迁移或包含独立工作流的计划，模型不再逐个委派 worker，而是编写一个编排程序。该程序可以组合并行阶段、流水线、对抗式验证、评审小组（judge panels）和综合门（synthesis gates）来适配任务。运行时会把脚本保存到磁盘，便于检查和再次运行。
模型先调查仓库，然后针对一个小型运行时 API（agent、parallel、pipeline、phase、budget）编写 Python 程序。运行时负责强制并发上限、智能体数量兜底和 token 预算核算，并派发带类型的子智能体，包括只读调查者、编码者和浏览器智能体，其活动会流入 TUI 的子智能体检查器。
运行时会把每次完成的智能体调用记录到磁盘日志。恢复（resume）按内容键控而非位置键控：使用 resume_from_run_id 时，语义输入未变的调用会从日志零 token 成本重放。即使脚本被编辑或重排，或跨会话、跨进程重启，这一机制仍然有效。
Gigacode 默认关闭，可用 /gigacode on 启用。
常规终端编程智能体能力
- Plan/Build 模式：只读的 Plan 模式用于调查并生成可审查的任务列表，Build 模式用于实现（Shift+Tab 切换）。在 Plan 模式下，工作流子智能体也被强制为只读。
- 仓库工具：读取和搜索代码、创建文件、应用精确编辑、检查会话变更/差异。
- 终端执行：运行 shell 命令并流式输出，带项目级权限控制。
- 网页搜索与浏览：默认使用无需密钥的 DuckDuckGo；可配置 Firecrawl、Tavily、SearXNG；支持直接 URL 抓取；提供基于 Playwright 的浏览器智能体用于交互式网站。
- MCP 服务器：可连接 streamable_http、sse 和 stdio 类型的 MCP 服务器（包括支持 OAuth 的 HTTP 服务器），作为受权限门控的工具。
- 交互或脚本化：Textual TUI 支持排队后续指令；kolega-code ask 一次性调用并输出 JSON；支持会话列表/导出/恢复；提供 doctor 命令。
- 编辑器集成：通过 Agent Client Protocol 从 Zed 或 VS Code 驱动完整智能体，包括流式响应、工具卡片、差异、权限提示、plan/build 审批、会话恢复、斜杠命令和子智能体记录。
- 可扩展性：智能体技能、项目提示模板覆盖、生命周期钩子、持久化项目权限规则。
- 本地优先状态：会话、设置、权限、OAuth token 和 API key 设置保留在本机，并在适用时使用限制性权限。
使用方式
安装
使用脚本安装，或用 uv（或 pip）安装，然后验证安装。
启动与连接模型
在项目中启动会话，通过首次运行向导用 ChatGPT 登录或 API key 连接模型。之后可从侧边栏或 /settings 打开设置。用 Shift+Tab 在 Plan 和 Build 模式间切换，任务足够宽泛时运行 /gigacode on。
模型与路由
Kolega Code 可按角色路由模型：主循环可用强长上下文模型，工具调用可用更快的模型，扩展思考可用专用模型。规划、构建、调查、通用和浏览器智能体均支持按角色覆盖。Gigacode 工作流还可以用 model_override 为单次调用固定更便宜的模型，让一个模型编写编排、更便宜的模型运行其智能体。
支持的模型提供商包括：OpenAI（通过 ChatGPT 订阅登录）、Mistral AI（原生 API）、DashScope / Qwen、OpenRouter（可接入 250+ 支持工具的模型）、Moonshot / Kimi、Z.AI / GLM Coding Plan、Kimi Coding Plan。
使用付费 ChatGPT 计划（Plus、Pro 或 Business）时，/login chatgpt 可运行 OpenAI 模型而无需单独的 API key；token 本地存储（chmod 600）并自动刷新。
网页搜索后端包括 DuckDuckGo（默认，无需密钥）、Firecrawl、Tavily 和自托管 SearXNG，可在设置或通过 KOLEGA_CODE_WEB_SEARCH_BACKEND 选择。
环境要求
- 至少一个受支持模型提供商的 API key、ChatGPT 登录或本地模型
- 支持现代 TUI 的终端（大多数终端都支持）
适用场景
- 仓库级代码审查、迁移或包含独立工作流的计划
- 需要并行阶段、流水线、对抗式验证或评审小组的复杂任务
- 希望在终端内完成调查、编辑、运行命令和网页浏览的开发者
- 需要从 Zed 或 VS Code 驱动完整智能体的用户
- 希望本地保存会话、设置、权限和凭据的用户
限制
- Gigacode 默认关闭，需要手动启用。
- 运行时对并发、智能体数量和 token 预算有强制上限。
- 关于 Mistral：Medium 3.5、Small 4、Large 4 和 Ministral 3 支持图像输入，Codestral 仅文本；Medium/Small/Large 提供 none（默认）或 high 思考；token 计数是带安全余量的保守本地估算，并非精确的 Mistral tokenizer；目录中 32,768 token 的输出预留是 Kolega 的预算策略，并非经验证的原生最大输出上限；Kolega Code 运行本地函数工具循环，未启用 Mistral 托管的服务器工具；原生 Mistral key 和模型 ID 与网关凭据和路由相互独立。
- Large 4 的访问取决于账户/订阅，目录条目不保证可访问；别名（尤其是 latest）可能改变其目标和能力。
- 使用绝对二进制路径，因为裸 kolega-code 会解析为编辑器 PATH 上的版本，已安装的发行版可能遮蔽开发检出。
- 本地会话状态位于平台的状态目录下，除非设置了 KOLEGA_CODE_STATE_DIR。
- API key 变量只提供凭据，仍需显式选择提供商和模型或将其保存在设置中。
