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