安装编程智能体 — CLI、桌面应用或 VS Code 扩展

一名学生拿着一个发光的技能卡带，卡带的线插进六个不同的终端机器人，六个机器人都以同样的方式亮起来

先认识几个词

工具、智能体和 Harness 是什么？

像或这样的只有一个，但从不同角度看，它有三个名字：、和。先弄懂这三个词，这一页的其余内容就很好读了。

Claude CodeCodexHermes Agent 同一个程序，三个名字

工具(Tool)

看作人使用的东西时

工具就是拿来用的东西。Claude Code 和 Codex 是让人使用电脑和的工具。这类工具也叫智能体编程工具(agentic coding tool)。

You → Tool → Computer + AI
智能体(Agent)

看作模型加 Harness 时

智能体是能自己一步步把事情做完的 AI。广义上说，智能体就是和 Harness 合在一起—— 把它写成 "Agent = Model + Harness"。所以当模型在 Claude Code 里，两者合起来就是一个智能体。

Agent = Model + Harness
Harness

看作模型以外的一切时

广义上说，Harness 是 AI 模型以外的一切：任何把模型包起来、让它去干活的 AI 工具。Harness 负责读文件、执行命令、请求许可，并把结果交还给模型。所以 Claude Code、Codex 和都是 Harness。

Harness = Agent − Model

如今工具也被叫作 Harness 或智能体

起初人们只把这些程序叫作工具。现在，说到包在模型外面的那部分时叫 Harness，说到连同模型一起干活的整体时叫智能体。三个名字都对，指的是同一个程序。

详细了解 Agent = Model + Harness

本页的六个工具

核心思想

智能体 = 模型 + Harness

LangChain 用一句话这样说：

Agent = Model + Harness. If you're not the model, you're the harness.

LangChain — The Anatomy of an Agent Harness (新窗口)

所有不属于模型的、设置和，都属于 Harness。模型本身只会预测文字。Harness 把它变成能读文件、运行命令、在工作完成时停下来的智能体。

智能体

你在终端里对话的对象

模型

负责思考 — 读完收到的所有内容，预测接下来的文字或一次

Harness

其余的一切 — 组织输入、运行工具、让循环继续下去

加载 AGENTS.md
工具 — 文件、、网页、
和批准
沙箱
循环
和压缩
会话和记忆

一个发光的大脑球，加上一个装满工具的机器人框架 — 笔记本、扳手、屏幕、盾牌、锁和循环箭头 — 等于一个胸口装着那颗球、正在用笔记本电脑工作的小机器人

六个 Harness，许多模型

Claude Code、Codex、、、和 agy 都是 Harness。它们各自包裹不同的模型 — Claude、、、Grok、Kimi，OpenCode 则几乎可以用任何模型 — 但每个 Harness 做的事都一样。所以本页的习惯可以从一个工具带到下一个工具。

Harness — 三种视角

从提示词到报告

一步一步看智能体循环

跟着一个真实的请求走一遍 — “修好点了没反应的注册按钮，并加一个测试”。模型和 Harness 轮流工作，直到工作被确认完成。

谁来做你 — 提出请求并批准模型 — 思考并决定 Harness — 组织输入、运行工具、检查权限

智能体循环

你 你的提示词 你输入的请求
Harness 组织输入 指令、工具、AGENTS.md、历史记录
模型 模型推理 用工具调用或文字回答
Harness 运行工具 权限检查、沙箱、批准
Harness 加入结果 带着新的输出回到模型
模型 最终报告 没有工具调用的文字结束这一轮

箭头按顺序走。粗箭头就是循环 — 每个工具结果都会回到模型。虚线箭头只在模型只用文字回答、没有工具调用时才走。

1
第 1 步 · 你

提示词到达

你输入请求并按 Enter。Harness 把你的话包装成一条用户消息 — 放在输入的最后。
产出
```
{"type": "message", "role": "user",
 "content": [{"type": "input_text",
   "text": "Fix the signup button that does nothing and add a test"}]}
```
2
第 2 步 · Harness

Harness 组织输入

在模型看到你的话之前，Harness 先收集需要的东西 — 它自己的指令、模型可以的工具列表、关于沙箱和何时请求批准的说明、你的 AGENTS.md 文件，以及工作文件夹和 Shell。之后的每一轮，到目前为止的整段对话也会放进去。
产出
```
instructions  base instructions for the model
tools         shell · update_plan · web_search · mcp__…
input
  developer   <permissions instructions> sandbox · approval
  user        AGENTS.md  (project root → cwd)
  user        <environment_context> cwd · shell
  user        "Fix the signup button …"
```
3
第 3 步 · 模型

模型思考

Harness 把输入发给模型。模型只会用两种方式之一回答 — 给你的一条消息，或者一次工具调用，也就是一个小小的请求，比如“运行这条 Shell 命令”。模型自己无法碰你的电脑。
产出
```
{"type": "function_call", "name": "shell",
 "arguments": "{\"command\":\"rg -n signup src\"}",
 "call_id": "call_1"}
```
4
第 4 步 · 模型 Harness

收集上下文

要修按钮，模型得先找到它，所以它会请求读取类的工具 — 用 rg 搜索代码、列出文件夹、读取文件。Claude Code 把这个阶段叫作 “gather ”(收集上下文)。
产出
```
$ rg -n signup src
src/components/SignupButton.jsx:8:  <button type="button">Sign up</button>
src/api/auth.js:21:export async function signup(email, password) {
```
5
第 5 步 · Harness

Harness 运行工具

Harness 检查权限。允许，而且在沙箱里？那就运行。还没有允许？那就先问你。然后它把这次调用和输出加进对话，再去问模型。这一来一回就是循环，一个请求可能要转几十圈。
产出
```
{"type": "function_call_output",
 "call_id": "call_1",
 "output": "src/components/SignupButton.jsx:8: …"}
```
6
第 6 步 · 模型 Harness

修改文件

理解代码之后，模型会请求编辑 — 用新文字替换文件的一部分。Harness 写入修改，你会以的形式看到。Claude Code 在每次编辑前都会保存检查点，方便你。
产出
```
--- a/src/components/SignupButton.jsx
+++ b/src/components/SignupButton.jsx
-  <button type="button">Sign up</button>
+  <button type="button" onClick={() => signup(email, password)}>
+    Sign up
+  </button>
```
7
第 7 步 · 模型 Harness

运行命令

接下来，模型请求在 Shell 里运行测试或构建。会改动文件夹以外东西的命令，正是批准和沙箱起作用的地方。
产出
```
$ npm test -- SignupButton
```
8
第 8 步 · 模型

验证

模型读取测试日志。如果测试失败，它就回到读代码和编辑(第 4 步和第 6 步)，再跑一次测试 — 直到测试通过，或者它卡住了，停下来问你。
产出
```
FAIL  SignupButton.test.jsx
  ✕ calls signup when clicked
… fix → run again …
PASS  SignupButton.test.jsx
  ✓ calls signup when clicked
```
9
第 9 步 · 模型 Harness

最终报告

当模型只用文字回答、没有工具调用时，这一轮就结束了。Harness 显示总结，把控制权交还给你。好的报告会说明改了什么、测试结果，以及没有检查的地方。
产出
```
{"type": "message", "role": "assistant",
 "content": [{"type": "output_text",
   "text": "Connected the button to signup() and added SignupButton.test.jsx. npm test passes."}]}
```

对话每一轮都在变长

每一轮都会加入工具调用和它的结果，然后把整个列表重新发送一次。 — 模型一次最多能读的量 — 会慢慢被填满。

新的调用和结果指令、工具和 AGENTS.md 第 1 轮
新的调用和结果之前的调用和结果指令、工具和 AGENTS.md 第 2 轮
新的调用和结果之前的调用和结果之前的调用和结果指令、工具和 AGENTS.md 第 3 轮
总结指令、工具和 AGENTS.md 压缩之后

指令、工具和 AGENTS.md
之前的调用和结果
新的调用和结果
总结

在“工具上下文”标签页了解更多 — 什么占满了上下文，以及如何压缩

提示词缓存

在 Codex 中，旧的输入正好是新输入的开头部分(前缀)，所以可以重用之前的计算。在对话中途更换工具、模型、沙箱、批准模式或工作文件夹，会破坏这个前缀，让下一个请求变慢。
压缩

对话太长时，Harness 会用一段更短的总结替换它，然后继续。Codex 超过上限后会自动压缩。Claude Code 也会自动压缩，你还可以带着重点运行 /compact。对话早期的规则可能会丢失 — 长期要遵守的规则请放在 AGENTS.md 里。
批准和沙箱归 Harness 管

模型只负责请求。命令是运行、等你批准，还是被拦下，由 Harness 决定。在 Codex 中，沙箱只管它自己的 Shell 工具 — MCP 工具必须自己守住限制。

Codex 和 Claude Code — 同样的循环，不同的细节

Codex 和 Claude Code 如何描述这个循环
主题	Codex	Claude Code
名称	智能体循环(agent loop) — 和工具调用不断重复，直到一条助手消息结束这一轮。来源 (新窗口)	循环(agentic loop) — 收集上下文、采取行动、验证结果，这几个阶段会相互交融。来源 (新窗口)
对话	每个请求都会重新发送全部历史，所以每个请求都是独立的。来源 (新窗口)	每条消息、每次工具使用和结果都保存在 ~/.claude/projects 下的文件里，所以可以继续或分叉。来源 (新窗口)
压缩	超过 auto_compact_limit 后，通过一个专门的压缩自动进行。来源 (新窗口)	接近上限时自动进行。带着重点运行 /compact，可以留下你需要的内容。来源 (新窗口)
安全	把沙箱和批准规则告诉模型，并在 Shell 工具上强制执行。来源 (新窗口)	权限模式(Shift+Tab)，加上可以撤销文件编辑的检查点。来源 (新窗口)

Codex 的细节来自 OpenAI 的文章，Claude Code 的细节来自 Anthropic 的文档。其他工具运行同样的循环，但没有公开同样详细的说明。

比较

每个工具支持什么

每一格都链接到我们核对的地方 — 官方页面，或者 2026-10-26 时该工具自己的输出。

图例支持不支持支持，名称不同未确认

六个编程智能体 CLI 的共同功能
功能	Claude Code	Codex CLI	OpenCode	Grok Build	Kimi Code	Antigravity CLI
读取 AGENTS.md	支持，名称不同 `CLAUDE.md` 只有没有 CLAUDE.md 时才读 AGENTS.md，或者在 CLAUDE.md 里加上 @AGENTS.md	支持 `AGENTS.md`	支持 `AGENTS.md`	支持 `AGENTS.md`	支持 `AGENTS.md`	支持 `AGENTS.md` 也读取 GEMINI.md
/goal — 长期目标	支持 `/goal`	支持 `/goal`	不支持没有内置 — 已有功能请求在讨论中	支持 `/goal`	支持 `/goal`	支持 `/goal`
斜杠命令	支持 `/help`	支持 `/help`	支持 `/help`	支持 `/help`	支持 `/help`	支持 `/help`
计划模式	支持 `/plan`	支持 `/plan`	支持，名称不同 `Plan agent` 用 Tab 切换	支持 `/plan`	支持 `/plan`	支持 `/plan`
批准模式	支持 `--permission-mode` 核对命令 claude --help	支持 `/permissions`	支持 `permission`	支持 `--permission-mode` 核对命令 grok --help	支持 `--yolo · --auto` 核对命令 kimi --help	支持 `--mode` 核对命令 agy --help
继续会话	支持 `claude -c` 核对命令 claude --help	支持 `codex resume` 核对命令 codex --help	支持 `opencode -c` 核对命令 opencode --help	支持 `grok -c` 核对命令 grok --help	支持 `kimi -c` 核对命令 kimi --help	支持 `agy -c` 核对命令 agy --help
不用聊天直接运行(headless)	支持 `claude -p` 核对命令 claude --help	支持 `codex exec` 核对命令 codex --help	支持 `opencode run` 核对命令 opencode --help	支持 `grok -p` 核对命令 grok --help	支持 `kimi -p` 核对命令 kimi --help	支持 `agy -p` 核对命令 agy --help
MCP	支持 `claude mcp` 核对命令 claude --help	支持 `codex mcp` 核对命令 codex --help	支持 `opencode mcp` 核对命令 opencode --help	支持 `grok mcp` 核对命令 grok --help	支持 `/mcp`	支持 `agy mcp` 核对命令 agy --help
技能(SKILL.md)	支持 `.claude/skills`	支持 `.agents/skills`	支持 `.agents/skills`	支持 `.grok/skills`	支持 `.agents/skills`	支持 `.agents/skills`
子智能体	支持 `.claude/agents`	支持 `.codex/agents`	支持 `.opencode/agents`	支持 `.grok/agents`	支持 `.kimi-code/agents`	支持 `.agents/agents`
切换模型	支持 `/model`	支持 `/model`	支持，名称不同 `/models`	支持 `/model`	支持 `/model`	支持 `/model`
压缩上下文	支持 `/compact`	支持 `/compact`	支持 `/compact`	支持 `/compact`	支持 `/compact`	支持 `/compact` 核对命令 agy changelog
用 /init 生成指令文件	支持，名称不同 `/init → CLAUDE.md`	支持 `/init → AGENTS.md`	支持 `/init → AGENTS.md`	未确认	支持 `/init → AGENTS.md`	未确认

命令经常变化。“未确认”表示我们在官方页面或 --help 里没有找到，并不代表没有这个功能。

一个文件，所有工具

AGENTS.md — 每个请求都需要的规则

AGENTS.md 是项目里的一个普通文件。智能体会在你说第一句话之前先读它，所以你不必一遍遍重复规则。

里面写什么

如何运行项目
如何测试 — 以及测试必须通过
代码风格
不能碰的东西
如何报告

一个简短的例子

# AGENTS.md

## 运行
- 先 npm install，再 npm run dev

## 测试
- 完成前运行 npm test。所有测试都必须通过。

## 风格
- React 函数组件，缩进 2 个空格。

## 不要碰
- .env、数据库文件夹和 package-lock.json

## 报告
- 列出改动的文件、测试结果，以及你没有检查的地方。

每个工具在哪里读取

Claude Code
它自己的文件是 CLAUDE.md。只有当所在文件夹及上层文件夹都没有 CLAUDE.md 时，才会读 AGENTS.md。想两个都用，就在 CLAUDE.md 里写上 @AGENTS.md。
来源 (新窗口)
Codex CLI
从一直到当前文件夹，按顺序拼接，离得越近的文件越优先。文件是 ~/.codex/AGENTS.md。默认上限 32 。
来源 (新窗口)
OpenCode
项目里的 AGENTS.md 和 ~/.config/opencode/AGENTS.md。没有 AGENTS.md 时，会改读 CLAUDE.md。
来源 (新窗口)
Grok Build
从根到你工作的文件夹，每一层文件夹里的 AGENTS.md(以及 CLAUDE.md)。越深的文件越优先。
来源 (新窗口)
Kimi Code
项目里的 AGENTS.md 或 .kimi-code/AGENTS.md，再加上对所有项目生效的 ~/.kimi-code/AGENTS.md。
来源 (新窗口)
Antigravity CLI
任何文件夹里的 AGENTS.md 和 GEMINI.md，以及 .agents/rules。全局规则放在 ~/.gemini。找到的所有规则会合并在一起。
来源 (新窗口)

CLAUDE.md 和 AGENTS.md 一起用

长时间的工作

/goal — 一直做到完成

一个小机器人沿着长长的石阶向顶端的旗子攀登，经过一块块打了对勾的石头，旁边有一个时钟和一块满电的电池

普通请求在模型不再调用工具的那一刻就结束了。则设定一条终点线 — 智能体会一轮接一轮地继续工作，直到条件满足。

/goal 所有测试都通过，并且注册按钮会调用 signup()。不要改动数据库。

写一个可以检验的目标

让它可以测试 — 写“tests/signup 里的所有测试都通过”，而不是“让它更好”。
设定一个上限，比如预算或时间，并在开始前先提交(commit)。
时不时看一眼。长期目标也可能慢慢跑偏。

支持Claude Code
设定一个完成条件。Claude 会一直工作，直到条件满足、判断无法完成，或因错误停下。也可以和 -p 一起用。
来源 (新窗口)
支持Codex CLI
在较大的任务运行期间，Codex 持续跟踪的目标(goals 功能，默认开启)。
来源 (新窗口)
不支持OpenCode
目前还没有内置的 /goal — 可以改用自定义命令。
来源 (新窗口)
支持Grok Build
带一个目标和可选 --budget 的 /goal，另外还有 status、pause、resume 和 clear。
来源 (新窗口)
支持Kimi Code
启动一个自主目标，还有 status、pause、resume、cancel 等。
来源 (新窗口)
支持Antigravity CLI
当智能体想停下时，会拦住它，要它检查自己的工作并继续。
来源 (新窗口)

AI 课程 — 目标和循环

提示词工程

用 5W1H 写请求

中间是一张对话气泡卡片，连着六个圆形徽章 — 一个人、一个盒子、一个时钟、一个地图图钉、一个灯泡和一把扳手

大多数糟糕的结果，都来自漏掉了智能体猜不到的信息的请求。六个问题 — 谁、什么、何时、何地、为什么、怎么做 — 能补上其中大多数漏洞。

不好的提示词

“按钮坏了。修一下。”

哪个按钮？怎么坏的？怎么知道修好了？智能体只能去猜，还可能改错文件。

好的提示词 — 5W1H

谁想在我们首页注册的新访客。
什么点“注册”按钮没有任何反应。让它调用 signup()，并加一个测试。
何时从昨天那次以后，每次点击都这样。
何地首页的 src/components/SignupButton.jsx。不要碰文件。
为什么大家注册不了，我们正在流失新会员。
怎么做找出点击没反应的原因，用最小的改动修好，运行 test，然后告诉我你改了什么。

5W1H 不能保证结果一定好，但能覆盖大多数情况。如果智能体还要问你问题，缺的那一块通常就是这六个之一。

AI 课程 — 提示词工程

一起用更好

AGENTS.md + 5W1H 提示词

把工作分开。AGENTS.md 放每个请求都需要的内容，只放这一次请求需要的内容。

AGENTS.md — 每一次

如何测试、代码风格、不能碰的东西、如何报告

提示词 — 只有这一次

这一个请求的谁、什么、何时、何地、为什么和怎么做

智能体两个都会读

提示词变短

不用再在每条消息里写“跑一下测试，别碰数据库”。
每个工具都是同样的规则

从 Claude Code 换到 Codex 或 Kimi，规则也会跟着过去。
和团队共享

这个文件放在里，所以每个人、每个智能体都遵守同样的规则。
只改一次

智能体重复犯同一个错时，不用再解释一遍，在 AGENTS.md 里加一行就好。

速查表

通用命令

同样的操作几乎在每个工具里都管用。例外写在比较表里。

在项目文件夹里启动
cd my-project claude · codex · opencode · grok · kimi · agy
生成指令文件
/init Claude Code 会写 CLAUDE.md。Grok 和 agy 未确认。
编辑前先做计划
/plan OpenCode — 按 Tab 切换到 Plan 智能体。
切换模型
/model OpenCode — /models。
腾出上下文
/compact
设定长期目标
/goal OpenCode 没有。
继续上一次会话
claude -c · opencode -c · grok -c · kimi -c · agy -c codex resume --last
不用聊天运行一次
claude -p · grok -p · kimi -p · agy -p codex exec · opencode run
管理 MCP 服务器
claude mcp · codex mcp · opencode mcp · grok mcp · agy mcp Kimi — 在聊天里用 /mcp。

在 SONUB 学更多

官方来源

于 2026-10-26 对照官方文档和已安装的 CLI(--help)核对。命令会变化，请同时阅读官方文档。

各工具的文档

最常用的三种形式

应该安装哪种形式？

同一个可以用多种形式使用。本页介绍其中最常用的三种：终端里的、桌面应用和 VS Code 扩展。形式并不只有这三种：根据工具不同，还可以在 JetBrains 等其他编辑器、网页浏览器、手机应用、Slack 或 GitHub 中使用，也可以通过放进自己的程序。先选一个适合你的形式，按下面共同的四个步骤安装，然后只需替换每个工具不同的命令、下载地址或扩展 ID。

一名学生面前有三条路，分别通向终端窗口、笔记本电脑上的桌面应用和代码编辑器的侧边面板，三个画面都用线连到上方同一个发光的 AI 球

CLI

适合什么时候选
你习惯用，或需要用脚本重复做同样的事

主要优点
浏览、修改文件、运行命令，还能用非交互运行（claude -p · ）实现

例子
在终端里排查失败的测试，或在中运行代码仓库检查

查看 CLI 安装
桌面应用

适合什么时候选
你想在一个可视化的工作区里管理多个项目或持续进行的任务

主要优点
整理对话、直观查看结果，并同时安排多项工作

例子
把一个功能交给独立的去做，同时你去看另一个项目

查看桌面应用安装
VS Code 扩展

适合什么时候选
你大部分时间都在里

主要优点
把打开的文件和选中的代码直接放进对话，并在源代码旁边查看改动

例子
选中一个函数，让解释它、修复或添加测试

查看 VS Code 扩展安装

选择指南参考了 OpenAI Codex 文档中的对比 — CLI (新窗口) · 桌面应用 (新窗口) · VS Code 扩展 (新窗口)

形式 1

安装为 CLI

CLI 是在终端里用命令来操作的形式。一行安装命令就够了，每个工具都走同样的四个步骤。只选适合你电脑的那一行即可。

打开终端 — 和用“终端”，用 PowerShell。
从下面复制适合你电脑的那行安装命令，粘贴后按 Enter。如果你已经在用 Homebrew 或，也可以用那一行。
打开一个新终端，运行下面卡片里的“检查”命令，看看是否显示号。
进入你的项目文件夹（cd），输入卡片里的“启动”命令。第一次会打开，让你登录或粘贴。

Claude Code

macOS · Linux

curl -fsSL https://claude.ai/install.sh | bash

Windows (PowerShell)

irm https://claude.ai/install.ps1 | iex

用 Homebrew · npm 安装

Homebrew

brew install --cask claude-code

npm

npm install -g @anthropic-ai/claude-code

检查
claude --version

启动
claude

官方安装指南 (新窗口)
Codex CLI

macOS · Linux

curl -fsSL https://chatgpt.com/codex/install.sh | sh

Windows (PowerShell)

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

用 Homebrew · npm 安装

Homebrew

brew install --cask codex

npm

npm install -g @openai/codex

检查
codex --version

启动
codex

官方安装指南 (新窗口)
OpenCode

macOS · Linux

curl -fsSL https://opencode.ai/v2/install | bash

用 Homebrew · npm 安装

Homebrew

brew install anomalyco/tap/opencode-v2

npm

npm install -g @opencode/cli

检查
opencode --version

启动
opencode

官方安装指南 (新窗口)
Grok Build

macOS · Linux

curl -fsSL https://x.ai/cli/install.sh | bash

Windows (PowerShell)

irm https://x.ai/cli/install.ps1 | iex

检查
grok --version

启动
grok

官方安装指南 (新窗口)
Kimi Code

macOS · Linux

curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash

Windows (PowerShell)

irm https://code.kimi.com/kimi-code/install.ps1 | iex

用 Homebrew · npm 安装

npm

npm install -g @moonshot-ai/kimi-code

检查
kimi --version

启动
kimi

官方安装指南 (新窗口)
Antigravity CLI

macOS · Linux

curl -fsSL https://antigravity.google/cli/install.sh | bash

Windows (PowerShell)

irm https://antigravity.google/cli/install.ps1 | iex

检查
agy --version

启动
agy

官方安装指南 (新窗口)

… | bash 和 irm … | iex 会直接在你的电脑上运行来自互联网的脚本。只使用这里列出的官方地址，不要运行在别处看到的相似命令。

形式 2

安装为桌面应用

桌面应用是用窗口和按钮来操作的形式。不用终端就能下载安装，并在屏幕上整理多项任务。并不是每个工具都有官方桌面应用。

从官方网站下载适合你（macOS、Windows 或 Linux）的应用并安装。
打开应用，用该公司的账号登录。
打开你要处理的项目文件夹，也可以新建一个项目。
写下任务交给它，然后在屏幕上查看对话、结果和改动的文件。你也可以同时运行多项任务。

Claude Code

Claude Desktop — Code

在的 Code 标签页中使用。不需要另外安装 CLI，但需要付费方案。
下载 (新窗口) 官方安装指南 (新窗口)
Codex

Codex app

提供 macOS（Apple Silicon）和 Windows（Microsoft Store）版本。如果你装了 CLI，也可以用 codex app 打开。
下载 (新窗口) 官方安装指南 (新窗口)
OpenCode

OpenCode Desktop
下载 (新窗口) 官方安装指南 (新窗口)
Grok Build

没有找到官方桌面应用。
安装为 CLI
Kimi Code

没有找到官方桌面应用。
安装为 CLI
Antigravity

Google Antigravity

本身就是一个代码编辑器（）— 可在 macOS 12 及以上、Windows 10 和 11 以及 Linux 上运行。
下载 (新窗口) 官方安装指南 (新窗口)

形式 3

安装为 VS Code 扩展

VS Code 扩展会在代码编辑器里加一个智能体面板。从扩展市场安装后，就能直接询问你选中的代码。

在 VS Code 中打开扩展视图 — +Shift+X（macOS 上是 Cmd+Shift+X）。
搜索下面的扩展名称或，点击 [Install]。也可以在终端里用 code --install-extension 安装。
点击侧边栏或编辑器顶部新出现的图标，打开智能体面板并登录。
选中代码，请它解释、修复或写测试，在源代码旁边检查改动后再接受。

Claude Code

Claude Code for VS Code

扩展 ID anthropic.claude-code

code --install-extension anthropic.claude-code

在 VS Code Marketplace 中查看 (新窗口) 官方安装指南 (新窗口)
Codex

Codex – OpenAI’s coding agent

扩展 ID openai.chatgpt

code --install-extension openai.chatgpt

在 VS Code Marketplace 中查看 (新窗口) 官方安装指南 (新窗口)
OpenCode

opencode

扩展 ID sst-dev.opencode

code --install-extension sst-dev.opencode

在 VS Code Marketplace 中查看 (新窗口) 官方安装指南 (新窗口)
Grok Build

没有找到官方 VS Code 扩展。
安装为 CLI
Kimi Code

Kimi Code

扩展 ID moonshot-ai.kimi-code

code --install-extension moonshot-ai.kimi-code

在 VS Code Marketplace 中查看 (新窗口) 官方安装指南 (新窗口)
Antigravity

Google Antigravity

扩展 ID Google.google-antigravity

code --install-extension Google.google-antigravity

在 VS Code Marketplace 中查看 (新窗口) 官方安装指南 (新窗口)

如果终端提示找不到 code 命令，请在 VS Code 命令面板（Ctrl+Shift+P · Cmd+Shift+P）中运行 "Shell Command: Install 'code' command in PATH"。

每种形式都是同一个智能体

CLI、桌面应用和 VS Code 扩展只是外观不同 — 里面是同一个智能体在跑同一个循环。所以“工具的共同点”标签页教的大部分内容 — AGENTS.md、批准、和 5W1H — 都可以直接沿用。命令和地址已于 2026-10-26 对照官方文档核实；如有变化，请以官方指南为准。

查看工具的共同点

Claude Code + Codex

六个好习惯 — 按工作的顺序

这六个习惯在两份官方指南里都出现了。每张卡片都会说明在和中怎么做。

第 1 步 · 用四个部分提需求

说清目标、背景(文件、文档、完整的 — 用 @ 附加文件)、限制和完成标准。指出一个可以照着做的现有写法。调查的范围要窄，别让智能体去读几百个文件。

Claude Code
@file · cat error.log | claude -p "…"

Codex CLI
@file
第 2 步 · 难的活先做计划

遇到涉及很多文件、或你不熟悉的工作，先切换到计划模式：先阅读、做计划、调整计划，再动手做。大的功能可以让智能体先来采访你，再写成规格说明。如果一句话就能说清这次改动，就不用做计划。

Claude Code
Shift+Tab · claude --permission-mode plan

Codex CLI
/plan · Shift+Tab
第 3 步 · 让它自己检查结果

给它一个能判断通过与否的东西 — 测试、构建、用来比对的 — 并要它拿出证据。在宣布工作完成之前，找一个全新的审查者来读这次的差异。

Claude Code
/code-review

Codex CLI
/review
第 4 步 · 长期规则写进文件

你反复说的规则，写进 AGENTS.md 或 CLAUDE.md — 要简短，并带上构建和测试命令。只是偶尔需要的知识做成技能，外部信息通过获取，必须执行的步骤做成钩子。

Claude Code
CLAUDE.md · .claude/skills · claude mcp add

Codex CLI
AGENTS.md · .agents/skills · codex mcp add
第 5 步 · 保持上下文干净

一件工作用一个对话，不相关的任务之间先清空，太长的对话就。如果改了两次还不对，就用更好的需求重新开始 — 干净的新会话，比塞满失败尝试的长会话更好。

Claude Code
/clear · /compact · /btw · /rewind

Codex CLI
/new · /compact · /fork
第 6 步 · 扩大使用并并行工作

不用聊天界面，从脚本和里运行它；每个并行任务用自己的；它做你自己的事，不必盯着每一步。定时任务要等手动运行稳定之后再设置。

Claude Code
claude -p · git worktree

Codex CLI
codex exec · git worktree

四部分的需求 — 两个工具都适用

Goal: Remove an item from the cart when its quantity becomes 0.
Context: @src/cart.ts @tests/cart.test.ts — the total is NaN today.
Constraints: Keep the public API. No new packages.
Done when: a new test covers quantity 0 and the tests pass.
Show me the test output as evidence.

目标 · 背景 · 限制 · 完成标准，再加上你想看到的证据。把文件和目标换成你自己的。

常见错误

十个常见错误 — 以及改正每一个的习惯

Claude Code 指南列出了五种失败模式，Codex 指南列出了八种。按意思合并后是十个。标签显示每一条来自哪份官方清单。

把不相关的任务混在一个对话里，或在一个聊天里做完整个项目 — 上下文会被杂音塞满。

Claude CodeCodex CLI

改法: 每个明确的成果用一个对话；不相关的任务之间，先清空或新开一个。
习惯 5 — 保持上下文干净
一遍又一遍地纠正同一件事 — 上下文会被失败的尝试塞满。

Claude Code

改法: 改了两次还不对，就带着学到的经验，用更好的第一个需求重新开始。
习惯 5 — 保持上下文干净
把长期规则塞进每一次需求里，或让规则文件长到重要的规则被淹没。

Claude CodeCodex CLI

改法: 把长期规则移到 AGENTS.md 或 CLAUDE.md 并保持简短；智能体已经做对的内容就删掉，或改成钩子。
习惯 4 — 长期规则写进文件
相信自己无法检查的结果 — 没给构建或测试命令，看起来对，却漏掉了特殊情况。

Claude CodeCodex CLI

改法: 一定要给出检查的办法(测试、脚本、截图)，并写下构建和测试命令。无法检查的东西，就不要发布。
习惯 3 — 让它自己检查结果
不设范围就让它“调查一下” — 它会读几百个文件，把上下文塞满。

Claude Code

改法: 在需求里缩小范围，或把调查交给子智能体。
习惯 1 — 用四个部分提需求
在复杂、多步骤的工作上跳过计划。

Codex CLI

改法: 用计划模式开始，在改任何代码之前先敲定计划。
习惯 2 — 难的活先做计划
在还没弄懂程之前，就给智能体电脑的完全访问。

Codex CLI

改法: 先用默认权限，只在需要时才放宽。
习惯 4 — 长期规则写进文件
同时在相同的文件上运行好几个任务。

Codex CLI

改法: 每个并行任务用自己的 Git worktree。
习惯 6 — 扩大使用并并行工作
手动运行还不稳定，就先设置定时任务。

Codex CLI

改法: 先手动运行到稳定，再设为定时。
习惯 6 — 扩大使用并并行工作
一步一步盯着智能体，而不是并行工作。

Codex CLI

改法: 给出明确的终点后把活交出去，期间做你自己的事。
习惯 6 — 扩大使用并并行工作

来源

已于 2026-10-26 对照官方文档核对。推荐的模型是 SONUB 在2026年11月的选择；模型经常变化，所以也请查看模型页面。

上下文与用量

上下文越小，用量撑得越久

每次请求都会把整段对话再发给模型一遍，所以越大，套餐额度用得越快。这个标签页讲怎么查看用量、额度何时恢复、什么会占满上下文，以及如何在约 400k 而不是 1M 时。命令和设置已于 2026-10-26 在官方文档中核对。

坐在书桌前的学生和发光的AI光球；中间是一个高玻璃杯，杯底铺着薄薄一层彩色方块，聊天纸张越堆越高，已经碰到远低于杯口的一条发光紫线；右侧是一台把纸压成一张小总结卡的压机、一个带刷新箭头的时钟和一块充得很满的电池

用量与重置还剩多少，何时恢复
什么会占满上下文基础上下文 + 不断变长的对话
压缩自动与手动
约 400k，而不是 1M每个工具的设置

第 1 步

查看当前用量和重置时间

订阅不是一条一条数消息，而是给你一份按时间窗口恢复的用量额度。在做长任务之前就看数字，不要等撞到上限才看。

Claude Code

查看方法/usage/context

/usage 显示套餐用量条，以及过去一天或一周里是什么用掉的(技能、、服务器)；/context 显示当前上下文有多满。

恢复周期每 5 小时每周

有滚动的 5 小时窗口和每周窗口。撞到上限时，提示里会显示重置时间，例如“resets 3:45pm”。
来源 (新窗口)
Codex CLI

查看方法/status/usage weekly

/status 显示模型、本次会话的 token 用量和剩余额度；/usage daily 或 /usage weekly 显示 token 使用情况。用量面板(chatgpt.com/codex/settings/usage)会显示重置时间。

恢复周期每 5 小时每周

Plus 和 Business 有 5 小时窗口(Pro 目前没有)，也可能再加上每周额度。
来源 (新窗口)
OpenCode

查看方法opencode stats --days 7 --models

opencode stats 按天和按模型显示 token 与费用。

恢复周期每 5 小时每周每月

OpenCode Go 把每月额度拆开：5 小时内最多 20%，一周内 50%，一个月内 100%。
来源 (新窗口)
Grok Build

查看方法/usage/context

/usage 显示积分用量，/context 显示上下文用了多少。

恢复周期官方文档没有说明

官方文档没有说明额度何时重置。
来源 (新窗口)
Kimi Code

查看方法/usage

/usage 显示 token 用量、上下文有多满和你的配额。

恢复周期每 5 小时每周每月

用量 API 会返回 5 小时、7 天和每月三个窗口，各自带有重置时间。
来源 (新窗口)
Antigravity CLI

查看方法/usage/context

/usage(或 /quota)显示每个模型剩余的请求数和 token；/context 显示什么占满了上下文。

恢复周期每 5 小时每周

Google AI Pro 每五小时恢复一次，直到触及每周额度；没有 Pro 或 Ultra 时，配额每周恢复。
来源 (新窗口)

免费继续用下去的办法

在为额外用量付费之前，先用好已经免费的东西。

Codex — 打开 /usage，如果有挣到的重置次数，就兑换它。不用买积分就能重置速率限制。
/usage
Claude Code — 额度用完导致任务停下时，让会话保持打开。重置后它会自己等待并继续任务(默认开启；用 /rate-limit-options 或 autoContinueAtUsageLimit 设置来选择)。
/rate-limit-options · autoContinueAtUsageLimit

第 2 步

基础上下文，以及随着聊天变长的上下文

上下文分两部分。基础上下文在你输入任何内容之前就已加载，并跟着每次请求一起发送。对话叠在它上面，每次请求、每读一个文件、每条命令输出都会让它变长。

新的调用和结果指令、工具和 AGENTS.md 第 1 轮
新的调用和结果之前的调用和结果指令、工具和 AGENTS.md 第 2 轮
新的调用和结果之前的调用和结果之前的调用和结果指令、工具和 AGENTS.md 第 3 轮
总结指令、工具和 AGENTS.md 压缩之后

指令、工具和 AGENTS.md
之前的调用和结果
新的调用和结果
总结

只表示形状 — 基础部分不变，对话在上面越堆越高。每次请求都会把整堆一起发出去。

基础上下文 — 你还没开口就已经在了

系统提示词
内置工具
MCP 工具
技能描述
CLAUDE.md · AGENTS.md · 记忆

按 SONUB 标准，保持在 6% 以下。提任何请求之前，先打开新对话，看 /context(、agy)或 /status()。

对话 — 每次请求都会变长

你的请求和回答
智能体读过的文件
命令和测试输出

每个回答、读的每个文件、每条命令输出都会加进来。在压缩或清除对话之前，什么都不会离开。

基础上下文超过 6%？关掉不用的 MCP 服务器，删掉不用的技能和插件，CLAUDE.md 和 AGENTS.md 里只留每次请求都需要的规则。

第 3 步

自动压缩和手动压缩

压缩会用一份总结替换较早的对话，让会话能继续下去。细节会丢失，而且生成总结的这次请求本身也要读完整段对话。

自动

上下文达到某个阈值时，工具会自己压缩。这个阈值由第 4 步的设置决定。
手动

在合适的停顿点压缩，并说明要保留什么，例如：/compact Focus on the failing test and the files we changed.
重新开始

下一个任务和之前无关时，改为打开新对话(、/new)。不花钱，还会丢掉所有旧内容。

工具	手动压缩	重新开始	自动 — 设置	默认情况
Claude Code	`/compact`	`/clear`	`autoCompactEnabled · autoCompactWindow`	默认开启。使用 1M 模型时，如果不设置窗口，会在约 967K 时压缩。
Codex CLI	`/compact`	`/new`	`model_auto_compact_token_limit`	在 model_auto_compact_token_limit 处压缩；没设置时，按模型默认值压缩。
OpenCode	`opencode api post /api/session/<id>/compact`	—	`compaction.auto · compaction.buffer`	默认开启。保留上限的 15%(至少 16k)作为空闲空间，并在总结旁保留最近约 15,000 个 token。
Grok Build	`/compact`	—	`auto_compact_threshold_percent`	默认在上下文窗口用到 85% 时压缩。
Kimi Code	`/compact`	—	`loop_control.reserved_context_size`	空闲空间低于 loop_control.reserved_context_size 时压缩。
Antigravity CLI	文档中没有	—	文档中没有	自己把较早的轮次压缩成检查点总结；文档里没有对应的命令或设置。

第 4 步

用约 400k，而不是 1M

现在的模型可以装下 1M token，但不必装满。如果工具在约 400k 时压缩，每次请求带的内容更少，同一个套餐就能用得更久。

1M 窗口(Claude Code)

基础上下文 ≤ 6%
SONUB：444k 时压缩
默认：约 967K
1M

为什么能省用量

两份官方文档都把用量和上下文大小联系在一起。Claude Code：token 成本随上下文大小增长，而且每次请求都会发送整段对话。Codex：装着更多上下文的长会话，每条消息用得明显更多。接近 900K 的请求，带的内容大约是接近 450K 的请求的两倍。用订阅时，有人说这样大约能多用一倍的 AI — 这是常见的反馈，不是官方数字。

Claude Code

~/.claude/settings.json

{
  "autoCompactWindow": 444000
}

对所有模型，上下文达到 444,000 token 时压缩(允许范围 100k–1M)。用 /autocompact 为某个模型保存的窗口优先 — 在新对话里用 /context 查看。

同样的作用: /autocompact 444k · claude --autocompact 444k
查看: /context

Codex CLI

~/.codex/config.toml

model_context_window = 500000
model_auto_compact_token_limit = 475000

model_context_window 告诉 Codex 窗口是 500,000 token，model_auto_compact_token_limit 在 475,000(窗口的 95%)时压缩。在新对话里用 /status 查看。

查看: /status

其他工具

OpenCode

compaction.buffer 是在模型上限之下保留的空闲空间 — 用 1M 模型时，设为 600000 就会在约 400k 开始压缩。
opencode.jsonc
```
{
  "compaction": { "buffer": 600000 }
}
```
Grok Build

auto_compact_threshold_percent 是窗口用到多少百分比时开始压缩 — 在 1M 窗口上，40 约等于 400k。
~/.grok/config.toml
```
[session]
auto_compact_threshold_percent = 40
```
Kimi Code

默认窗口是 256K(KIMI_MODEL_MAX_CONTEXT_SIZE 262144)，已经小于 400k — 不用改。
Antigravity CLI

文档里没有窗口或压缩点的设置 — 它会自己压缩。

约 400k 和 6% 是 SONUB 的标准，不是官方推荐 — 官方文档只说明了各项设置。

来源

命令、设置和默认值已于 2026-10-26 在以下官方文档中核对。

工具、智能体和 Harness 是什么？

工具(Tool)

智能体(Agent)

Harness

如今工具也被叫作 Harness 或智能体

本页的六个工具

智能体 = 模型 + Harness

智能体

模型

Harness

六个 Harness，许多模型

一步一步看智能体循环

提示词到达

Harness 组织输入

模型思考

收集上下文

Harness 运行工具

修改文件

运行命令

验证

最终报告

对话每一轮都在变长

提示词缓存

压缩

批准和沙箱归 Harness 管

Codex 和 Claude Code — 同样的循环，不同的细节

每个工具支持什么

AGENTS.md — 每个请求都需要的规则

里面写什么

每个工具在哪里读取

/goal — 一直做到完成

写一个可以检验的目标

用 5W1H 写请求

不好的提示词

好的提示词 — 5W1H

AGENTS.md + 5W1H 提示词

AGENTS.md — 每一次

提示词 — 只有这一次

提示词变短

每个工具都是同样的规则

和团队共享

只改一次

通用命令

在项目文件夹里启动

生成指令文件

编辑前先做计划

切换模型

腾出上下文

设定长期目标

继续上一次会话

不用聊天运行一次

管理 MCP 服务器

在 SONUB 学更多

官方来源

各工具的文档

应该安装哪种形式？

CLI

桌面应用

VS Code 扩展

安装为 CLI

Claude Code

Codex CLI

OpenCode

Grok Build

Kimi Code

Antigravity CLI

安装为桌面应用

Claude Code

Codex

OpenCode

Grok Build

Kimi Code

Antigravity

安装为 VS Code 扩展

Claude Code

Codex

OpenCode

Grok Build

Kimi Code

Antigravity