[{"data":1,"prerenderedAt":1525},["ShallowReactive",2],{"header-counts":3,"footer-counts":6,"compare-codex-vs-gemini-cli":9,"compare-a-codex":10,"compare-b-gemini-cli":877},{"tools":4,"reviews":5},78,26,{"tools":4,"reviews":5,"playbooks":7,"news":8},22,21,null,{"id":11,"title":12,"alternatives":13,"api_compatible":17,"body":19,"category":779,"chinese_friendly":367,"cover":780,"description":781,"domestic":782,"extension":783,"faq":784,"free":782,"github":81,"languages":800,"lastVerified":9,"meta":803,"models":804,"navigation":370,"notSuitable":808,"opensource":370,"path":812,"pillar":813,"platforms":814,"priceTable":818,"pricing":834,"published":835,"relatedPlaybooks":836,"relatedReviews":839,"score":844,"self_host":782,"seo":845,"seoTitle":9,"slug":846,"sources":847,"stem":859,"suitable":860,"tagline":865,"tags":866,"updated":874,"verdict":875,"website":727,"__hash__":876},"tools\u002Ftools\u002Fcoding\u002Fcli\u002Fcodex.md","Codex CLI",[14,15,16],"coding\u002Fcli\u002Fclaude-code","coding\u002Fcli\u002Faider","coding\u002Fcli\u002Fcline",[18],"openai",{"type":20,"value":21,"toc":763},"minimark",[22,27,74,77,90,93,115,118,150,153,219,225,229,234,239,276,279,283,307,311,331,334,338,453,464,467,612,617,620,674,678,685,688,717,720,749,759],[23,24,26],"h2",{"id":25},"tldr","TL;DR",[28,29,34,46,71],"div",{"className":30},[31,32,33],"card","p-5","my-4",[35,36,37,41,42,45],"p",{},[38,39,40],"strong",{},"一句话："," Codex CLI 是 OpenAI 官方做的终端 Coding Agent，对标 Claude Code。",[38,43,44],{},"Rust 实现 + Windows 原生沙箱 + 子代理 + MCP + Hooks","，ChatGPT Plus\u002FPro\u002FTeam\u002FEdu 已含使用额度。",[35,47,48,51,52,55,56,61,62,65,66,70],{},[38,49,50],{},"2026-07 最新","：稳定版 ",[38,53,54],{},"0.144.1","（7-09）接入 ",[57,58,60],"a",{"href":59},"\u002Fmodels\u002Fgpt-5-6.html","GPT-5.6"," 家族（Sol\u002FTerra\u002FLuna）；新增 ",[38,63,64],{},"ACP 支持","，可在 ",[57,67,69],{"href":68},"\u002Fcoding\u002Fide\u002Fwindsurf.html","Devin Desktop"," \u002F Zed 等 ACP 客户端里作为 Agent provider 运行；此前已作为公测 Agent provider 进入 JetBrains（经 GitHub Copilot，7-07）。",[35,72,73],{},"形态和 Claude Code 几乎一样，差异主要在模型选择。喜欢 GPT 的人选它，喜欢 Claude 的留 Claude Code。",[23,75,76],{"id":76},"它到底是个什么",[35,78,79,85,86,89],{},[57,80,84],{"href":81,"rel":82},"https:\u002F\u002Fgithub.com\u002Fopenai\u002Fcodex",[83],"nofollow","GitHub: openai\u002Fcodex","，",[38,87,88],{},"Apache-2.0 开源","，Rust 写的二进制，428+ 贡献者。在终端里跑一个能读 \u002F 改 \u002F 执行代码的 Agent，类似 Claude Code 但绑定 OpenAI 模型。",[35,91,92],{},"2026 的三个主线：",[94,95,96,103,109],"ol",{},[97,98,99,102],"li",{},[38,100,101],{},"速度 & 实时","：gpt-5.3-codex-spark 推理速度 1000+ token\u002Fs；WebSocket 远程控制延迟优化。",[97,104,105,108],{},[38,106,107],{},"Agent 自主性","：Subagents GA、Smart Approvals、PostToolUse hooks、worktree 自动化。",[97,110,111,114],{},[38,112,113],{},"企业就绪","：自定义 CA 证书、userpromptsubmit hooks、托管配置、插件策略强制。",[35,116,117],{},"最有用的 4 个能力：",[119,120,121,127,133,139],"ul",{},[97,122,123,126],{},[38,124,125],{},"沙箱执行","：默认在受限沙箱跑命令（macOS Sandbox \u002F Linux Landlock \u002F Windows AppContainer），不会污染主机。",[97,128,129,132],{},[38,130,131],{},"MCP 工具调用","：连 GitHub \u002F 数据库 \u002F Slack \u002F 自建 server，支持并行 tool call。",[97,134,135,138],{},[38,136,137],{},"Subagents","：把大任务拆给多个并行 sub-agent，token 用得多但效率高。",[97,140,141,144,145,149],{},[38,142,143],{},"Image inputs","：终端里 ",[146,147,148],"code",{},"codex -i screenshot.png \"解释这个错误\""," 直接读图。",[23,151,152],{"id":152},"价格",[154,155,156,171],"table",{},[157,158,159],"thead",{},[160,161,162,166,168],"tr",{},[163,164,165],"th",{},"档位",[163,167,152],{},[163,169,170],{},"说明",[172,173,174,186,197,208],"tbody",{},[160,175,176,180,183],{},[177,178,179],"td",{},"ChatGPT Plus",[177,181,182],{},"$20\u002F月",[177,184,185],{},"含 Codex CLI 用量（2026-03 起 mini 模型额度 +4×）",[160,187,188,191,194],{},[177,189,190],{},"ChatGPT Pro",[177,192,193],{},"$200\u002F月",[177,195,196],{},"更高额度 + 优先处理 + Spark 研究预览",[160,198,199,202,205],{},[177,200,201],{},"Business \u002F Edu \u002F Team",[177,203,204],{},"$25-30\u002F用户\u002F月起",[177,206,207],{},"企业管理 + SSO + Codex 含在内",[160,209,210,213,216],{},[177,211,212],{},"纯 API",[177,214,215],{},"按 token",[177,217,218],{},"gpt-5.5 ≈ $1.25 \u002F $10 per 1M token",[220,221,222],"blockquote",{},[35,223,224],{},"已经付 ChatGPT Plus 的人，等于白嫖一个 Codex CLI 用量，几乎不必另开 API 账号。",[23,226,228],{"id":227},"真实任务实测基于官方文档归纳","真实任务实测（基于官方文档归纳）",[220,230,231],{},[35,232,233],{},"来源说明：以下基于 Codex CLI 官方 features 文档与公开评测整合。",[235,236,238],"h3",{"id":237},"任务-1在-50k-行-rust-项目里加新-feature","任务 1：在 50k 行 Rust 项目里加新 feature",[240,241,246],"pre",{"className":242,"code":243,"language":244,"meta":245,"style":245},"language-bash shiki shiki-themes github-light github-dark","codex -m gpt-5-codex\n> 在 src\u002Fauth 模块下加 OAuth2 callback handler，参考已有的 token refresh 实现\n","bash","",[146,247,248,265],{"__ignoreMap":245},[249,250,253,257,261],"span",{"class":251,"line":252},"line",1,[249,254,256],{"class":255},"sScJk","codex",[249,258,260],{"class":259},"sj4cs"," -m",[249,262,264],{"class":263},"sZZnC"," gpt-5-codex\n",[249,266,268,272],{"class":251,"line":267},2,[249,269,271],{"class":270},"szBVR",">",[249,273,275],{"class":274},"sVt8B"," 在 src\u002Fauth 模块下加 OAuth2 callback handler，参考已有的 token refresh 实现\n",[35,277,278],{},"Agent 会 plan → 读相关文件 → 跑 cargo check → 跑测试 → 提 diff。子代理可以同时跑 lint 和 test 两条线。",[235,280,282],{"id":281},"任务-2ci-失败自动-debug","任务 2：CI 失败自动 debug",[240,284,286],{"className":242,"code":285,"language":244,"meta":245,"style":245},"codex --features enable post_tool_use_hook\n# 然后跑 cargo test，CI 失败时 Hook 自动触发 Agent 分析失败 + 写 fix\n",[146,287,288,301],{"__ignoreMap":245},[249,289,290,292,295,298],{"class":251,"line":252},[249,291,256],{"class":255},[249,293,294],{"class":259}," --features",[249,296,297],{"class":263}," enable",[249,299,300],{"class":263}," post_tool_use_hook\n",[249,302,303],{"class":251,"line":267},[249,304,306],{"class":305},"sJ8bj","# 然后跑 cargo test，CI 失败时 Hook 自动触发 Agent 分析失败 + 写 fix\n",[235,308,310],{"id":309},"任务-3跨仓库脚手架生成","任务 3：跨仓库脚手架生成",[240,312,314],{"className":242,"code":313,"language":244,"meta":245,"style":245},"codex -m gpt-5-codex\n> 用 mono-repo 模式建 3 个 package：core \u002F cli \u002F web，统一走 pnpm workspace\n",[146,315,316,324],{"__ignoreMap":245},[249,317,318,320,322],{"class":251,"line":252},[249,319,256],{"class":255},[249,321,260],{"class":259},[249,323,264],{"class":263},[249,325,326,328],{"class":251,"line":267},[249,327,271],{"class":270},[249,329,330],{"class":274}," 用 mono-repo 模式建 3 个 package：core \u002F cli \u002F web，统一走 pnpm workspace\n",[35,332,333],{},"子代理并行起 3 个目录的初始化，单次任务跑完 ~3 分钟，token 用约 80k。",[23,335,337],{"id":336},"上手-5-分钟","上手 5 分钟",[240,339,341],{"className":242,"code":340,"language":244,"meta":245,"style":245},"# macOS \u002F Linux\ncurl -fsSL https:\u002F\u002Fchatgpt.com\u002Fcodex\u002Finstall.sh | sh\n\n# Windows（原生 PowerShell）\n# 见官方 Windows setup guide，或用 npm i -g @openai\u002Fcodex\n\ncodex                          # 启动 TUI\ncodex -m gpt-5-codex .         # 在当前目录起 Agent\ncodex --remote wss:\u002F\u002F...       # 远程模式（SSH \u002F 容器）\ncodex features list            # 看可用 feature flag\ncodex features enable unified_exec\n",[146,342,343,348,365,372,378,384,389,397,413,427,441],{"__ignoreMap":245},[249,344,345],{"class":251,"line":252},[249,346,347],{"class":305},"# macOS \u002F Linux\n",[249,349,350,353,356,359,362],{"class":251,"line":267},[249,351,352],{"class":255},"curl",[249,354,355],{"class":259}," -fsSL",[249,357,358],{"class":263}," https:\u002F\u002Fchatgpt.com\u002Fcodex\u002Finstall.sh",[249,360,361],{"class":270}," |",[249,363,364],{"class":255}," sh\n",[249,366,368],{"class":251,"line":367},3,[249,369,371],{"emptyLinePlaceholder":370},true,"\n",[249,373,375],{"class":251,"line":374},4,[249,376,377],{"class":305},"# Windows（原生 PowerShell）\n",[249,379,381],{"class":251,"line":380},5,[249,382,383],{"class":305},"# 见官方 Windows setup guide，或用 npm i -g @openai\u002Fcodex\n",[249,385,387],{"class":251,"line":386},6,[249,388,371],{"emptyLinePlaceholder":370},[249,390,392,394],{"class":251,"line":391},7,[249,393,256],{"class":255},[249,395,396],{"class":305},"                          # 启动 TUI\n",[249,398,400,402,404,407,410],{"class":251,"line":399},8,[249,401,256],{"class":255},[249,403,260],{"class":259},[249,405,406],{"class":263}," gpt-5-codex",[249,408,409],{"class":263}," .",[249,411,412],{"class":305},"         # 在当前目录起 Agent\n",[249,414,416,418,421,424],{"class":251,"line":415},9,[249,417,256],{"class":255},[249,419,420],{"class":259}," --remote",[249,422,423],{"class":263}," wss:\u002F\u002F...",[249,425,426],{"class":305},"       # 远程模式（SSH \u002F 容器）\n",[249,428,430,432,435,438],{"class":251,"line":429},10,[249,431,256],{"class":255},[249,433,434],{"class":263}," features",[249,436,437],{"class":263}," list",[249,439,440],{"class":305},"            # 看可用 feature flag\n",[249,442,444,446,448,450],{"class":251,"line":443},11,[249,445,256],{"class":255},[249,447,434],{"class":263},[249,449,297],{"class":263},[249,451,452],{"class":263}," unified_exec\n",[35,454,455,456,459,460,463],{},"配置文件：",[146,457,458],{},"$CODEX_HOME\u002Fconfig.toml","（默认 ",[146,461,462],{},"~\u002F.codex\u002Fconfig.toml","）。",[23,465,466],{"id":466},"同类对比",[154,468,469,487],{},[157,470,471],{},[160,472,473,476,478,481,484],{},[163,474,475],{},"维度",[163,477,12],{},[163,479,480],{},"Claude Code",[163,482,483],{},"Aider",[163,485,486],{},"Cline",[172,488,489,505,521,537,554,569,584,599],{},[160,490,491,494,497,499,502],{},[177,492,493],{},"形态",[177,495,496],{},"终端 TUI",[177,498,496],{},[177,500,501],{},"终端 REPL",[177,503,504],{},"VS Code 插件",[160,506,507,510,513,516,519],{},[177,508,509],{},"默认模型",[177,511,512],{},"gpt-5-codex",[177,514,515],{},"Claude Sonnet\u002FOpus",[177,517,518],{},"BYOK 任意",[177,520,518],{},[160,522,523,526,529,532,535],{},[177,524,525],{},"含在订阅",[177,527,528],{},"ChatGPT Plus\u002FPro",[177,530,531],{},"Claude.ai $20\u002F月",[177,533,534],{},"❌（仅 API）",[177,536,534],{},[160,538,539,542,545,548,551],{},[177,540,541],{},"沙箱",[177,543,544],{},"macOS Sandbox \u002F Landlock \u002F AppContainer",[177,546,547],{},"类似",[177,549,550],{},"无",[177,552,553],{},"VS Code 环境",[160,555,556,559,562,564,567],{},[177,557,558],{},"MCP",[177,560,561],{},"✅",[177,563,561],{},[177,565,566],{},"部分",[177,568,561],{},[160,570,571,573,576,579,582],{},[177,572,137],{},[177,574,575],{},"✅ GA",[177,577,578],{},"✅ Task tool",[177,580,581],{},"❌",[177,583,581],{},[160,585,586,589,592,595,597],{},[177,587,588],{},"开源",[177,590,591],{},"Apache-2.0",[177,593,594],{},"闭源",[177,596,591],{},[177,598,591],{},[160,600,601,604,606,608,610],{},[177,602,603],{},"原生 Windows",[177,605,561],{},[177,607,566],{},[177,609,561],{},[177,611,561],{},[220,613,614],{},[35,615,616],{},"一句话区分：Codex CLI = OpenAI 官方版的 Claude Code；Claude Code = Anthropic 官方版的 Codex；Aider = 任意 OpenAI 兼容 API 都能跑；Cline = VS Code 里的 GUI 终端 Agent。",[23,618,619],{"id":619},"避坑清单",[94,621,622,628,638,648,654,660],{},[97,623,624,627],{},[38,625,626],{},"国内访问别频繁切 IP","，OpenAI 风控严，账号被封基本无法找回。",[97,629,630,633,634,637],{},[38,631,632],{},"沙箱默认会限制网络","，跑 ",[146,635,636],{},"npm install"," 等需要联网的命令前先看 approval 弹窗。",[97,639,640,643,644,647],{},[38,641,642],{},"Subagents 吃 token 多","，预算敏感时关闭 ",[146,645,646],{},"[agents]"," 配置或换 mini 模型。",[97,649,650,653],{},[38,651,652],{},"WebSocket 远程模式只接受 wss:\u002F\u002F 或 localhost ws:\u002F\u002F","，远程公网必须 TLS。",[97,655,656,659],{},[38,657,658],{},"gpt-5-codex 比 gpt-5.5 便宜但能力对齐","，2026-03 之后默认推荐用 codex 系列而非 5.5。",[97,661,662,669,670,673],{},[38,663,664,665,668],{},"不要用过期的 ",[146,666,667],{},"--approval-mode"," 旧参数","，新版用 ",[146,671,672],{},"codex features"," 子命令管理。",[23,675,677],{"id":676},"适合-不适合","适合 \u002F 不适合",[35,679,680,681,684],{},"✅ 终端 \u002F TMUX \u002F Vim 重度用户；已订阅 ChatGPT Plus \u002F Pro 的人；Windows 原生开发者；headless \u002F SSH \u002F 容器场景。",[682,683],"br",{},"\n❌ GUI 党；纯内网开发；偏好 Claude 长上下文风格的人。",[23,686,687],{"id":687},"相关阅读",[119,689,690,697,704],{},[97,691,692,693],{},"配套 playbook：",[57,694,696],{"href":695},"\u002Fplaybook\u002Fcodex-cli-vs-claude-code.html","Codex CLI vs Claude Code 怎么选",[97,698,699,700],{},"同分类：",[57,701,703],{"href":702},"\u002Fcoding\u002Fcli\u002F","AI CLI 全分类",[97,705,706,707,710,711,710,714],{},"替代品：",[57,708,480],{"href":709},"\u002Fcoding\u002Fcli\u002Fclaude-code.html"," · ",[57,712,483],{"href":713},"\u002Fcoding\u002Fcli\u002Faider.html",[57,715,486],{"href":716},"\u002Fcoding\u002Fcli\u002Fcline.html",[23,718,719],{"id":719},"来源",[119,721,722,729,736,742],{},[97,723,724,725],{},"官方文档：",[57,726,727],{"href":727,"rel":728},"https:\u002F\u002Fdevelopers.openai.com\u002Fcodex\u002Fcli",[83],[97,730,731,732],{},"Features 页：",[57,733,734],{"href":734,"rel":735},"https:\u002F\u002Fdevelopers.openai.com\u002Fcodex\u002Fcli\u002Ffeatures",[83],[97,737,738,739],{},"GitHub：",[57,740,81],{"href":81,"rel":741},[83],[97,743,744,745],{},"2026 更新综述：",[57,746,747],{"href":747,"rel":748},"https:\u002F\u002Fcodex.danielvaughan.com\u002F2026\u002F03\u002F27\u002Fcodex-cli-in-2026-whats-new",[83],[220,750,751],{},[35,752,753,754,758],{},"本卡片由 AIHO 编辑部根据以上公开资料整理，非厂商付费内容；定价与功能以官网为准，欢迎在 ",[57,755,757],{"href":756},"mailto:hello@aiho.net","反馈邮箱"," 反馈更新。",[760,761,762],"style",{},"html pre.shiki code .sScJk, html code.shiki .sScJk{--shiki-default:#6F42C1;--shiki-dark:#B392F0}html pre.shiki code .sj4cs, html code.shiki .sj4cs{--shiki-default:#005CC5;--shiki-dark:#79B8FF}html pre.shiki code .sZZnC, html code.shiki .sZZnC{--shiki-default:#032F62;--shiki-dark:#9ECBFF}html pre.shiki code .szBVR, html code.shiki .szBVR{--shiki-default:#D73A49;--shiki-dark:#F97583}html pre.shiki code .sVt8B, html code.shiki .sVt8B{--shiki-default:#24292E;--shiki-dark:#E1E4E8}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sJ8bj, html code.shiki .sJ8bj{--shiki-default:#6A737D;--shiki-dark:#6A737D}",{"title":245,"searchDepth":367,"depth":367,"links":764},[765,766,767,768,773,774,775,776,777,778],{"id":25,"depth":267,"text":26},{"id":76,"depth":267,"text":76},{"id":152,"depth":267,"text":152},{"id":227,"depth":267,"text":228,"children":769},[770,771,772],{"id":237,"depth":367,"text":238},{"id":281,"depth":367,"text":282},{"id":309,"depth":367,"text":310},{"id":336,"depth":267,"text":337},{"id":466,"depth":267,"text":466},{"id":619,"depth":267,"text":619},{"id":676,"depth":267,"text":677},{"id":687,"depth":267,"text":687},{"id":719,"depth":267,"text":719},"cli","\u002Fimg\u002Ftools\u002Fcodex.webp","Codex CLI 真实评测：OpenAI 官方开源（Apache-2.0）终端 Coding Agent，Rust 实现，原生 Windows 沙箱 + 子代理 + MCP + 钩子 + 远程控制；2026-07 接入 GPT-5.6（Sol\u002FTerra\u002FLuna）家族，支持 ACP 可在 Devin Desktop \u002F Zed 运行，Plus\u002FPro\u002FTeam\u002FEdu 计划已含。",false,"md",[785,788,791,794,797],{"q":786,"a":787},"Codex CLI 和 Claude Code 有什么区别？","形态几乎一致：都是终端 Agent + 沙箱执行 + MCP + 子代理。差异主要在模型——Codex CLI 走 OpenAI 的 gpt-5-codex 系列，Claude Code 走 Anthropic Sonnet\u002FOpus。OpenAI 在原生 Windows 沙箱（不需要 WSL）和 Rust 实现速度上略胜，Claude 在长任务上下文连续性上略胜。",{"q":789,"a":790},"在 Windows 上怎么用？","原生 PowerShell 沙箱模式（推荐），也支持 WSL2。安装命令：curl -fsSL https:\u002F\u002Fchatgpt.com\u002Fcodex\u002Finstall.sh | sh（macOS\u002FLinux），Windows 直接通过 npm 或 PowerShell installer。",{"q":792,"a":793},"国内能用吗？","需要 OpenAI 账号 + 稳定代理。Plus \u002F Pro 订阅可走支付宝。直接 `codex` 即可启动。",{"q":795,"a":796},"Codex CLI 支持本地模型吗？","原生只走 OpenAI API。如果要本地模型，建议用 Aider（OpenAI 兼容 endpoint，可指向 Ollama \u002F vLLM）。",{"q":798,"a":799},"Subagents \u002F Hooks \u002F MCP 是什么？","Subagents：把大任务拆给多个并行子代理；Hooks（PostToolUse \u002F userpromptsubmit）：在工具调用前后插入企业策略；MCP：连外部工具（GitHub \u002F 数据库 \u002F Slack）。Codex 2026 把这三块都做到了 GA。",[801,802],"zh","en",{},[805,806,807,512],"gpt-5.6-sol","gpt-5.6-terra","gpt-5.6-luna",[809,810,811],"重度 GUI 党（终端排斥者请用 Cursor）","国内纯内网（OpenAI API 需稳定代理）","需要 Claude 上下文风格的人","\u002Ftools\u002Fcoding\u002Fcli\u002Fcodex","coding",[815,816,817],"windows","macos","linux",[819,823,826,830],{"plan":179,"price":182,"limit":820,"cn_pay":821,"note":822},"含 Codex CLI 使用额度，默认 gpt-5-codex-mini（2026-03 起额度 +4×）","支付宝","个人入门",{"plan":190,"price":193,"limit":824,"cn_pay":821,"note":825},"更高额度 + 优先处理 + GPT-5.3-Codex-Spark 研究预览","Agent 重度用户",{"plan":201,"price":204,"limit":827,"cn_pay":828,"note":829},"团队管理 + SSO + Codex 含在内","—","团队档",{"plan":831,"price":215,"limit":832,"cn_pay":828,"note":833},"纯 API 调用","gpt-5.5 ≈ $1.25\u002F$10 per 1M tokens（input\u002Foutput）","BYOK 自由模式","ChatGPT Plus\u002FPro\u002FBusiness\u002FEdu\u002FEnterprise 包含 \u002F 或按 OpenAI API 计费","2026-06-18",[837,838],"ai-coding\u002Fcodex-cli-vs-claude-code","ai-coding\u002Fterminal-agent-workflow",[840,841,842,843],"aider-deep-review","claude-code-deep-review","codex-deep-review","cursor-deep-review",{"power":380,"ux":374,"price":374,"cn_support":367,"stability":374},{"title":12,"description":781},"coding\u002Fcli\u002Fcodex",[848,850,852,854,856],{"title":849,"url":727},"Codex CLI 官方文档",{"title":851,"url":734},"Codex CLI Features 官方",{"title":853,"url":81},"Codex CLI GitHub",{"title":855,"url":747},"Codex CLI 2026 更新综述",{"title":857,"url":858},"Codex CLI 0.144.1 Release","https:\u002F\u002Fgithub.com\u002Fopenai\u002Fcodex\u002Freleases","tools\u002Fcoding\u002Fcli\u002Fcodex",[861,862,863,864],"终端 \u002F TMUX \u002F Vim 重度用户","已经订阅 ChatGPT Plus \u002F Pro 的人（白嫖 Codex 用量）","Windows 原生开发者（Codex CLI 有 PowerShell 沙箱，不必走 WSL）","需要远程 SSH \u002F 容器中跑 Agent 的人（headless 友好）","OpenAI 官方终端 Coding Agent，GPT-5.6 家族驱动，支持 ACP",[779,867,868,18,869,870,871,872,873],"agent","terminal","gpt-5","subagents","mcp","opensource","rust","2026-07-20","Claude Code 的 OpenAI 版镜像。Plus \u002F Pro 已含、Windows 原生沙箱、Rust 速度快，喜欢 GPT 派的人首选；Claude Sonnet 4.5 在长任务上仍略胜，喜欢 Claude 的留 Claude Code。","4zwRzenYhUbSOeoZZ5kuIQDF1MkoTXOIYq-1KZ2U2F4",{"id":878,"title":879,"alternatives":880,"api_compatible":881,"body":884,"category":779,"chinese_friendly":367,"cover":1460,"description":1461,"domestic":782,"extension":783,"faq":1462,"free":782,"github":1434,"languages":1475,"lastVerified":9,"meta":1476,"models":1477,"navigation":370,"notSuitable":1481,"opensource":370,"path":1485,"pillar":813,"platforms":1486,"priceTable":1487,"pricing":1501,"published":1502,"relatedPlaybooks":1503,"relatedReviews":9,"score":1505,"self_host":782,"seo":1506,"seoTitle":9,"slug":1507,"sources":1508,"stem":1513,"suitable":1514,"tagline":1519,"tags":1520,"updated":1502,"verdict":1523,"website":1427,"__hash__":1524},"tools\u002Ftools\u002Fcoding\u002Fcli\u002Fgemini-cli.md","Gemini CLI",[14,846,15],[882,883],"gemini","vertex-ai",{"type":20,"value":885,"toc":1444},[886,888,903,906,912,915,935,938,993,996,999,1080,1083,1133,1136,1140,1143,1165,1168,1171,1175,1183,1186,1190,1196,1199,1203,1240,1243,1246,1357,1362,1376,1378,1410,1412,1418,1420,1436,1441],[23,887,26],{"id":25},[28,889,891,900],{"className":890},[31,32,33],[35,892,893,895,896,899],{},[38,894,40],{}," Gemini CLI 是 Google 官方开源的终端 AI Agent。它把 Gemini 模型、文件读写、shell、web fetch、Google Search grounding 和 MCP 接到一个命令行工具里，最大卖点是 ",[38,897,898],{},"1M token 上下文 + 个人账号免费额度","。",[35,901,902],{},"如果你已经在用 Claude Code \u002F Codex CLI，Gemini CLI 不一定替代它们，但很适合作为「第二意见」「低成本大仓库阅读」「联网查新资料」的工具。",[23,904,905],{"id":905},"它是什么",[35,907,908,909,911],{},"Gemini CLI 是一个 Apache-2.0 开源的终端 Agent。使用方式和 Claude Code \u002F Codex CLI 类似：进入项目目录，运行 ",[146,910,882],{},"，然后用自然语言让它读文件、解释架构、修改代码、跑命令、调试错误。",[35,913,914],{},"它的特点不是「最强代码生成」，而是三件事：",[94,916,917,923,929],{},[97,918,919,922],{},[38,920,921],{},"上下文大","：官方文档强调可访问 Gemini 2.5 Pro 的 1M token context window。",[97,924,925,928],{},[38,926,927],{},"免费额度大","：个人 Google 账号入口标注 60 requests\u002Fmin、1,000 requests\u002Fday。",[97,930,931,934],{},[38,932,933],{},"搜索原生","：Google Search grounding 是内置能力，查新资料、查报错、查 API 文档时很顺手。",[23,936,937],{"id":937},"安装与启动",[240,939,941],{"className":242,"code":940,"language":244,"meta":245,"style":245},"# 免安装试用\nnpx https:\u002F\u002Fgithub.com\u002Fgoogle-gemini\u002Fgemini-cli\n\n# 全局安装\nnpm install -g @google\u002Fgemini-cli\n\n# 启动当前目录会话\ngemini\n",[146,942,943,948,956,960,965,979,983,988],{"__ignoreMap":245},[249,944,945],{"class":251,"line":252},[249,946,947],{"class":305},"# 免安装试用\n",[249,949,950,953],{"class":251,"line":267},[249,951,952],{"class":255},"npx",[249,954,955],{"class":263}," https:\u002F\u002Fgithub.com\u002Fgoogle-gemini\u002Fgemini-cli\n",[249,957,958],{"class":251,"line":367},[249,959,371],{"emptyLinePlaceholder":370},[249,961,962],{"class":251,"line":374},[249,963,964],{"class":305},"# 全局安装\n",[249,966,967,970,973,976],{"class":251,"line":380},[249,968,969],{"class":255},"npm",[249,971,972],{"class":263}," install",[249,974,975],{"class":259}," -g",[249,977,978],{"class":263}," @google\u002Fgemini-cli\n",[249,980,981],{"class":251,"line":386},[249,982,371],{"emptyLinePlaceholder":370},[249,984,985],{"class":251,"line":391},[249,986,987],{"class":305},"# 启动当前目录会话\n",[249,989,990],{"class":251,"line":399},[249,991,992],{"class":255},"gemini\n",[35,994,995],{},"要求 Node.js 20+，支持 Windows \u002F macOS \u002F Linux。",[35,997,998],{},"常用命令：",[240,1000,1002],{"className":242,"code":1001,"language":244,"meta":245,"style":245},"# 非交互问答\ngemini -p \"Explain the architecture of this codebase\"\n\n# 指定模型\ngemini -m gemini-2.5-flash\n\n# 额外包含目录\ngemini --include-directories ..\u002Fdocs,..\u002Fpackages\n\n# JSON 输出，方便脚本串联\ngemini -p \"Summarize open issues\" --output-format json\n",[146,1003,1004,1009,1019,1023,1028,1037,1041,1046,1056,1060,1065],{"__ignoreMap":245},[249,1005,1006],{"class":251,"line":252},[249,1007,1008],{"class":305},"# 非交互问答\n",[249,1010,1011,1013,1016],{"class":251,"line":267},[249,1012,882],{"class":255},[249,1014,1015],{"class":259}," -p",[249,1017,1018],{"class":263}," \"Explain the architecture of this codebase\"\n",[249,1020,1021],{"class":251,"line":367},[249,1022,371],{"emptyLinePlaceholder":370},[249,1024,1025],{"class":251,"line":374},[249,1026,1027],{"class":305},"# 指定模型\n",[249,1029,1030,1032,1034],{"class":251,"line":380},[249,1031,882],{"class":255},[249,1033,260],{"class":259},[249,1035,1036],{"class":263}," gemini-2.5-flash\n",[249,1038,1039],{"class":251,"line":386},[249,1040,371],{"emptyLinePlaceholder":370},[249,1042,1043],{"class":251,"line":391},[249,1044,1045],{"class":305},"# 额外包含目录\n",[249,1047,1048,1050,1053],{"class":251,"line":399},[249,1049,882],{"class":255},[249,1051,1052],{"class":259}," --include-directories",[249,1054,1055],{"class":263}," ..\u002Fdocs,..\u002Fpackages\n",[249,1057,1058],{"class":251,"line":415},[249,1059,371],{"emptyLinePlaceholder":370},[249,1061,1062],{"class":251,"line":429},[249,1063,1064],{"class":305},"# JSON 输出，方便脚本串联\n",[249,1066,1067,1069,1071,1074,1077],{"class":251,"line":443},[249,1068,882],{"class":255},[249,1070,1015],{"class":259},[249,1072,1073],{"class":263}," \"Summarize open issues\"",[249,1075,1076],{"class":259}," --output-format",[249,1078,1079],{"class":263}," json\n",[23,1081,1082],{"id":1082},"三种认证路径",[154,1084,1085,1098],{},[157,1086,1087],{},[160,1088,1089,1092,1095],{},[163,1090,1091],{},"路径",[163,1093,1094],{},"适合谁",[163,1096,1097],{},"关键点",[172,1099,1100,1111,1122],{},[160,1101,1102,1105,1108],{},[177,1103,1104],{},"Google OAuth",[177,1106,1107],{},"个人开发者",[177,1109,1110],{},"免费额度最大，上手最简单",[160,1112,1113,1116,1119],{},[177,1114,1115],{},"Gemini API Key",[177,1117,1118],{},"脚本 \u002F CI",[177,1120,1121],{},"更适合自动化，额度跟 API tier 走",[160,1123,1124,1127,1130],{},[177,1125,1126],{},"Vertex AI",[177,1128,1129],{},"企业 \u002F GCP 团队",[177,1131,1132],{},"IAM、审计、合规、配额更可控",[35,1134,1135],{},"个人使用优先 OAuth；生产和团队内使用优先 Vertex AI。",[23,1137,1139],{"id":1138},"mcp-与项目记忆","MCP 与项目记忆",[35,1141,1142],{},"Gemini CLI 支持两类扩展：",[119,1144,1145,1151],{},[97,1146,1147,1150],{},[38,1148,1149],{},"MCP server","：把 GitHub、数据库、内部 API 暴露给 Agent。",[97,1152,1153,1156,1157,1160,1161,1164],{},[38,1154,1155],{},"GEMINI.md","：类似 Claude Code 的 ",[146,1158,1159],{},"CLAUDE.md"," \u002F Copilot 的 ",[146,1162,1163],{},"AGENTS.md","，用于写项目约定、测试命令、编码风格。",[35,1166,1167],{},"这让 Gemini CLI 可以进入 2026 年主流终端 Agent 的标准形态：项目记忆 + 工具协议 + headless 自动化。",[23,1169,1170],{"id":1170},"真实适用场景",[235,1172,1174],{"id":1173},"_1-大仓库先读懂","1. 大仓库先读懂",[240,1176,1181],{"className":1177,"code":1179,"language":1180,"meta":245},[1178],"language-text","先读 package.json、README、src 入口文件，输出这个项目的架构图和关键风险点。\n","text",[146,1182,1179],{"__ignoreMap":245},[35,1184,1185],{},"1M 上下文让它在「读文档 + 读代码」阶段很有优势，尤其适合 monorepo 的初始摸底。",[235,1187,1189],{"id":1188},"_2-查新资料后改代码","2. 查新资料后改代码",[240,1191,1194],{"className":1192,"code":1193,"language":1180,"meta":245},[1178],"查一下 Nuxt 4 最新 route rules 写法，然后检查本项目 nuxt.config.ts 是否需要调整。\n",[146,1195,1193],{"__ignoreMap":245},[35,1197,1198],{},"Google Search grounding 的价值在这里体现：它不是只靠训练数据，而是能把搜索结果纳入推理。",[235,1200,1202],{"id":1201},"_3-低成本-issue-triage","3. 低成本 issue triage",[240,1204,1206],{"className":242,"code":1205,"language":244,"meta":245,"style":245},"gh issue list --json title,body \\\n  | gemini -p \"按修复难度给这些 issue 排序，输出 JSON\"\n",[146,1207,1208,1227],{"__ignoreMap":245},[249,1209,1210,1213,1216,1218,1221,1224],{"class":251,"line":252},[249,1211,1212],{"class":255},"gh",[249,1214,1215],{"class":263}," issue",[249,1217,437],{"class":263},[249,1219,1220],{"class":259}," --json",[249,1222,1223],{"class":263}," title,body",[249,1225,1226],{"class":259}," \\\n",[249,1228,1229,1232,1235,1237],{"class":251,"line":267},[249,1230,1231],{"class":270},"  |",[249,1233,1234],{"class":255}," gemini",[249,1236,1015],{"class":259},[249,1238,1239],{"class":263}," \"按修复难度给这些 issue 排序，输出 JSON\"\n",[35,1241,1242],{},"和 Jules Tools \u002F GitHub CLI 组合时，可以把 Gemini CLI 当「任务分拣器」。",[23,1244,1245],{"id":1245},"与同类怎么选",[154,1247,1248,1262],{},[157,1249,1250],{},[160,1251,1252,1254,1256,1258,1260],{},[163,1253,475],{},[163,1255,879],{},[163,1257,480],{},[163,1259,12],{},[163,1261,483],{},[172,1263,1264,1281,1297,1313,1330,1345],{},[160,1265,1266,1269,1272,1275,1278],{},[177,1267,1268],{},"默认生态",[177,1270,1271],{},"Google \u002F Gemini",[177,1273,1274],{},"Anthropic",[177,1276,1277],{},"OpenAI \u002F ChatGPT",[177,1279,1280],{},"任意模型",[160,1282,1283,1286,1289,1291,1294],{},[177,1284,1285],{},"免费入口",[177,1287,1288],{},"✅ 很强",[177,1290,581],{},[177,1292,1293],{},"取决于 ChatGPT 订阅",[177,1295,1296],{},"本体免费，模型自费",[160,1298,1299,1302,1305,1308,1311],{},[177,1300,1301],{},"上下文",[177,1303,1304],{},"1M",[177,1306,1307],{},"1M 级别模型可用",[177,1309,1310],{},"取决于模型",[177,1312,1310],{},[160,1314,1315,1318,1321,1324,1327],{},[177,1316,1317],{},"搜索",[177,1319,1320],{},"Google Search 内置",[177,1322,1323],{},"需工具 \u002F MCP",[177,1325,1326],{},"内置 web 能力",[177,1328,1329],{},"取决于模型 \u002F 工具",[160,1331,1332,1335,1338,1341,1343],{},[177,1333,1334],{},"长任务稳定性",[177,1336,1337],{},"中上",[177,1339,1340],{},"强",[177,1342,1340],{},[177,1344,1337],{},[160,1346,1347,1349,1351,1353,1355],{},[177,1348,588],{},[177,1350,561],{},[177,1352,581],{},[177,1354,561],{},[177,1356,561],{},[35,1358,1359],{},[38,1360,1361],{},"AIHO 建议：",[119,1363,1364,1367,1370,1373],{},[97,1365,1366],{},"预算敏感 \u002F 想免费试：Gemini CLI",[97,1368,1369],{},"最稳长任务：Claude Code",[97,1371,1372],{},"已有 ChatGPT Plus\u002FPro：Codex CLI",[97,1374,1375],{},"想接国内模型 \u002F 自定义 base_url：Aider",[23,1377,619],{"id":619},[94,1379,1380,1386,1392,1398,1404],{},[97,1381,1382,1385],{},[38,1383,1384],{},"不要把免费额度当生产 SLA","：个人额度适合探索，生产任务走 API Key \u002F Vertex AI。",[97,1387,1388,1391],{},[38,1389,1390],{},"长任务先拆小","：即使上下文大，Agent 执行链路也可能漂移；30 分钟以上任务建议拆成 issue。",[97,1393,1394,1397],{},[38,1395,1396],{},"MCP server 要审计","：给 Agent 接工具等于扩权，第三方 server 先看源码和权限。",[97,1399,1400,1403],{},[38,1401,1402],{},"GEMINI.md 别写太散","：只放稳定约定、测试命令、目录说明，别塞临时需求。",[97,1405,1406,1409],{},[38,1407,1408],{},"国内网络先验证 OAuth","：登录流程不稳定会影响体验，必要时用 API key 路径。",[23,1411,677],{"id":676},[35,1413,1414,1415,1417],{},"✅ 适合：个人开发者、学生、开源项目维护者、大仓库阅读、联网查新、低成本脚本化分析。",[682,1416],{},"\n❌ 不适合：强合规生产环境、纯内网开发、预算不敏感但追求最高长任务稳定性的团队。",[23,1419,719],{"id":719},[119,1421,1422,1429],{},[97,1423,1424,1425],{},"Gemini CLI 官方文档：",[57,1426,1427],{"href":1427,"rel":1428},"https:\u002F\u002Fgoogle-gemini.github.io\u002Fgemini-cli\u002F",[83],[97,1430,1431,1432],{},"Gemini CLI GitHub：",[57,1433,1434],{"href":1434,"rel":1435},"https:\u002F\u002Fgithub.com\u002Fgoogle-gemini\u002Fgemini-cli",[83],[220,1437,1438],{},[35,1439,1440],{},"本卡片由 AIHO 编辑部根据公开资料整理，非厂商付费内容；功能和额度以官网为准。",[760,1442,1443],{},"html pre.shiki code .sJ8bj, html code.shiki .sJ8bj{--shiki-default:#6A737D;--shiki-dark:#6A737D}html pre.shiki code .sScJk, html code.shiki .sScJk{--shiki-default:#6F42C1;--shiki-dark:#B392F0}html pre.shiki code .sZZnC, html code.shiki .sZZnC{--shiki-default:#032F62;--shiki-dark:#9ECBFF}html pre.shiki code .sj4cs, html code.shiki .sj4cs{--shiki-default:#005CC5;--shiki-dark:#79B8FF}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .szBVR, html code.shiki .szBVR{--shiki-default:#D73A49;--shiki-dark:#F97583}",{"title":245,"searchDepth":367,"depth":367,"links":1445},[1446,1447,1448,1449,1450,1451,1456,1457,1458,1459],{"id":25,"depth":267,"text":26},{"id":905,"depth":267,"text":905},{"id":937,"depth":267,"text":937},{"id":1082,"depth":267,"text":1082},{"id":1138,"depth":267,"text":1139},{"id":1170,"depth":267,"text":1170,"children":1452},[1453,1454,1455],{"id":1173,"depth":367,"text":1174},{"id":1188,"depth":367,"text":1189},{"id":1201,"depth":367,"text":1202},{"id":1245,"depth":267,"text":1245},{"id":619,"depth":267,"text":619},{"id":676,"depth":267,"text":677},{"id":719,"depth":267,"text":719},"\u002Fimg\u002Ftools\u002Fgemini-cli.webp","Gemini CLI 真实评测：Google 官方开源（Apache-2.0）终端 AI Agent，2026 已接入 Gemini 3 Pro \u002F 3.1 Pro \u002F 3.5 Flash，最高 2M token 上下文、Google Search grounding、MCP、自定义 GEMINI.md、headless 脚本模式；个人 Google 账号可用 60 requests\u002Fmin、1,000 requests\u002Fday 免费额度。",[1463,1466,1469,1472],{"q":1464,"a":1465},"Gemini CLI 和 Claude Code \u002F Codex CLI 最大区别？","它的核心差异是免费额度和 Google 生态：个人 Google 账号即可获得较高免费请求额度，并内置 Google Search grounding。Claude Code 更稳，Codex 与 ChatGPT 订阅绑定更深，Gemini CLI 更适合低成本探索和大上下文阅读。",{"q":1467,"a":1468},"Gemini CLI 支持 MCP 吗？","支持。可以在 ~\u002F.gemini\u002Fsettings.json 里配置 MCP server，把 GitHub、数据库、Slack、内部 API 等工具接入 CLI。",{"q":1470,"a":1471},"能不能非交互使用？","可以。`gemini -p \"解释这个代码库\"` 会以 headless 模式输出结果，也可以加 `--output-format json` 做脚本化处理。",{"q":1473,"a":1474},"国内开发者适合吗？","如果能稳定访问 Google 服务，它的免费额度很有吸引力；如果网络不稳，建议优先 Aider + 国内模型或 Claude\u002FCodex 的稳定代理方案。",[802],{},[1478,1479,1480],"gemini-3-pro","gemini-3.1-pro","gemini-3.5-flash",[1482,1483,1484],"要求最稳长任务交付的生产重构","不能访问 Google 服务的纯内网环境","强依赖中文界面和本地化文档的用户","\u002Ftools\u002Fcoding\u002Fcli\u002Fgemini-cli",[815,816,817],[1488,1493,1497],{"plan":1489,"price":1490,"limit":1491,"note":1492},"个人 Google 账号","$0","60 requests\u002Fmin，1,000 requests\u002Fday","官方文档标注的免费入口，适合个人探索",{"plan":1115,"price":1494,"limit":1495,"note":1496},"按量计费","取决于 AI Studio \u002F API tier","适合自动化脚本和 CI",{"plan":1126,"price":1498,"limit":1499,"note":1500},"GCP 按量计费","企业配额与 IAM","适合生产与合规场景","开源免费 \u002F 个人 Google 账号免费额度 \u002F Gemini API 或 Vertex AI 按量计费","2026-06-25",[1504],"onboarding\u002Fterminal-agent-stack-2026",{"power":374,"ux":367,"price":380,"cn_support":367,"stability":374},{"title":879,"description":1461},"coding\u002Fcli\u002Fgemini-cli",[1509,1511],{"title":1510,"url":1427},"Gemini CLI 官方文档",{"title":1512,"url":1434},"Gemini CLI GitHub","tools\u002Fcoding\u002Fcli\u002Fgemini-cli",[1515,1516,1517,1518],"想低成本体验终端 Coding Agent 的个人开发者","需要 1M token 长上下文做代码库理解 \u002F 文档阅读","需要 Google Search grounding 辅助查新资料的任务","想在脚本里用 headless 模式批量分析 issue \u002F PR","Google 开源终端 AI Agent，2M 上下文 + 免费额度 + Google Search grounding",[779,867,868,1521,882,871,872,1522],"google","free-tier","终端 Agent 里最适合『低成本试水』的一支：免费额度大、1M 上下文、内置 Google Search。短板是产品打磨和长任务稳定性还不如 Claude Code \u002F Codex，生产级任务建议把它当第二意见或低成本探索工具。","YY5-0W1l2MFeQqIaG82KsIQrPuCCKk74vXVnMJ1WyQ0",1784565441462]