Claude Code、Codex CLI、Gemini CLI 横向对比：2026 年 10 月版

blackappleD
7 阅读10分钟

想在终端里用 AI 写代码，绕不开 Claude Code、Codex CLI 和 Gemini CLI。但网上不少对比文章已经过时了：今年 6 月 18 日起，Gemini CLI 不再给个人免费账号和 Google AI Pro / Ultra 账号提供服务，Google 让个人用户迁到新的 Antigravity CLI（命令是 agy）。照着半年前的文章选型，第一步就会卡住。

下面按 2026 年 10 月 16 日能查到的官方文档，把三家的门槛、配置、权限模型和适用场景放在一起比。Google 这一栏实际上是 Gemini CLI 和 Antigravity CLI 两个工具。命令都来自官方文档，没有逐条实测的地方会单独注明。

一、先看结论

你的情况优先考虑
已经订阅 Claude Pro / Max，项目复杂，需要长时间自主跑任务Claude Code
已经订阅 ChatGPT Plus 及以上，或者要在 CI 里跑、想用开源客户端Codex CLI
不想付费，先体验终端 AgentAntigravity CLI（免费账号有每周额度）
公司有 Gemini Code Assist 企业版，或手里有付费 Gemini API KeyGemini CLI 仍然可用
团队里几种工具混用项目规则写进 AGENTS.md，三家都能读

二、基本信息

项目Claude CodeCodex CLIGemini CLI / Antigravity CLI
厂商AnthropicOpenAIGoogle
命令claudecodexgemini / agy
版本（10 月 16 日查询）2.1.301（npm）0.163.0（10 月 15 日发布）Gemini CLI 0.64.0（10 月 13 日）；agy 文档标注 v1.2+
开源否是，Apache-2.0Gemini CLI 是 Apache-2.0；Antigravity CLI 据媒体报道闭源
个人订阅门槛Pro 起（按月付 20 美元），免费版不含 Claude Code定价页把 CLI 列在 Plus（20 美元/月）权益里agy 免费账号也有每周额度
按量付费ANTHROPIC_API_KEYcodex login --with-api-keyGemini CLI 用 API Key
模型别名 opus / sonnet / haiku，在 Anthropic API 上对应 Opus 5.5、Sonnet 5.5、Haiku 5.5官方示例界面显示 gpt-6.1-solagy 免费账号用 Gemini 3.8 Flash，Pro / Ultra 可用 Gemini 4 Argon
项目规则文件CLAUDE.md，没有时读 AGENTS.mdAGENTS.mdGEMINI.md 和 AGENTS.md

补充几点：

  • Claude 价格来自 claude.com/pricing：Pro 按月付 20 美元，按年付折合 17 美元/月；Max 从 100 美元/月起。官方 FAQ 原话是「Claude Code is included in all paid plans」。
  • Codex 定价页上，Free（0 美元）和 Go（8 美元）写的是「在桌面 App 里用 GPT-6 Luna，逐步开放」，CLI、IDE 插件和云端功能写在 Plus 里。另外 GPT-5.5 已在 10 月 14 日从「用 ChatGPT 登录的 Codex」下线，API Key 登录不受影响。
  • Google AI Pro / Ultra 的价格本文没有核实，以 Google 官网为准。

三、安装和登录

三家现在都推荐用官方安装脚本：

# Claude Code（macOS / Linux / WSL）
curl -fsSL https://claude.ai/install.sh | bash
claude --version

# Codex CLI（macOS / Linux，安装和升级是同一条命令）
curl -fsSL https://chatgpt.com/codex/install.sh | sh
codex

# Antigravity CLI（macOS / Linux，默认装到 ~/.local/bin/agy）
curl -fsSL https://antigravity.google/cli/install.sh | bash
agy --version

Windows PowerShell：

# Claude Code
irm https://claude.ai/install.ps1 | iex

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

Codex 在 Windows、npm、Homebrew 下的安装命令放在官方文档的标签页里，本文没有逐个核对。

登录方式：

工具订阅登录API Key
Claude Code首次运行 claude，走浏览器登录设置 ANTHROPIC_API_KEY，启动时确认使用就跳过登录
Codex CLIcodex login，选 Sign in with ChatGPTprintenv OPENAI_API_KEY | codex login --with-api-key
Antigravity CLI首次运行 agy，用 Google 账号登录Plans 页写明暂不支持自带 Key（BYOK）
Gemini CLI个人免费 / Pro / Ultra 账号已停用付费 API Key、Code Assist 企业许可证仍可用

最后一行容易被误读。Google 在 Gemini CLI 仓库的公告里写的是：从 2026 年 6 月 18 日起，Gemini CLI「will stop serving requests for Google AI Pro, Google AI Ultra, and free tier individual accounts」，企业版和 API Key 用户「remain completely unaffected」。Gemini CLI 本身还在更新（10 月 13 日刚发了 0.64.0），停掉的只是个人订阅登录。

四、项目规则文件：AGENTS.md 成了公约数

工具读什么注意
Claude Code./CLAUDE.md 或 ./.claude/CLAUDE.md没有 CLAUDE.md 时直接读 AGENTS.md（需 v2.1.277 及以上）；两者都有时默认只读 CLAUDE.md
Codex CLI全局 ~/.codex/AGENTS.md，项目里从 Git 根目录一路读到当前目录每层可以用 AGENTS.override.md 覆盖；合并后默认上限 32 KiB（project_doc_max_bytes）
Antigravity CLI工作目录的 GEMINI.md 和 AGENTS.md，全局规则在 ~/.gemini/GEMINI.md和 Gemini CLI 写法兼容

几种工具混用时，可以这样放：

<!-- CLAUDE.md：公共规则从 AGENTS.md 导入，这里只放 Claude 专用的 -->
@AGENTS.md

## Claude Code 专用
- 改完代码先跑 `npm test`

Claude Code 的 CLAUDE.md 支持用 @路径 导入其他文件。这样 AGENTS.md 只维护一份，Codex 和 agy 直接读，Claude Code 通过导入读。

五、权限和沙箱

终端 Agent 会改文件、跑命令，出了事损失多大，要看权限模型。这一项三家差别不小。

Claude Code：权限模式，沙箱另开

官方文档列了 6 种权限模式，用 Shift+Tab 切换，或启动时用 --permission-mode 指定：

模式不用确认就能做的事适合
default（界面上叫 Manual）只有读取敏感项目，每步都看
acceptEdits读取、改文件、mkdir / mv / cp 等常见文件命令边改边审
plan读取（支持 auto 时还有分类器放行的命令）先摸清代码再动手
auto全部，由另一个模型（分类器）在后台做安全检查长任务，少弹确认
dontAsk只放行预先允许的工具，其余一律拒绝CI 和脚本
bypassPermissions全部只在隔离的容器或虚拟机里用

文档写明，v2.1.283 及以上，auto 是终端和 VS Code 交互会话的默认起始模式。习惯每步确认的话要手动切回：

claude --permission-mode default

Bash 沙箱要另外开，运行 /sandbox 打开设置面板。macOS 用系统自带的 Seatbelt，Linux 和 WSL2 依赖 bubblewrap 和 socat；原生 Windows 上命令不进沙箱。

Codex CLI：沙箱模式 × 审批策略

Codex 把权限拆成两层：沙箱管技术上能做什么，审批策略管什么时候问你。

# 默认的 Auto 预设：工作区内可读写、可执行，越界或联网时询问
codex --sandbox workspace-write --ask-for-approval on-request

# 只读浏览代码
codex --sandbox read-only --ask-for-approval on-request

# CI 里只读、不提问
codex exec --sandbox read-only --ask-for-approval never

对应的 ~/.codex/config.toml：

approval_policy = "on-request"
sandbox_mode    = "workspace-write"

[sandbox_workspace_write]
network_access = false

容易踩的点：

  • workspace-write 默认不联网，要联网得显式设 network_access = true。
  • 工作区里的 .git、.codex、.agents 目录默认只读，防止 Agent 改坏版本库和自己的配置。
  • 旧值 approval_policy = "untrusted" 已经不支持，留在配置里可能导致 Codex 启动不了。升级后起不来，先查这一项。
  • --dangerously-bypass-approvals-and-sandbox（别名 --yolo）同时关掉沙箱和审批，官方标为不推荐。

Antigravity CLI：执行模式 + 工具权限预设

agy 也用 Shift+Tab 切换执行模式，顺序是 default → accept-edits → plan。default 模式写文件前会给出 diff，按 y / n / f 接受、拒绝或全屏查看。

Shell 命令由 settings.json 里的 toolPermission 控制，可选 request-review、proceed-in-sandbox、always-proceed、strict；终端沙箱用 enableTerminalSandbox 开关：

{
  "toolPermission": "request-review",
  "enableTerminalSandbox": true
}

这段按 agy 的 CLI 参考文档整理，本文未实测。

放在一起看

维度Claude CodeCodex CLIAntigravity CLI
默认起始状态auto（分类器审查）工作区可写、不联网、越界要批准default（写文件前确认）
沙箱/sandbox 手动开，原生 Windows 不支持默认开启，系统级enableTerminalSandbox
最宽松的开关bypassPermissions--yoloalways-proceed

我的看法是，Codex 的默认值最保守：开箱就有系统级沙箱，默认断网，适合不想研究配置的人。Claude Code 默认让另一个模型替你审，用起来更顺，但分类器不等于沙箱，碰生产环境的项目最好把 /sandbox 也打开。

六、MCP 和扩展能力

三家都支持 MCP，配置位置不同：

# Claude Code：远程 HTTP 服务
claude mcp add --transport http <名字> <服务地址>

# Codex CLI：本地 stdio 服务
codex mcp add context7 -- npx -y @upstash/context7-mcp
codex mcp list

Codex 的 MCP 写在 config.toml 的 [mcp_servers.<名字>] 表里。Antigravity CLI 把 MCP 从 settings.json 挪到了独立文件：全局 ~/.gemini/config/mcp_config.json，项目 .agents/mcp_config.json；远程服务的 url / httpUrl 字段要改名为 serverUrl。Gemini CLI 的扩展可以用 agy plugin import gemini 转换。

能力Claude CodeCodex CLIAntigravity CLI
子 Agent有有有（/agents 切换后台子 Agent）
Skills有有有（项目级在 .agents/skills/）
Hooks有CLI 文档页未列出CLI 文档页未列出
非交互模式claude -pcodex execagy -p，支持 --output-format json
定时任务/loop、Routines、桌面端定时任务Automations（App 端）/schedule

「文档页未列出」只是我在对应页面没找到，不代表一定没有。

七、从 Gemini CLI 迁到 Antigravity CLI

以前用个人账号跑 Gemini CLI 的，现在多半已经用不了。迁移要点：

  1. 装好 agy 后首次运行，它会检测本地的 Gemini CLI 配置，弹出清单让你选要迁移的扩展和全局配置，登录令牌会移进系统钥匙串。
  2. GEMINI.md 不用改。
  3. 项目级 Skills 要手动挪：从 .gemini/skills/ 移到 .agents/skills/，否则不会出现在斜杠命令里。全局的在 ~/.gemini/antigravity-cli/skills/。
  4. MCP 配置换文件，见上一节。
  5. 聊天记录不迁移。GitHub 讨论区有用户反馈会话上下文丢了，旧会话在 ~/.gemini/tmp/<project_hash>/chats/ 下。

还要注意：Antigravity 的模型表里，Claude Sonnet 4.6、Opus 4.6 和 GPT-OSS-120b 标注「将于 2026 年 11 月 2 日移除」。免费账号能用的非 Gemini 模型就是这几个，冲着它们来的要有心理准备。

八、我的判断

  1. 没有哪个工具全面领先。 网上流传的 Terminal-Bench、SWE-bench 对比分数，大多对应几个月前的模型版本，而且同一个模型换个 harness，分数就能差出一截，不适合当唯一依据。拿自己的项目跑两三个真实任务，比看榜单可靠。
  2. 订阅决定起点。 已经在付 Claude 或 ChatGPT 的钱，就用对应的 CLI，边际成本最低。项目规则都能落到 AGENTS.md，以后换工具的成本不高。
  3. 「Gemini CLI 免费」已经不成立。 个人免费额度现在在 Antigravity CLI 上，按周刷新，还受容量影响，Plans 页也写了不支持自带 Key。想长期稳定用，还是要付费。
  4. 开源客户端只剩 Codex CLI 和 Gemini CLI。 需要审计客户端代码或自己改造的，个人用户最容易上手的是 Codex CLI。

九、常见问题

问题原因和处理
Gemini CLI 登录后请求失败个人免费 / Pro / Ultra 账号自 6 月 18 日起停止服务，改用 agy，或换付费 API Key
Codex 升级后起不来检查配置里有没有 approval_policy = "untrusted"，删掉或改成 on-request
Codex 里装依赖失败workspace-write 默认断网，打开 network_access 或批准单次越界
Codex 里选不到 GPT-5.510 月 14 日已从 ChatGPT 登录的 Codex 下线，API Key 登录不受影响
Claude Code 没读 AGENTS.md同时有 CLAUDE.md 时默认只读后者，在 CLAUDE.md 里写 @AGENTS.md 导入
Claude Code 不再每步弹确认v2.1.283 起默认是 auto，用 --permission-mode default 或 Shift+Tab 切回
agy 里的 Skill 不见了项目级 Skill 要从 .gemini/skills/ 挪到 .agents/skills/

参考资料

avatar
文章
阅读
粉丝