AI + CLI
从聊天到落地
从哪条路开始
几乎没碰过 AI，先去“从零认识 AI”。已经会网页聊天、想让助手改项目文件，再按：概念 → 订阅 → 安装 → 任务手册。
完全没碰过 AI、已经会聊天、还是要做设计——先选一条路。
资料可信度
官网看产品和权限；官方仓库看安装命令和版本；论坛、视频只用来发现“别人卡在哪”，别当价格和命令的最终依据——这些变得很快。
厂商文档、帮助中心、官方安装页。价格与用量额度只认这里。
GitHub 上的官方仓库、更新说明、示例。用来核对命令是否过期。
论坛、视频、帖子——适合发现坑，不适合当“现在仍正确”的证据。
测试版、预览开关。用之前先看官方更新说明，默认当不稳定。
为什么还要 命令行工具
网页聊天适合讨论和写草稿；命令行里的 AI 适合在项目文件夹里干具体活——可能读文件、改代码、跑命令，所以要限定范围，并自己检查结果。本指南覆盖 Codex CLI、Claude Code、Gemini CLI、Grok Build、OpenCode；命令以官方为准，并用版本记录 当安全网。
几乎没用过 AI：先打开“从零认识 AI”。已经会网页聊天：从“了解 AI”看权限，再去订阅与安装；第一次请在可丢弃的练习目录或分支里试。
不把二手教程当事实，不写容易过期的绝对价格，也不把第三方 grok-cli 当成 xAI 官方入口。动手前请再打开对应官方页面核对一眼。
网页聊天 · 官网 · 原理 · 国内外产品
从“AI 是什么”讲到聊天网页、为什么会说错、官网怎么进、国内产品怎么对照，以及聊天、画图、语音差在哪。不用装软件。
本文目录
按钮文案、页面布局会改版，文中配图是示意。价格与套餐以各平台账户内官方说明为准，本文不写具体金额。安全习惯：认准官方域名，验证码只看自己的邮箱或短信。
一
“人工智能”（Artificial Intelligence，简称 AI）这个词，在新闻里经常被用得很宽。人脸进门、刷短视频时的推荐、手机相册自动分类、地图规划路线、客服机器人、聊天窗口里的 ChatGPT——媒体都可能叫它们 AI。对刚入门的人，这样混在一起最容易晕：到底我该学的是哪一块？
更稳妥的分法是两层：
一句话概括聊天这一类：
它是一个会用自然语言跟你来回打字的软件助手，读过海量文字，很会“接着写”；它不是真人，也不能保证每一句都正确。
在打开 ChatGPT 之前，很多人已经接触过相关技术，只是产品没有用聊天框包装：
这些和 ChatGPT 背后技术不完全相同，但同属“让机器从数据里学规律”这条大河。ChatGPT 出圈的意义在于：它把能力收成谁都会用的对话窗口，门槛一下子降到“会打字”。
记住一句就够往下读：ChatGPT 是 AI 产品；AI 不等于只有 ChatGPT。
二
下面不是学术编年史，只帮你建立时间感：为什么 2022、2023 年大家突然都在谈“AI 聊天”，而实验室里的讨论其实早就开始了。
大约从 20 世纪中叶起，科学家和工程师就认真讨论：机器能不能完成需要智能的任务？那时的主流办法，很像编一本超厚说明书——遇到什么情况，就执行哪条规则。在棋类、专家系统等狭窄领域有成果，但真实世界的语言太活、规则写不完，路越走越窄。中间还出现过期望过高、资金退潮的“寒冬”。
人们逐渐把重心放到机器学习：给程序很多例子，让它自己估计规律。邮件为什么是垃圾、用户可能点哪条视频，都可以这样做。你不必手写“一万条广告特征”，而是让模型从数据里学。
大约 2010 年代起，深度学习在图像识别、语音识别上表现抢眼。电脑算得更快，能“喂”进去的数据也更多。语言方向同样受益：机器翻译、语音助手变得越来越好用，尽管那时大众还很少说“我在和 AI 写作”。
2017 年前后，一种叫 Transformer 的结构流行起来（你以后刷到“注意力机制”多半和它有关）。它特别适合处理一长串文字。后来的大规模语言模型，基本都站在这类思路上。新手不必背公式，只要知道：今天的聊天模型，不是魔术，是这条技术线上堆规模、堆数据、堆工程的结果。
2018 年前后，BERT、GPT 等路线证明一种高效做法：先在海量公开与授权文本上做广义的语言训练（像先广泛阅读），再针对对话、问答等场景调整。模型参数越来越大，能做的文字任务也越来越多：摘要、翻译、续写、简单推理、代码草稿等。
2022 年 11 月，OpenAI 发布 ChatGPT，用浏览器就能聊。它不是凭空发明“语言能力”，而是把大模型做成对普通人友好的对话产品：能追问、能认错（有时）、会拒绝一些不当请求。上线后传播极快，后面 Claude、Gemini、Grok 以及国内多家产品进入同一赛道——形态都是“官网 / App + 对话框”。
机器能否表现智能？早期靠规则和符号推理，成就有限。
从数据里学规律：过滤、推荐、识别等进入日常生活。
图像、语音等进步明显；算力和数据成为关键投入。
给大规模语言建模提供主流结构，后面的大模型多由此发展。
先广泛学语言，再适配任务；能力与规模一起上升。
ChatGPT 等降低使用门槛；多厂商推出同类聊天产品。
读史的收获可以压成两句：
三
面向小白的技术文章里，最耐用的比方是：聊天背后的文字模型很像在玩文字接龙。训练时，它在海量文本上练习“根据上文，下一个词更可能是什么”。用的时候，你给一段话，它按学到的规律一个单元一个单元往下接，接成完整段落。
这些小单元常叫 token（可能比字更碎，也可能是短词）。你不必会算 token，只要知道：话越长、答越长，通常越占额度；产品说的“长度限制”“一次能装下的内容量”，都和它有关。
因为它优化的目标，首先是“读起来像合理的下一句”，不是每次回答前都去权威数据库盖章。所以它可能：
这种情况常被称为幻觉。应对态度很简单：重要事实自己查；涉及看病、法律、理财、安全操作，以专业人士和权威来源为准。
同一会话里，前面的问答通常会作为上下文一起送进去，所以你可以追问“再短一点”“改成表格”。但上下文有长度上限：聊特别长，开头内容可能被挤掉，它会“忘”。换“新聊天”等于基本换一桌谈，旧话题默认不带上（除非产品有特别的记忆功能，且你了解其范围）。
同一网站里，有时能切换名字不同的模型（有的偏快、有的偏强、有的更擅长推理或多模态）。对新手：先用默认即可。差别存在，但把任务说清楚，通常比纠结型号更影响体验。
四
把对话式 AI 想成“语言方面的中间劳动力”会比较贴切：它擅长起草和整理，不擅长替你负最终责任。
更合适
高风险
一条好记的纪律：可以贴草稿，不要贴钥匙；可以要初稿，不要要终审。
五
新手不需要先装开发工具。主流路径是：浏览器打开官方网站 → 注册或登录 → 在输入框对话。手机则可用官方 App（应用商店里核对开发者）。
逻辑同样是“官方站 / 官方 App + 对话”。名称与入口以各公司官网为准（例如百度文心、阿里通义、月之暗面 Kimi、字节豆包等）。选择哪一家，取决于网络环境、语言习惯、账号体系和功能；对新手，先固定一个会用，比同时注册五个更重要。
打开官网后，通常有登录、注册，有时支持用手机号、邮箱或 Google / Apple 等账号继续。按提示完成验证即可。成功的标志不是看完所有广告页，而是出现可以打字的输入框。
过程中可能看到会员、升级说明。是否付费是另一件事；许多产品提供免费或有限次数的使用。额度、价格、取消方式只以账户内官方页面为准。
未登录示意：先找到登录或注册。中英文界面都正常。
界面示意说明模拟“尚未登录”时的官网结构：标题区 + 登录/注册按钮。中英文文案以你打开的真实官网为准；本图为排版示意，不是 chatgpt.com 截图。
验证码只来自你自己的邮箱或短信。不要把验证码发给任何“客服”。不要下载名称相似、开发者陌生的 App。官网地址栏应是 https，域名应眼熟。
各家排版不同，但信息架构高度相似：
电脑用 Chrome、Edge、Safari、Firefox 等打开官网即可。手机可用移动网页或官方 App。建议电脑与手机登录同一账号，对话才容易同步（视产品是否支持）。
六
模型读不到你脑子里的潜台词。请求越接近“可执行说明”，输出越接近能用的草稿。这不是考试技巧，而是沟通常识。
我想要：…… 给谁看 / 什么场合：…… 已经确定的情况：……（只写真的） 希望的形式：……（几条 / 一封信 / 长短 / 语气） 请不要：……（编造数据或链接、越权承诺等）
第一份回答不完美很常见。你可以继续说：“短一半”“改成三条”“删掉第二段”“语气再正式一点”。会追问，比追求“一条提示打天下”更贴近真实使用。
解释概念：“请用高中生能懂的话解释××：先两句定义，再一个生活例子，再补一个常见误解。”
写短函：“给××写邮件，目的是××，事实是××，150 字内，语气得体，不要写入我没提过的承诺。”
整理材料：“下面笔记请整理成：三句摘要、最多七条要点、三件可执行的小事；原文没有的别编。”然后粘贴材料。
七
免费与付费：多数产品提供某种形式的免费或入门额度，高级档可能更快、额度更高、模型更新或功能更多。是否订阅取决于你的使用频率和需求。金额、用量额度、发票与取消，只以官方账户与帮助中心为准；不要轻信“代充”“破解会员”。
数据与隐私：你输入的内容会进入对方服务器处理。不同产品对“是否用于训练”“保留多久”政策不同，可在设置或隐私政策里查看。原则仍是：不把密钥和隐私当聊天素材。
联网与插件：有的模式能浏览网页或调用工具，有的不能。若回答依赖“今天”的信息，要确认产品是否具备联网，并再次核对来源。
八
九
打不开官网：换网络、换浏览器，检查扩展是否拦截；查官方是否发布状态说明。避免来路不明的“镜像站”。
收不到验证码：等一分钟再试，检查垃圾邮件与短信拦截、区号是否正确。
一直推销会员：关闭弹窗，看基础功能是否仍可用；订阅与否自行决定。
提示地区不可用：遵循官方政策；不要购买来源不明的成品账号。
回答突然变傻或遗忘前文：可能触达长度上限，可新开对话并重新粘贴关键背景。
拒绝回答：可能触发安全策略；换一种合规表述，或接受该主题不适合由它处理。
五（续）· 国内产品
在国内网络环境下，很多人第一站并不是 ChatGPT，而是本土产品。形态和前面说的一样：官方网站或官方 App → 登录 → 对话框。下表方便你对照“产品叫什么、哪家公司、官网去哪开”。入口可能调整，以浏览器实际打开的官方页面为准；请认准域名，少点搜索广告。
价格、每日次数、是否要实名，各家不同，且经常变化——本文不列金额，只帮你找对官方门。
| 产品（常用名） | 公司 / 背景 | 官网入口（示例） | 新手可以怎么理解 |
|---|---|---|---|
| 文心一言 | 百度 · 文心大模型 | yiyan.baidu.com | 中文场景常见入口之一；网页可聊，也有 App。 |
| 通义千问 | 阿里 · 通义 | tongyi.com 或阿里云通义相关页 | 综合型对话与办公向能力常见；认准阿里体系官网。 |
| Kimi | 月之暗面 Moonshot | kimi.moonshot.cn | 常被提到“长文本 / 读长文档”；同样是网页对话形态。 |
| 豆包 | 字节跳动 | doubao.com | 偏日常对话与内容辅助；网页与 App 都常见。 |
| DeepSeek | 深度求索 | chat.deepseek.com | 网页聊天入口；也有人关注其开源模型路线，新手仍从官网聊起即可。 |
| 智谱清言 | 智谱 AI · ChatGLM 系列 | chatglm.cn | 对话产品形态；官网即入口。 |
| 讯飞星火 | 科大讯飞 | xinghuo.xfyun.cn | 语音与教育场景常被提起；仍建议从官方站进入。 |
没有“必须用哪一个”。网络打得开、登录方便、中文用着顺，就可以先固定一个用熟。同时注册一堆账号，不如把“把事情说清楚、会核对”练熟。无论国内外，仿站和来路不明的“破解版”都不要碰。
网上横评更新很快，下面只帮你建立第一印象。真实体验以你账号里当前版本为准；价格不写死。
| 你更常做的事 | 可以优先试试（国内网页） | 为什么这样说（小白版） |
|---|---|---|
| 日常问答、口语化聊天、短视频文案 | 豆包 | 公开评测里常被说成“好开口、懂热点”；适合当第一站闲聊助手。 |
| 读很长的 PDF / 论文 / 合同草稿 | Kimi | 长文本、长上下文是其常见卖点；仍要自己核对关键条款。 |
| 写代码、数学推导、技术问答 | DeepSeek | 技术向与开源讨论多；写代码口碑高，照样要跑测验证。 |
| 公文感、正式写作、阿里系办公 | 通义千问 | 企业/办公生态常见；表达偏规范时有人更爱用。 |
| 中文润色、搜索感强的问答 | 文心一言 | 中文场景与百度系能力常被提起；时效信息仍建议二次检索。 |
| 语音、口语、教育向 | 讯飞星火 | 语音交互与教育场景是其传统强项之一。 |
和国外产品对照时，可以这样记：
五（续）· 形态对比
新闻里“AI”三个字，经常把好几种东西揉在一起。对新手，先分清你主要在跟文字聊，还是在生成图，还是在说话，后面才不容易买错产品、用错预期。
图片说明 · 图 8a教学用插画：一人在电脑前使用“对话框”形态的 AI。气泡代表一问一答的文字交流，不是某个 App 的真实截图，也不含真实账号信息。
输入输出主要是字。写邮件、解释概念、整理笔记、改文案。ChatGPT、文心一言、Kimi 等首先是这种。
图片说明 · 图 8b教学用插画：数字画布上“生成”一幅画面，比喻文字描述 → 出图。用来区分“写文章的 AI”和“画画的 AI”，不是 Midjourney / 某站的产品截图。
你用文字描述（有时加参考图），它画出或改出图片：插画、海报草图、风格化照片。和“写一篇说明文”不是同一条流水线。
图片说明 · 图 8c教学用插画：麦克风与声波，代表“说话 / 听写 / 朗读”。对应语音助手、会议转写等；与纯打字对话框不同。
听懂你说的话、或把文字念出来：语音助手、会议转写、配音。有的产品会把“听→理解→答→再念出来”串在一起。
| 聊天 / 文本 AI | 图像生成 AI | 语音 AI | |
|---|---|---|---|
| 你主要输入什么 | 文字问题、材料、要求 | 画面描述、风格、参考图 | 说话、或待朗读的文字 |
| 它主要产出什么 | 回答、文稿、提纲、代码草稿 | 图片、局部重绘、风格迁移 | 识别出的文字、合成语音 |
| 典型用途 | 写作、学习、整理、客服话术 | 配图、设计草图、创意视觉 | 免提问答、字幕、有声内容 |
| 你怎么验收 | 事实是否对、是否像你要的语气 | 构图、细节、是否侵权风险 | 是否听清、发音是否自然 |
| 和“大模型”关系 | 多直接基于聊天背后的文字模型 | 多用扩散等图像专用模型（也可由大模型写提示词） | 语音识别 + 语言模型 + 语音合成常拼在一起 |
本导读的主线仍是聊天 / 文本 AI：历史、原理、官网对话框。图像与语音只作地图上的邻省——知道它们存在、别和聊天框混为一谈即可。若某产品在聊天里附带“生成一张图”按钮，那是多模态功能叠在对话产品上，验收时仍要分别看：字对不对、图合不合适。实时语音的最新产品形态，可参见后文“前沿动态”中的 实时语音（GPT-Live）。
新一点的产品常宣称“多模态”：同一条对话里，你可以丢图片问“图里是什么”，或让它根据文字出图。对新手，可以把它理解成：
底下可能接了不止一种能力，表面上仍是一个聊天窗口。使用时建议：文字结论当草稿核对；图片当草图看待；涉及真人肖像、品牌标识时更要谨慎。
十 · 前沿动态
前面几节讲的是“相对稳”的常识：历史、文字接龙、官网聊天框。这一节补一张会动的地图——行业还在快速变。读的时候请记住：功能名称、上线范围、免费/付费默认项都会改；以下以公开报道与官方说明为准，并标注时间，方便你对照最新官网。
不必追每一条新闻。对新手，分清三件事就够：① 这是文字聊天还是实时语音还是生图；② 是不是官方产品里的能力；③ 有没有改变你的使用方式（例如从打字变成能打断的通话）。
2026 年 7 月 8 日前后，OpenAI 推出新一代语音能力，产品侧常称为 实时语音（GPT-Live）（对外介绍见 OpenAI 博文 Introducing 实时语音（GPT-Live），以及 ChatGPT 里更新后的 Voice 体验）。它要解决的问题很具体：以前很多语音模式像“对讲机”——你说完，它再听、再想、再念；现在目标是更接近真人通话：能同时听和说，允许自然打断，语气更顺。
图片说明 · 图 9教学用插画，帮助理解 实时语音（GPT-Live） / ChatGPT Voice 一类“全双工”语音：你说话时对方也可以出声，允许自然打断，更像打电话而不是对讲机。图中声波交叠、手机光球均为象征，不是 OpenAI 官方界面截图，也未展示真实通话内容。
① 打开 chatgpt.com 或官方 App 并登录。② 在对话界面找麦克风 / Voice 按钮（位置常在输入框附近）。③ 按提示允许麦克风权限。④ 直接说话；想打断就插话试试。⑤ 重要结论仍建议让它“用文字总结一遍”再复制保存。
免费与付费默认的语音模型可能不同（公开说明里常见：免费偏 mini，付费可用更大 Live 模型）。以账户内说明为准。
| 对照项 | 较早的语音模式（概括） | 实时语音（GPT-Live）（2026-07 前后） |
|---|---|---|
| 说话方式 | 多像轮流：你说完 → 它答 | 更接近同时听与说，可自然打断 |
| 技术直觉 | 识别 → 文本模型 → 合成，分段拼接 | 面向实时对话的新一代语音模型；难问题可后台交给更强模型 |
| 你在产品里的入口 | ChatGPT Voice / 高级语音等历史名称 | 更新后的 ChatGPT Voice（由 实时语音（GPT-Live） 驱动） |
| 和“打字聊天”关系 | 同一产品里的另一种输入输出 | 仍是 ChatGPT 生态；只是从键盘换成实时语音 |
| 适合记住的一句话 | “对讲机式”语音助手 | “电话式”实时对话（仍是 AI，不是真人） |
介绍页：openai.com/index/introducing-gpt-live；直播与回放入口可在 openai.com/live 查找（例如 “ChatGPT Voice, powered by 实时语音（GPT-Live）”）。功能是否对你账号开放、按钮叫什么，以 ChatGPT 客户端实时界面为准。
和前文“语音 AI”的关系：第五节讲的是形态分类；实时语音（GPT-Live） 属于把实时语音做成一线产品能力的近期实例——说明“语音”这条线正在从“能听会念”推进到“能像通话一样交互”。
综合 2025–2026 入门教学里常提的功能，方便你对照自己账号（有的要付费或地区开放）：
功能名以 OpenAI 当前界面为准；没有某个按钮不代表你“用错了”，可能是套餐或地区差异。
不必背新闻，按“和你有什么关系”扫一眼即可：
想跟踪变化：优先看各公司官网博客与产品内“新功能”说明（OpenAI、Google、Anthropic、国内大厂帮助中心），而不是二手“首发解读”里的夸张标题。
十一
网页对话只是入口。同一类模型还可以出现在：办公套件里的侧边栏、编程编辑器插件、能调用浏览器或文件的会分步的助手、以及命令行里的编程助手。能力变强时，误操作成本也上升——那是进阶话题。
若你已经理解本文的主线——历史位置、生成原理、能力边界、官网入口与提问方式——就具备继续阅读“工具、权限与工作流”的基础。本站进阶章节会讨论：为什么在命令行或项目目录里使用 AI 时，需要逐步确认每一次改动。
OpenAI 介绍 ChatGPT 的官方博文；各产品官网的 Help / 帮助中心；中文维基或百科上的 ChatGPT / 聊天背后的文字模型条目（用来对照名词）。产品界面以你打开的官网实时页面为准。
从网页聊天接到命令行
网页里的 AI 主要动文字；装在电脑命令行里的 AI 可能读项目、改文件、跑命令，所以常要你点“允许”。下面用白话认词，再说权限和练习目录。
若还没用过 ChatGPT 一类网页产品，建议先读 （历史、官网、国内产品、实时语音（GPT-Live） 等），再回来。
前面“从零认识 AI”讲的是网页里聊天；这里换成电脑终端 / 命令行（电脑里敲命令的黑窗口）里的 AI 助手。
先记住三点：它可能碰到你硬盘上的文件；重要操作一般要你点允许；用版本记录 可以反悔。
01 · 先认词
不用一次背完。扫一眼，后面遇到再点回来看。更完整的“AI 是什么”在新手导读里。
聊天机器人背后的“会续写文字”的系统。你给上文，它猜下文。它不会自己打开你的硬盘；只有旁边的程序（命令行工具）把文件内容读进来，或你允许它用读取工具，它才“看得到”那些字。
可以把“一次对话能塞进模型的内容”想成有限的工作台：你的提问、它的回答、读进来的文件说明，都会占位子。太长时，更早的内容可能被挤掉，它就“忘了”前面的约定。
不只回你一句话就停，而会想下一步：要不要读某个文件、要不要搜索、要不要跑一条命令，看结果后再继续。你看到“请求执行某某操作”，就是它在问你能不能做这件事。
网页聊天：最适合新手，主要动文字。编辑器里的助手：贴在写代码的软件旁边，改当前文件方便。命令行（黑窗口里敲命令）：在项目文件夹里干活，能力更强，也更需要你盯着。
可以把它想成统一的“转接头”：让助手连上设计稿、本地原型等外部资料。不是一上来就必须装；等你真有需要，再到代码/设计页再看。
技能包：可复用的专项说明书。自动检查：它动手前后帮你拦危险操作（比如禁止乱删）。分包助手：把子任务分给另一个助手去办。名字因产品而异，先有个印象即可。
命令行助手能改文件，是因为它以你的账号权限在跑。隔离范围用来收窄它能碰的目录；弹窗让“写文件、联网、跑命令”先过你这一关。第一次尽量保守：能点拒绝就先拒绝，确认无害再放行。
网页、别人仓库里的说明，有可能“诱导”助手去执行危险操作。原则：密码和访问密钥只放系统安全位置，不要写进聊天和代码库；公司主项目不要第一次就开“全自动随便写”；对陌生说明保持怀疑。
02 · 为什么要点允许
模型本身没有“遥控你电脑”的超能力。是装在你电脑上的命令行工具 程序，在收到模型的请求后，用你的账号权限去读文件、改文件、跑命令。确认框保护的是这些真实动作，不是在考你“信不信这个 AI”。
你用白话下任务例如：“只改 README 里的标题，别动别的。”
模型给出计划或工具请求比如想读取某个文件、想执行一条命令。
命令行工具 按策略问你 / 走隔离范围写文件、出网、跑 shell，常常先弹确认。
真的执行后，把结果塞回对话模型再根据结果继续，或结束。
你检查 改动对比 和命令看它到底改了啥，而不是只看它“说得像不像那么回事”。
第一次请把确认开严一点。只有在你自己建的练习目录、或任务范围极清楚时，再考虑减少弹窗。生产项目、公司主仓库，不要一上来就“全部自动批准”。
如果某次请求你看不懂，默认点拒绝或跳过，然后让它解释“你想干什么、会影响哪些文件”。
# 你可以把它记成五步 你 → 说清楚要改什么 模型 → 计划 / 申请读文件或跑命令 CLI → 沙箱 + 问你批不批准 电脑 → 真的执行，结果回到对话 你 → 看 diff / 日志，决定收不收 # 审的是改动与命令，不是“感觉靠谱”
03 · 选哪个 命令行工具
详细安装步骤在“从这里开始”。这里只帮你建立“大概是谁家的、适合什么人”。都不会用时：挑一个生态你已经有账号的，先打通一次即可。
已经有 ChatGPT 账号 → 可看 Codex CLI。常用 Claude 网页 → Claude Code。有 Google 账号、想少花钱先试 → Gemini CLI（开源，可用 npm/Homebrew 装，以 官方安装页 为准）。想跟 xAI → 认准官方 Grok Build（安装常见为官网 install 脚本，命令 grok；不是第三方乱起名的 grok-cli）。想开源、多模型切换 → OpenCode。
社区里有个好记的比方（不是官方定义）：Claude Code 偏“严谨盖楼”、Gemini CLI 偏“能搜能读的研究员”、Codex 偏“安全执行”。都只装一个先跑通即可。
| 工具 | 小白印象 | 安装入口怎么找（容易过期） |
|---|---|---|
| Codex CLI | OpenAI 生态；和 ChatGPT 账号体系亲近 | OpenAI / Codex 官方文档与安装说明 |
| Claude Code | Anthropic；强调仓库约定、权限确认 | code.claude.com 文档与官方 install |
| Gemini CLI | Google 开源终端代理；文档站点 geminicli.com | 常见：npm i -g @google/gemini-cli 或 brew；以官网为准 |
| Grok Build | xAI 官方终端编码代理 | 常见：macOS/Linux curl … x.ai/cli/install.sh；Windows 用官方 ps1；以 x.ai/cli 为准 |
| OpenCode | 开源多模型；有中文 README | GitHub anomalyco/opencode 的 README / Releases |
安装命令属容易过期 · 核对思路：官网文档日期优先于任何转载教程 · 页面整理 2026-07-27
OpenAI 的终端编程助手。常和 ChatGPT 订阅或 访问密钥 一起用。已经在 OpenAI 生态里的人上手路径短。
Anthropic 的终端助手。强调整个仓库级任务、CLAUDE.md 项目说明、hooks / skills 等扩展。适合愿意写清楚项目约定的人。
Google 的开源终端助手。以官方仓库和入门文档为准；长上下文、外部连接配置是常见话题。
xAI 官方编码助手（终端界面、Shell、网页搜索、无头执行等）。注意：它不是网上某些第三方“grok-cli”项目，装错名字会完全不是一回事。
开源的多提供商助手（可接不同上游模型）。安装、版本以官方 GitHub 为准；费用取决于你接哪家模型。有中文 README，对不想绑死一家厂商的人友好。
资料优先级：OpenAI / Anthropic / Google / xAI 的官方文档；OpenCode 以 anomalyco/opencode 仓库为准。扩展玩法（Open Design 连接、Figma 连接 等）见“构建工作流”。
以 ChatGPT 个人订阅为例
登录账号和付钱的商店不是一回事。下面只讲安卓、苹果、网页三条正规入口；价格以你账户里的官方账单为准。
在哪个商店开通，就回哪个商店取消或改方案。卸载 App 通常不会自动退订。价格因地区和时间常变，本页不写金额。
以 ChatGPT 为例：安卓走 Google Play，苹果走 App Store，网页走 chatgpt.com 账单。OpenAI 登录账号和付钱的 Google / Apple 账号可以不是同一个，记清你当时用的是哪个。
按设备选择入口
订单管理者Google Play。取消后，已付费周期内的功能仍会保留到周期结束。
订单管理者Apple App Store。取消只会停止下一次续费，权益会持续到本次已付费周期结束。
订单管理者chatgpt.com。跨设备使用时，这一入口通常最便于集中查看和管理。
同一个 OpenAI 账号可以在多台设备登录，但 Apple、Google 和网页仍各自管理订单。先分别检查 iOS 订阅、Google Play 订阅和网页账单页，确认目前由谁续费。
取消的目标是关闭下一次续费；当前已付费周期内的功能通常仍可使用。为避免下一期扣款，官方建议在下一个账单日至少 24 小时前完成取消。
先取消原平台的订单，确认不会再续费，再到新入口开通。若已经出现重复扣费，保留订单记录，并按实际扣费平台走对应的退款或支持渠道。
安装 · 登录 · 小范围试一次
只选一个命令行工具，在练习文件夹或练习分支里装和试。先只让它读文件，再小改；用版本记录看改了哪些文件。安装命令以官网为准，本页示例会过期。
资料核对：2026-07-24 · 本页是官方文档的中文摘要；具体命令、登录与权限行为以你打开的官方页面为准。
只选一个工具。用练习文件夹或练习分支，别直接在公司主项目里全自动。安装命令只从官网抄。装完先让它解释一个文件，确认没问题再允许修改。
文中的 git 可以先当成“能看改了什么、能撤”的记录工具；不会用的话，至少把重要文件备份后再试。
Mac · Windows · 命令行工具
下面是官方常见装法对照。命令会变，以各产品官网为准。Mac 用“终端”；Windows 优先用 PowerShell（有的工具也支持 WSL）。不要用来路不明的“一键整合包”。
| 工具 | macOS | Windows | 装完试一句 |
|---|---|---|---|
| Claude Code | curl -fsSL https://claude.ai/install.sh | bash |
PowerShell：irm https://claude.ai/install.ps1 | iex |
claude 登录后提问 |
| Codex CLI | curl -fsSL https://chatgpt.com/codex/install.sh | sh |
PowerShell：irm https://chatgpt.com/codex/install.ps1 | iex |
codex --version |
| Gemini CLI | 需 Node：npm i -g @google/gemini-cli |
先装 Node（nodejs.org）→ PowerShell / CMD：npm i -g @google/gemini-cli | gemini --version |
| Grok Build | curl -fsSL https://x.ai/cli/install.sh | bash | PowerShell：官方 install.ps1（以 x.ai/cli 为准） | grok --version |
| OpenCode | npm i -g opencode-ai |
先装 Node → npm i -g opencode-ai | opencode 或文档里的启动命令 |
核对：2026-07-27 · 安装脚本域名须是官方；执行前看懂在干什么；优先在练习文件夹操作。
Mac · Windows · UI 工具
| 工具 | macOS | Windows | 接到 AI 助手 |
|---|---|---|---|
| Figma | 浏览器 figma.com，或 Mac 桌面 App | 浏览器，或 Windows 桌面 App（官网下载） | Claude：claude plugin install figma@claude-plugins-official；远程端点常见为 https://mcp.figma.com/mcp |
| Open Design | GitHub Releases 的 mac 安装包，或源码 pnpm tools-dev | GitHub Releases 的 Windows 安装包，或源码开发机安装 | 装好后：od mcp / od mcp install claude（或 codex / cursor…） |
更细的简介与步骤见 。
① 很多官方脚本用 PowerShell 跑，不要混用“随便复制的 bat 包”。② 若文档写 WSL，先装“适用于 Linux 的 Windows 子系统”，再在 WSL 终端里装。③ Gemini / 部分 npm 工具需要先装 Node（建议 LTS，从 nodejs.org）。④ 公司电脑可能拦脚本：改用官网安装包或找 IT 开权限。
00 · 开始前准备
苹果或常见 Linux 可以直接用自带终端。Windows 用户优先看该工具文档：有的支持 PowerShell 安装脚本，有的建议 WSL2。如果文档要求安装 Node（运行环境），按它写的版本来，不要混用很多全局包装。
先准备一个可以乱试的文件夹，或用版本记录开一条可丢弃的练习线，再让 AI 有写权限。把“查看改了什么 / 撤掉改动”当成安全带。完全不会版本记录 时，至少做到：只在练习目录操作，重要文件先自己备份一份。
按“如何订阅”里任选一种正规方式开通或登录后，确认手机和电脑登的是同一个账号。
命令行 AI 改文件很快，回退要靠 Git。生产仓首次只读；练习仓用独立分支。密钥、计字单位 与本地配置永远不要进提交。
# 1) 克隆一个可丢弃的练习仓（示例：OpenCode 源码，只读浏览） mkdir -p ~/ai-cli-practice && cd ~/ai-cli-practice git clone --depth 1 https://github.com/anomalyco/opencode.git opencode-src cd opencode-src # 2) 开练习分支——agent 只在这一层改动 git switch -c practice/$(date +%Y%m%d)-first-run git status # 3) 会话前后对照（也要求 agent 按此验收） git status -sb git diff git diff --stat # 4) 一次会话只做一个主题；满意再提交 git add -p git commit -m "practice: describe the one change" # 5) 回退未提交改动 / 整段会话 git restore . # 丢弃工作区（未 stage） git restore --staged . # 取消 stage git switch main && git branch -D practice/… # 整分支放弃 # 6) 已提交但未 push：安全反悔 git revert HEAD # 推荐：可审计 # git reset --hard HEAD~1 # 仅本地、未 push 的练习仓 # 成功：分支还在、diff 可读、密钥未出现在 git log -p
第一次跑失败时
关掉并重开终端，再用产品官方文档确认安装位置与系统要求。不要靠复制陌生的 命令搜索路径 修改命令硬修。
先确认走的是订阅登录还是 API 路径；退出并重新登录。计字单位 只放在本机安全位置，不能贴进仓库或聊天记录。
回到该 命令行工具 的官方安装页，确认支持的运行时版本；更新后重新执行安装，不要混用多份全局包。
检查公司代理、VPN、系统防火墙和项目目录权限。先在练习仓复现；不要为了通过安装临时关闭整机防护。
页面里的 curl | sh 和 irm | iex 仅在确认域名属于官方、理解其用途且处于非生产环境时使用。官方提供包管理器或可下载安装包时，优先采用可检查、可回退的路径。
OpenAI 官方将 Codex CLI 用于在终端中检查代码、编辑文件、运行本地工具和自动化重复工作。进入项目目录后运行 codex，首次按提示登录；/init 可生成 AGENTS.md。执行前后保留 Git 检查点，并按权限提示确认操作。
# === macOS / Linux（终端）=== curl -fsSL https://chatgpt.com/codex/install.sh | sh # 或：npm install -g @openai/codex # 或：brew install --cask codex # === Windows（PowerShell，以官网为准）=== # irm https://chatgpt.com/codex/install.ps1 | iex # 或先装 Node，再：npm install -g @openai/codex codex --version # 进入练习目录启动；首次按提示登录 ChatGPT cd ~/projects/demo-app codex # 只读试跑：先不要改文件 codex "阅读 README，用三句话总结项目；先不要改文件" # 成功：能登录、能读仓库、权限提示能看懂
安装后直接运行 codex 进入交互；用 /init 写项目规则；脚本 / 自动检查流水线 走非交互模式。写文件与跑 shell 前，先确认 sandbox 与批准范围。
codex --version 有输出；一次只读文件的任务结果与仓库一致；查看改了啥（git status） 无意外改动。
Claude Code 的官方入门顺序是安装、登录、在项目目录启动。首次运行 claude 会引导浏览器登录；默认模式会在改文件前请求批准。可用 Shift+Tab 在默认、acceptEdits 和 plan 等模式间切换，先用只读问题了解仓库。
# === macOS / Linux / WSL（终端，官方原生安装推荐）=== curl -fsSL https://claude.ai/install.sh | bash # 或：brew install --cask claude-code # === Windows（PowerShell，官方）=== irm https://claude.ai/install.ps1 | iex # 或：winget install Anthropic.ClaudeCode # CMD 另有 install.cmd，见 code.claude.com/docs/en/setup claude # 首次按提示用浏览器登录 Claude 账号 cd ~/projects/demo-app claude "先阅读 README，给出不超过 3 步的计划，先不改文件" # Shift+Tab 可切换：默认需批准 / 自动改 / 只规划 # 成功：能登录、能概括仓库、知道如何点拒绝
复杂需求先 Plan 再 Build；把反复纠正写进 CLAUDE.md；危险操作靠 hooks 拦截。免费 Claude.ai 计划通常不含 Code，以 Plans 页为准。
claude 可启动；只读任务结果正确；你知道如何拒绝一次 tool 请求。
Gemini CLI 的官方入门顺序是安装、认证、配置、使用。标准安装为 npm install -g @google/gemini-cli；启动 gemini 后通常可用 Google 账号登录。它支持环境变量、命令行参数和设置文件；其他认证方式以 Authentication 页面为准。
# 先装 Node（建议 LTS）：https://nodejs.org # === macOS === npm install -g @google/gemini-cli # 或：brew install gemini-cli # 或临时：npx @google/gemini-cli # === Windows（PowerShell / CMD，先装好 Node）=== npm install -g @google/gemini-cli # 或：npx @google/gemini-cli # 登录：按界面用 Google 账号，或设置 AI Studio 密钥（见官方 Authentication） # macOS/Linux 示例： export GEMINI_API_KEY="YOUR_GEMINI_API_KEY" gemini gemini "用两点解释“一次能装下多少内容”，并列出当前目录文件名" # 成功：能启动、无登录失败、能列目录并回答
模型、主题、外部连接 等写在用户 / 项目配置里；改前先备份。用量额度以及与 Code Assist / AI Studio / Cloud 的结算关系，以 Quotas and Pricing 官方页为准。
全局安装或 npx 均可运行；密钥未出现在仓库；一次工具调用可被你拒绝。
Grok Build 是 xAI 的编码 助手，可在交互式 TUI、无头脚本或支持 ACP 的应用中使用。首次启动 grok 会打开浏览器认证；无浏览器环境可用 XAI_API_KEY。无头任务使用 grok -p。
# === macOS / Linux（终端）=== curl -fsSL https://x.ai/cli/install.sh | bash # === Windows（PowerShell，以 x.ai/cli 当前页为准）=== irm https://x.ai/cli/install.ps1 | iex grok --version cd ~/projects/demo-app grok # 首次：浏览器登录；无浏览器可设 XAI_API_KEY # 无界面试跑（不改文件） grok -p "用五条总结本仓库；不要改任何文件" # 成功：能启动、能登录、试跑有输出
本指南里的“Grok”一律指 Grok Build / grok 命令行工具（xAI 官方）。社区项目 super助手-ai/grok-cli、whitesmith/grok-cli 等仅作对照，不作为官方安装来源。
OpenCode 是开源的终端编码助手。第一次进入项目后，先用 /connect 连接模型提供商，再执行 /init 生成项目级 AGENTS.md。主对话可用 Tab 在 Build 和 Plan 间切换：Build 用来实施；Plan 适合先看方案，因为编辑文件和运行 Bash 默认都会询问。
# === macOS（终端）=== curl -fsSL https://opencode.ai/install | bash # 或：npm i -g opencode-ai@latest # 或：brew install anomalyco/tap/opencode # === Windows === # 先装 Node（nodejs.org LTS），再： npm i -g opencode-ai@latest # 或 scoop / choco install opencode（以 README 为准） opencode --version # 第一次进入练习项目 cd ~/ai-cli-practice/demo-app opencode # 会话里：/connect 选模型提供商；/init 生成 AGENTS.md # Tab 可切换 Build（动手）/ Plan（先方案） opencode run "用三句话说明本仓库是干什么的；不要改文件" # 成功：能启动、能 /connect、Plan 模式不会偷偷改文件
Build 是默认主助手，能使用更多工具；Plan 用来分析和列方案，编辑文件与运行 Bash 默认会询问。内置的 @general、@explore、@scout 可以由主助手调用，也能在消息中点名。第一次改仓库时，先让 Plan 列出涉及文件、风险和验收方式，再明确批准 Build 实施。
在练习分支上开会话；结束后用 查看具体改动（git diff） --stat 验收。不满意就用 还原文件（git restore） .，或直接删掉练习分支。不要让 助手 执行 git push 或 --force。密钥目录与 .env 请写进 .gitignore。
{
"$schema": "https://opencode.ai/config.json",
"permission": {
"edit": "ask",
"bash": {
"*": "ask",
"git status *": "allow",
"git diff *": "allow",
"git push": "deny"
}
},
"agent": {
"review": {
"description": "只读审阅，不修改文件",
"mode": "subagent",
"permission": { "edit": "deny" }
}
}
}
项目根目录的 opencode.jsonc 会覆盖个人偏好中冲突的字段，适合放团队共识；个人模型和界面偏好留在全局配置。更多权限、配置合并与 外部连接 字段，按 Config 和 agents 官方文档核对。
按任务来，不按品牌堆菜单
修 bug、写测试、做审查、接自动化——按常见任务列在下面。设计稿和 Figma 不在这页，去“UI 与设计”。
下面按修 bug、写测试、审查等常见活整理。设计 / Figma 见“UI 与设计”。新手可先打开 01、02。
每日四步
用一句话写清目标、约束与完成标准。例如：“只改登录文案，不动 API”。
先读 AGENTS.md / CLAUDE.md / README，别让工具从零猜项目结构。
一次只做一个可验证的改动：改代码 → 跑测 → 看改动对比 → 再继续。
把反复使用的指令写回约定文件；把踩过的坑记进禁止事项。
外部资料连接 · 写给新手
把 外部连接 想成给 AI 工具加的统一“转接头”：让编程助手连接外部资料或功能（文档源、设计稿、内部 API 说明等）。如果你只是在仓库里读代码、改文件、跑测试，通常不必先装外部连接。设计稿 / Open Design 的接法见“UI 与设计”页。
核对日期：2026-07-24 · 安装命令 / 端点属容易过期
不要一开始就装一长串服务。先在练习项目接入一个和当前任务有关的外部连接，然后只让它读取信息。确认它找对了资料、不会越权后，再考虑写入或全局启用。
你需要让编程助手连接工程相关的外部资料（例如文档源、内部 API 说明）。设计稿 / 原型请到“UI 与设计”页。
你只是想让 命令行工具 解释仓库、改代码或跑测试。先把基础工作流跑通；外部连接 解决不了提示不清或权限乱开的问题。
Open Design、Figma 的简介与安装、从稿到代码 请打开 。 本页下面只保留：可选的 Skills（技能包） 与常见任务怎么做。
可选扩展 · Skills（技能包，不是外部连接）
可以把它想成给助手准备的专项小说明书（常见是 Markdown 文件夹）：例如“怎么按我们项目写提交说明”“怎么做设计检查”。它规定怎么推进任务，本身不会像外部连接那样去读 Figma 或外网服务。
不同工具目录名略有差别，以该工具文档为准。Claude Code 常见做法：把技能文件夹放到用户目录或当前项目的 skills 路径下，重启会话后生效。
# Claude Code 常见位置（以官方文档为准） # 用户级：~/.claude/skills/你的技能名/ # 项目级：项目根/.claude/skills/你的技能名/ # 技能包里通常有 SKILL.md（说明何时用、怎么做） # 装好后新开一次会话，让助手“列出当前可用 skills”
设计 / 原型 →“UI 与设计”页的 Open Design 与 Figma。Skills 规定怎么推进任务，本身不是外部连接。一次只加一种扩展，先确认只读正确再考虑写入。
任务手册 · 代码侧
从 01、02 看起即可。复杂条目里会多写卡点和一段可抄的提示词。
在 30 分钟内建立架构地图，并划出安全改动边界。
可克隆的仓库；只读权限策略；本地能跑基础命令。
任一主编程工具（Claude Code / Codex / Gemini / Grok Build）
仅允许 read / search；拒绝写文件与任意 shell（除非你指定 pnpm test 等）。
人工对照 README；抽查 2 个路径是否存在。
无文件变更则直接结束会话；有误读则指定正确入口文件后重跑。
先定位、再验证、后动刀：用最小 改动对比 修好，并有回归验证。
复现步骤、错误日志切片（不要整本 dump）、失败测试，或录屏的文字版说明。
Claude Code 或 Codex（偏仓库改动）
第一轮禁止写文件；验证 log 贴回后再决定是否开写权限与测试命令。
假说被日志证明或证伪；最终 改动对比 可读；原先失败用例转绿；无无关重构。
只读阶段无变更；编辑后用 还原文件（git restore） / git checkout -- .；保留复现笔记。
线上 500，栈追踪上百行。若把整段日志丢给 AI，它常会凭空猜测并乱改主业务代码，污染 版本状态。
先定位，不改代码：限定只读范围 → 查上游调用链（不猜）→ 给出 2 个假说和验证日志 → 你贴结果后再决定是否改。
强制把 AI 限制在“只读侦探”角色，防止它破坏 版本状态；引导它给出验证手段，而不是直接抛一个可能带坑的 Patch。等日志验证完，再进入“最小改动 + 回归测试”阶段。
做垂直切片的小功能：可演示、可测、可回滚。
用户故事 + 非目标列表；仓库内已有类似模块的路径。
主编程工具 + 可选第二模型做方案对比
手测步骤通过；类型检查 / 测试按项目脚本全绿。
用功能开关，或整 commit revert；删除半成品分支。
为既有行为补测试，不趁机改生产逻辑。
测试框架与命令已知（如 pnpm test）。
新测试失败 → 修复循环结束于全绿；无 快照测试 噪音。
删除测试文件或 restore；生产代码应无变更。
结构更清晰，行为与测试结果不变；每个 commit 都处于可工作状态。
已有测试或可手测清单；明确“不准改”的对外 API；干净工作区（便于失败即 restore）。
Codex / Claude Code；一次只抽一个函数或模块。
大范围移动文件前先看计划；禁止顺手加功能；测试红了必须停并回滚，不许“越补越烂”。
测试全绿；对外 API 签名不变；行为对照表逐项勾选；改动对比 可 代码审查。
单步提取 + 单 commit；失败立刻 git checkout / 还原文件（git restore）；便于 git revert。
拆分 800 行遗留单体（Monolith）时，工具可能一次重写 10 个文件；测试全红，改动对比 也难以审查。
逐步替换旧代码模式（Strangler Fig）配合单次 Commit 验证：一次只抽一个函数 → 原文件保留 re-export 和原签名 → 跑测试 → 通过后停下来检查 改动对比，失败就立刻撤销。
给 AI 设定物理止损线。自动化测试没过就要求放弃，而不是越修越烂；保证每一个 Commit 都处于可工作状态，才敢继续下一步提取。
按严重度列出正确性、安全、可测性风险，而不是重写代码。
任一；可用第二模型交叉验证争议点。
你能根据清单决定“合并 / 打回”；没有空话。
审查本身无写操作；忽略错误建议即可。
用户向的更新说明 + 开发者向的变更要点。
git log / 合并请求 列表；版本号规则。
抽 3 条对照真实 commit；不要发明未发生的功能。
文档文件单独 commit，可独立 revert。
只接一个 外部连接，并确认它能读到正确资料：要么读一个 Figma 画板，要么列出一个 Open Design 项目的原型和变量。
一个真实来源：可访问的 Figma Frame 链接，或本机已有的 Open Design 项目；备份当前 命令行工具 的外部连接 配置。没有这两种资料就跳过本节。
选择你正在使用、且支持目标 外部连接 的命令行工具，例如 Codex 或 Claude Code。第一次不要同时配置多个客户端。
读官方安装说明 → 生成配置片段 → 经你确认后写入当前项目配置 → 试一次只读调用。
配置写到哪里；是否要网页登录；本次连接能读取哪些资料；不要改成全局启用，也不要开写入权限。
Open Design 能列出当前项目资料，或 Figma 能读到指定画板；输出来自正确项目，且没有文件或画布被修改。
恢复 外部连接配置备份；若不再使用，在服务端撤销 Figma 等远程服务的授权；确认 命令行工具 重启后不再显示该 外部连接。
写一份 ≤80 行的 AGENTS.md / CLAUDE.md：可执行、常更新。
新人（或新会话）读完能跑通 check 命令；无过时路径。
规则文件纳入版本管理；错误规则立即删改。
把每周重复操作变成脚本，或 无界面模式 命令行工具 调用。
非交互标志（见各编程工具 文档）；自动检查流水线 密钥注入方式；失败告警。
支持 无界面模式 / ACP 的官方 命令行工具（如 Grok Build、Codex 非交互模式等，以文档为准）
本地与 自动检查流水线 各跑通一次；失败时退出码非 0。
关闭 workflow；撤销密钥；保留人工 checklist。
用最新官方 API / SDK 接通第三方能力；先脚本试水，再移植业务代码，避免污染主路径。
官方最新文档链接或 外部连接；测试用密钥（环境变量）；可跑的 Node（运行环境） / 脚本环境；业务文件路径清单。
Grok Build / Claude Code / Codex；需要联网查文档或 curl 时明确授权。
密钥不进仓库；是否允许出网；业务文件在试水成功前禁止改。
试水脚本创建 session / 拿到预期响应；移植后的业务路径手测通过；无废弃 SDK 方法。
删除 scripts/*-test.ts；业务文件未改则无 restore；密钥轮换若曾泄露。
对接 Stripe / OpenAI / 微信支付等时，模型知识库常给出废弃 SDK 语法，直接写进业务 → 运行 404/401，主逻辑被半成品污染。
补充官方最新文档内容，再用外部连接 或 curl 做最小验证：先确认连通和参数，再接入 controller；SDK 报错时优先对照原始 HTTP API。
极简 scripts/stripe-test.ts 试水，把第三方 SDK 版本兼容问题挡在业务逻辑之外；验证通过再移植，代码审查 边界也更清晰。
资料台账
价格、模型名、用量额度、安装命令标为容易过期；基础概念与教学结构标为较稳定。社区来源不用于证明当前价格。
| 产品 | 主题 | 说明要点 | 资料级别 | 核对日期 | 波动 |
|---|---|---|---|---|---|
| Codex | 安装 | npm i -g @openai/codex 是常见官方路径 | 官方 | 2026-07-23 | 高 |
| Codex | 订阅 | 命令行工具 可能包含在 ChatGPT 计划中；以 Pricing 页为准 | 官方 | 2026-07-23 | 高 |
| Claude | 安装 | curl …/install.sh | bash 是官网入门说明 | 官方 | 2026-07-23 | 高 |
| Claude | 工作流 | CLAUDE.md / hooks / skills 是官方扩展点 | 官方 | 2026-07-23 | 中 |
| Gemini | 安装 | 见 @google/gemini-cli 官方仓库安装说明 | 开源 | 2026-07-23 | 高 |
| Gemini | 用量额度 | 与 Code Assist / AI Studio 的关系需打开官方用量额度页核对 | 官方 | 2026-07-23 | 高 |
| Grok Build | 安装 | x.ai/cli/install.sh；不是第三方 grok-cli | 官方 | 2026-07-23 | 高 |
| Grok Build | 能力 | TUI · Shell · Web 搜索 · 无界面模式 · ACP | 开源 | 2026-07-23 | 中 |
| 通用 | 概念 | 计字单位 / 助手 / sandbox / injection 的教学结构 | 官方 | 2026-07-23 | 低 |
| 通用 | 痛点 | 权限过宽、密钥进库、二手教程过期等常见痛点 | 社区 | 2026-07-23 | 中 |
| OpenCode | 安装 / 简介 | anomalyco/opencode README.zh.md；npm 包 opencode-ai | 开源 | 2026-07-24 | 高 |
| OpenCode | Releases / 源码 | 版本与变更看 GitHub Releases；可用 git clone --depth 1 只读浏览源码 | 开源 | 2026-07-24 | 中 |
| OpenCode | 命名澄清 | opencode-ai/opencode 已归档 → Crush；勿与本指南产品混装 | 社区 | 2026-07-24 | 高 |
| OpenCode | 配置 / 助手 | build / plan（Tab 切换）；配置细节见 opencode.ai/docs 补充 | 官方 | 2026-07-24 | 中 |
| 通用 | 版本记录当安全带 | 练习分支 · status / 改动对比 · restore / revert · 禁 push / force · 密钥不入库 | 社区 | 2026-07-24 | 高 |
| Open Design | 外部连接 · 设计原型 | od mcp / od mcp install <助手> 暴露本地项目 | 开源 | 2026-07-24 | 中 |
| Figma | 外部连接 · 设计稿 | 远程端点 https://mcp.figma.com/mcp；Claude 可用官方插件 | 官方 | 2026-07-24 | 高 |
| Skills | 技能包 | 专项小说明书（如 Claude Code skills 目录）；规定怎么推进任务，不是外部连接 | 官方概念 | 2026-07-27 | 偶尔会变 |
| Figma × OD | 设计还原 · 变量 | 设计变量对齐 → 参数清单 → 命令行工具只改样式变量；见“UI 与设计” | 官方 | 2026-07-27 | 偶尔会变 |
字段完整版还可加：Source URL · Screenshot needed · Tested · OS · Notes。容易过期项建议每次发布前重新打开官方页核对。
设计稿里颜色、圆角要有固定名字；再让编程助手先读后改。修 bug、写测试请去“代码工作流”。
设计变量：给颜色、圆角、间距起的统一名字（Figma 里叫 Variables；代码里常写成 var(--圆角)）。改一处，多处一起变。Figma 官方说明。
转接头（让助手连外部资料）：让 Claude Code / Codex 这类工具直接读到 Figma 画板或本机 Open Design 原型，不用你反复贴截图。Figma 连接 指南。
只读 / 可写：第一次只允许“看设计、列名字”；确认读对了，再允许改代码。写回 Figma 画布是另一档权限，别一上来就开。
01 · 三条路走完就懂
社区和官方反复强调同一点：稿子乱命名，AI 只能猜；变量清楚，设计到代码才稳。
本机 Open Design“项目”列表示意（对话区已打码）。你自己的项目名可能不同。
02 · 两个工具的简介与安装
下面先用白话说是什么，再给怎么装。命令会变，以官网为准；第一次都只读确认。
简介：开源的本机“AI 设计 / 原型”工作台（源码 nexu-io/open-design）。你在里面做网页样子、看预览；再让 Claude Code、Codex 等命令行助手直接读当前项目，少贴截图。
适合：原型已经在 Open Design 里，要对照着改本地代码或样式。
# === 方式 A：桌面安装包（更适合小白）=== # 打开 https://github.com/nexu-io/open-design/releases # macOS：下载 .dmg / 对应包，拖进“应用程序” # Windows：下载安装程序，按向导完成 # === 方式 B：源码开发机（需要 Node ~24 + pnpm）=== # Mac / Windows 终端里（Windows 可用 PowerShell 或 WSL）： git clone https://github.com/nexu-io/open-design.git cd open-design corepack enable pnpm install pnpm tools-dev run web # 浏览器打开终端打印出的本地网址
# 装好 OD 并出现 od 命令后 od mcp od mcp install claude # 或 codex | cursor | … od mcp install --print claude # 只预览配置，不写入 od mcp install --help # 看支持哪些助手
简介：在线设计工具。画按钮、页面、组件；颜色可建成变量。接上官方远程连接后，命令行助手能按画板链接读取组件和变量，再写代码。官方更推荐远程连接（托管地址，常见为 https://mcp.figma.com/mcp）。
适合：设计主要在 Figma 里，要让 AI 对照稿生成/修改界面代码。
# === 1) 安装 Figma（Mac / Windows 相同思路）=== # 浏览器打开 https://www.figma.com 注册/登录即可用 # 或官网下载桌面 App：macOS / Windows 安装包 # === 2) 接到 Claude Code（先装好 claude 命令）=== # Mac 终端 / Windows 终端都能跑（命令相同）： claude plugin install figma@claude-plugins-official # 插件含远程连接 + 常用 Skills；公司可能禁用插件 # 手动远程端点（以 Figma 开发者文档为准） claude mcp add --transport http figma https://mcp.figma.com/mcp # 可选：--scope user 装到用户级 # Codex 示例 codex mcp add figma --url https://mcp.figma.com/mcp # === 3) 第一次只用只读 === # 复制画板链接后问：列出组件和颜色名，不要修改 Figma
03 · 照着做
和“代码工作流”同一套折叠手册。截图来自本机 Open Design（对话已打码）。
图层名、组件名和代码里的名字对得上；颜色/圆角用统一名字，不要一处一个色值。
能打开 Open Design 项目，或能打开对应 Figma 文件；知道哪个是“主按钮”“卡片”这类组件。
别留“矩形 4821”这种默认名。悬停、按下可以做成组件的不同状态，而不是复制一堆几乎一样的框。
你能指着设计说“这个名字在代码里也叫这个”；改一个颜色名，相关地方应对得上。
左侧是对话与产出文件，右侧是预览。你只要认准：文件能点开、预览就是当前稿。
拿到一份“机器能读”的参数：组件叫什么、有哪些颜色名、圆角多大、里面有哪些子块。比只丢一张 PNG 清楚得多。
Figma 开发模式看属性；或让已连接的 AI 工具只读当前画板 / Open Design 当前页。
优先抄“变量名”，不要抄写死的色值和像素。第一次会话务必只读、不改文件。
你手里有一份清单（或 AI 列出来的列表），能对照设计稿勾选：名字对不对、有没有漏图层。
在文件列表点开 HTML 后，右侧就是当前页。接连接后可先让助手“只列页面名和颜色名”。
{
"组件": "卡片",
"颜色": {
"背景": "var(--页面背景)",
"圆角": "var(--大圆角)"
},
"里面有": ["标题", "说明", "按钮"]
}
真实项目里名字可以是英文；关键是设计与代码用同一套名字，不要一处中文一处乱码。
让 AI 按参数表改 CSS（或样式文件）：绑定变量、补齐悬停状态；不要重写整页结构。
先让它出计划，你点头后再改。深色卡片要用自己的文字颜色，别沿用浅色页的黑字。
看起来和稿接近；git 里只动了约定好的样式文件；没有密钥、无关文件。
用 还原文件（git restore） 还原样式文件；断开或关掉“可写”权限，回到只读。