当前位置：首页 > news >正文

连夜停掉 Claude！丢个需求让 AI 自己动：Codex 国内直连全自动部署指南

news 2026/5/22 1:57:57

一、3种使用方法该怎么选？

① 桌面 App（强烈推荐，体验最好）

② VS Code 插件（老油条专属）

③ Codex CLI 命令行

第一步：安装环境

第二步：检查环境

第三步：安装 Codex CLI

第四步：见证奇迹

二、配置 API 中转服务

第一步：下载配置工具 CC Switch

第二步：获取API秘钥

第三步：在 CC Switch 中填写配置并连接

三、上手前必须搞懂底层设置

设置 1：搞清两种“对话模式”的区别

设置 2：三种权限控制

设置 3：根据任务切换“智能等级”

四、Vibe Coding 实战

第 1 步：创建项目文件夹

第 2 步：创建 AGENTS.md

第 3 步：整理 PRD 文档

第 4 步：开启计划模式

第 5 步：多窗口并行操作

第 6 步：用浏览器注释功能微调页面细节

第 7 步：随时引导纠偏，别等它跑完再说

第 8 步：Git 存档与版本回退

尾声：让技术回归实用

最近这一个月，我几乎把所有的开发工作流都切到了 OpenAI 的 Codex 上。

不是因为赶时髦，而是它确实解决了一个困扰我很长时间的问题。以前咱们怎么用 AI 写代码？在网页里问一句，它吐出一堆代码。我们再手动复制，贴进编辑器，运行报错，然后再复制报错信息问它……这种感觉，AI更像是一个被动回答问题的助手。

Codex 完全变了。你可以直接丢给它一个需求文档（甚至也可以让它写一份PRD），它就能自己在你的电脑里新建文件夹、写代码、甚至帮你跑终端命令调 Bug。你甚至可以让它打开浏览器，看看代码写出来的效果对不对。用过这种全自动的流程，你就不想再回去搞那套繁琐的“复制粘贴”了。

但国内的朋友用起来，最大的坎儿其实就两个：一个是网络不稳定，老断线；另一个是官方限制了 Token 的额度，稍微跑个稍微复杂点的项目，动不动就因为额度超限报错，特别扫兴。

我今天写这篇文章，就是想把这一套我在一线实操的配置方法彻底公开。最关键的是，我会教你怎么配置第三方的API接口，一键解决官方的网络和额度限制，在国内跑满 Codex 的最强算力。

别管有没有技术基础，看完这篇，你也能让 AI Agent 真正动起来。

我们直接进实操。

顺便聊聊：和前阵子大火的 Claude Code 相比呢？

懂行的老玩家看到这，肯定会抛出一个问题：既然都是本地代码 Agent，它跟 Claude Code 比到底赢在哪？这两个工具我最近都在高强度交叉测试。不扯什么底层技术，就从咱们国内用户最关心的“体验”和“钱包”这两个维度，掏点心窝子的话。

1、对小白极其友好，没有“程序员门槛”：Claude Code 说白了还是个极客玩具，得在终端命令行里敲代码调优，没点编程基础上手挺费劲。但 Codex 直接降维打击，给小白做了一个桌面端的 App。一键安装，打开就能用，没有任何心智负担。

2、告别提心吊胆，不折腾“封号”：用 Claude 是什么环境，大家心里都有数。风控严得离谱，动不动就来一波大规模封号。很多朋友辛辛苦苦配好的环境、存的上下文，一觉醒来号没了，非常搞心态。相比之下，Codex 对国内用户友好太多，跑起来踏实。

3、核心痛点：使用成本直接打骨折：这是最核心的一点。Claude 虽然代码能力强，但它的 API 费用是真的贵。给大家交个底，看我们自己平台的后台数据就知道：跑一个完整的真实项目，用 Claude 随便过几个复杂的联动功能，上百块钱的额度刷一下就烧没了，看着都肉疼。

但换成 Codex（切到最新的 GPT-5.5 模型），干完一模一样的活儿，算下来也就消耗个几十块钱。

不封号，门槛低，成本还直接砍掉一大半。这笔账算清楚了，你就知道为什么现在大家都在连夜把工作流往 Codex 上搬了。

一、3种使用方法该怎么选？

在大家无脑下载之前，先同步一个极其重要的信息差：千万别去网页端找 Codex 了。

经过最新一轮更新，OpenAI 已经把网页端完全留给了普通的 ChatGPT。现在的 Codex，已经彻底进化成了一个“本地化”的硬核工具，只有三种形态：桌面 App、VS Code 插件、命令行 CLI。

在你动手安装前，咱们得先理清一个核心逻辑。你是走官方通道，还是走咱们 Lino API 的直连通道？这两条路的玩法有讲究。

如果你选“官方通道”：只要你的网络足够稳，这三种方式你随便挑，账号登录进去就能用。

如果你选“Lino API 直连通道”（墙裂推荐）：国内环境想稳稳当当跑满算力，这是最优解。这里的核心秘籍是：你必须先从 Codex CLI（命令行）入手。只要你在 CLI 的底层配置里，把接口替换成了咱们 Lino API 的地址，那么你的桌面 App和VS Code 插件就会自动“继承”这个配置，全部走咱们的高速直连通道。

理清了逻辑，接下来咱们手把手实操，三种方式的安装教程全在这里，大家对号入座：

① 桌面 App（强烈推荐，体验最好）

适合人群：所有人，尤其是小白。界面最清爽，不需要懂任何代码逻辑。

怎么用：去官网下载对应系统的安装包：https://chatgpt.com/zh-Hans-CN/codex/

Mac 用户：看清楚自己的电脑是 Apple Silicon（M系列芯片）还是 Intel 芯片，别下错了。

Windows 用户：直接下载 Windows 安装包，一键傻瓜式安装。

② VS Code 插件（老油条专属）

适合人群：本身就是程序员，或者已经习惯在 VS Code 里折腾代码的朋友。怎么用：

打开 VS Code 的扩展商店（左侧边栏的方块图标）。搜索codex。认准 OpenAI 官方发布的那个插件，点击安装（这边我已经提前安装了）。装完后它会无缝融入你的编辑器，写代码时随时召唤。

③ Codex CLI 命令行

适合人群：极客、开发者，以及所有想用 Lino API 绕过官方网络和额度限制的国内玩家。别一听“命令行”就觉得头大，不用你写代码，跟着我敲几行字，三分钟就能打通底层经脉。

第一步：安装环境

这是运行 CLI 的地基。打开 Node.js 官网（nodejs.org），下载页面上标注了LTS（长期维护版）的那个安装包。下载后一路点“下一步”完成安装。

如果还是不懂可以看看我的超详细教程：【2026 最新版】Node.js安装及环境配置超详细教程（以win11为例子）

第二步：检查环境

打开你电脑的终端（Mac 按Command+空格搜“终端”或 Terminal，Windows 搜 PowerShell 或 Windows Terminal）。输入这行指令：node -v如果看到类似v24.13.0这样的版本号，说明装好了。再输入：npm -v也有版本号弹出的话，稳了，进入下一步。

第三步：安装 Codex CLI

在终端里输入这行魔法口令（原封不动复制进去回车）：npm i -g @openai/codex这行代码的意思是，用 npm 在你的电脑全局安装 OpenAI 的 Codex。稍微等个几秒，进度条跑完就搞定了。

第四步：见证奇迹

在终端里输入：codex如果你能进入 Codex 的命令行界面，恭喜你，底层环境彻底打通！

(注：新手第一次用，它会让你登录账号或输 API key，先别急，看完下面咱们用工具一键搞定。)

补充个后期维护小技巧：如果以后想更新到最新版的 Codex CLI，只需在终端运行npm i -g @openai/codextest即可。

二、配置 API 中转服务

环境装好之后，怎么让 Codex 放弃官方那条又卡又有额度限制的通道，改走咱们国内的高速直连通道？

先说原理，其实很简单。Codex 本身是在你电脑本地运行的，它底层的核心配置文件只有两个（auth.json和config.toml）。我们只需要把里面的官方 API 地址和密钥，替换成咱们中转站的地址和密钥，它就会自动改道。

之前写过一篇详细的配置教程可以去看看👉：【2026 最新版】OpenAI 祭出王炸 GPT-5.3-Codex！Win11 + VSCode 部署保姆级教程

但如果让你去系统深处翻找这两个文件手动修改，不仅麻烦，还容易改错。

为了省心，我推荐大家用一个叫CC Switch的开源小工具。它可以帮你一键完成底层的配置替换，点几下鼠标就能搞定。

第一步：下载配置工具 CC Switch

大家直接去 GitHub 仓库里面（https://github.com/farion1231/cc-switch/releases），下载 CC Switch 对应你电脑系统的安装包。下载后直接双击安装就行。

第二步：获取API秘钥

访问https://linoapi.com/控制台页面。
点击控制台 -> API令牌。
点击添加令牌。
注意细节：
1. 令牌分组：建议选择codex专属。
2. 额度：建议设置为无限额度。
复制生成的sk-开头的密钥备用。

第三步：在 CC Switch 中填写配置并连接

工具和密钥都准备好了，接下来就是把它们连起来。只需要简单的三下点击：

打开配置界面：打开刚安装好的 CC Switch，在主界面点击 Codex 图标，然后点击右上角的「➕ 加号」添加新节点。

选择配置方式：在最上方“预设供应商”那一排，点击最左侧蓝色的「自定义配置」。

供应商名称：填LinoAPI。

官网链接：填https://linoapi.com。

API Key：把你刚才在咱们平台后台复制的那串sk-开头的长密钥，直接粘贴到这里。

API 请求地址：填入咱们的专属直连通道https://linoapi.com/v1。

锁定最强算力：在“模型名称”里，毫不犹豫地选gpt-5.5。

一键注入：核对一下没填错，直接点击右下角的「添加」。

(懂行的小伙伴可以看截图最下方，在你填参数的时候，这个工具其实已经自动在帮你生成底层的auth.json和config.toml代码了，极其省心。)

添加完成后，在列表里把它「启用」。

就这么简单三步。现在，你可以彻底关掉并重新打开你的 Codex 桌面 App，或者在终端里重新跑一次codex。当你看到它顺利启动，没有网络报错，那就意味着底层通道已经被咱们成功接管。

接下来，咱们终于可以甩开膀子，看看满血状态的 Codex，到底能玩出什么让人头皮发麻的逆天操作了。

三、上手前必须搞懂底层设置

很多人配好中转 API 之后，就兴奋地直接开聊了。先别急，Codex 毕竟不是普通的网页聊天框，它是能直接操作你电脑文件的 Agent。

在整活之前，花一分钟把下面这三个基础设置盘明白，以后你用任何类似的 AI Agent 工具，逻辑都是通通适用的。

设置 1：搞清两种“对话模式”的区别

打开 Codex 后，你会发现它有两套完全不同的聊天入口：

单次对话（普通的聊天框）：适合“一锤子买卖”的任务。比如你突然想让它帮你写一封英文邮件、做一张海报草稿、或者查一段代码的含义。聊完就走，不需要留存。
项目模式（点击「项目」旁的文件夹图标）：只要是搞开发、做网站，必须用这个模式！在这里，你需要给它指定一个本地的文件夹。Codex 会在这个文件夹里安家，它的记忆（上下文）、写出来的代码、文档全锁在这个格子里，绝对不会跑到外面去乱动你电脑里的其他文件。

设置 2：三种权限控制

这是玩本地 Agent 最容易让人心里打鼓的地方——它要读写我的电脑，安全吗？Codex 给出了三级权限，听我的，按这个来配：

级别一：默认权限（新手首选 🌟）：AI 每改动一个文件、每跑一行终端命令，都会弹窗让你点“批准（Approve）”。虽然手有点累，但胜在绝对安全，能看清它是怎么一步步干活的。
级别二：自动审查（熟练后推荐）：普通读写直接放行，只有遇到删除文件、或者涉及系统敏感操作时才弹窗问你。干活效率最高。
级别三：完全访问权限（⚠️ 极不建议长期开启）：相当于把电脑密码直接给它了。除非你在做一些需要频繁批量改动文件的复杂部署，否则平时千万别开，防一手 AI 抽风误删文件。

设置 3：根据任务切换“智能等级”

虽然咱们接了 Lino API，没有官方那种死板的 5 小时限流了，但大模型的 Token 依然是真金白银。大家看我上面这张截图，在输入框旁边，Codex 把模型智能度分成了四个档位，下面还挂着咱们配好的GPT-5.5旗舰通道。

听我的，干活时千万别盲目全程开到最大，咱们要学会“看菜下碟”：

“低 / 中”档位：适合平时的轻量任务、查资料、写个简单的回复邮件。速度极快，而且便宜到可以忽略不计。
“高”档位（日常主力档 🌟）：应付绝大多数日常编程、修改 Bug、生成文章草稿。这个档位的性价比最高，能兼顾聪明度和响应速度。
“超高”档位（核心突击 ⚔️）：只有到了真正要动工写复杂底层逻辑、或者像后面咱们手搓 3D 网站这种重头戏时，再果断切到最高档，让 GPT-5.5 的最强算力全量输出。

把 AI 当成你的员工，普通杂活让实习生（低/中档）干，核心攻坚再让架构师（超高档）上。好钢用在刀刃上，才能花最少的钱，出最大的活儿。

基础设置都盘明白了，接下来，咱们不玩那些花里胡哨的虚招。今天既然大家配好了 Lino API 的通道，咱们就来玩一个最硬核、也最值回票价的玩法：Vibe Coding（氛围编程）。

不用担心自己没有技术基础，哪怕你连一行代码都没写过。接下来，跟着我用全自动的模式，解决一个我自己最近非常头疼的真实痛点。

说实话，每次过年过节或者家里聚会，面对一屋子的亲戚长辈，我是真的不懂该怎么叫。爸爸的舅舅的女儿该叫啥？妈妈的姐姐的婆婆又是谁？每次都要卡壳。

所以，我准备让 Codex 帮我从零手搓一个“中国亲戚关系称呼计算器”网站。像用计算器一样，点“爸爸”+“的”+“哥哥”，一键就能免费查询正确称呼。最重要的是，最后咱们直接把它部署上线，让所有人都能随时随地在手机上查。

把你的脑洞准备好，我们直接开干。

四、Vibe Coding 实战

第 1 步：创建项目文件夹

在电脑本地新建一个文件夹，命名为relative-calculator。打开 Codex，点击「项目」旁边的文件夹图标，选中刚建好的这个文件夹。

这时候 Codex 会自动在里面初始化项目。记住，在咱们配置的“自动审查”模式下，它只有这个文件夹的权限，绝对不会乱动你电脑里的其他隐私。

第 2 步：创建 AGENTS.md

别一上来就直接提需求。记住，你不需要自己去电脑上右键新建文件，直接在 Codex 的项目对话框里，原封不动地发下面这段话，它自己就会在文件夹里帮你把文件建好：

“请在我的项目根目录下，自动创建一个名为AGENTS.md的文件。这个文件是你的‘行为守则’，以后每次执行任务和回答时，你都必须严格遵守里面的规矩：
1.每次修改代码或运行命令前，都要用通俗的大白话向我解释你要做什么。
2.绝对不能擅自删除或恶意覆盖我现有的任何文件。
3.如果遇到代码冲突，必须保留备份并提示我。”

这一步千万不能省。让 Codex 自己把这个“紧箍咒”写进本地文件里，后面它每轮对话都会死死遵守，能完美避免它在后续开发时自作聪明地乱删或者覆盖掉你的核心代码。

第 3 步：整理 PRD 文档

不要直接跟 AI 口头说“帮我做个亲戚计算器”，需求太模糊，它会边写边猜。

咱们同样不需要自己新建文件，直接让它客串产品经理，把功能逻辑整理好，并直接在本地生成一个叫PRD.md的实体文档存起来。

在对话框里复制发送这段提示词：

“你现在是我的产品经理。请在我的项目根目录下，自动创建一个名为PRD.md的文件，并在里面写一份关于‘亲戚称呼计算器’第一版 MVP 的需求文档。
核心功能很简单：
1.主界面：要像手机计算器一样，有‘爸爸’、‘妈妈’、‘哥哥’、‘姐姐’等基础关系按钮，以及‘的’和‘=’号。
2.关系链显示：用户点击按钮后，上方要实时显示关系链（比如：爸爸的妈妈的哥哥）。
3.结果输出：点击‘=’号，下方直接给出最终的正确称呼（比如：舅公）。
4.反向查询：还要有一个切换按钮，支持输入称呼（比如：舅公），反查他是我的谁。
请在PRD.md里帮我把页面布局设计和开发顺序用大白话整理出来，不要扯任何看不懂的技术名词。”

发送过去后，Codex 就会在你的左侧文件树里自动刷出一个PRD.md。

你可以双击打开这个文件看一眼，如果有不满意的地方（比如想加个“清空”按钮），直接在对话框里对它说：“把PRD.md里的界面设计改一下，加上一个清空按钮。”它就会自动去修改这个文件，直到你满意为止。

这样，咱们接下来的所有开发，就都有据可查了。

第 4 步：开启计划模式

需求定好后，进入真正的开发阶段。只要任务需要修改或者新建多个文件，就一定要让 Codex 先列出执行计划：

“请根据需求文档，开启计划模式。告诉我你需要新建哪些文件（比如 HTML、CSS、JS），先列出计划，我审核通过你再动手。”

审核计划时，你就看一眼它有没有漏掉你想要的功能，没问题就点「继续（Continue）」，让它自己跑起来。

第 5 步：多窗口并行操作

在写代码的过程中，记住一个大窍门：一个对话窗口只聊一件事。

编写前端计算器界面和样式 $$\rightarro$$ 在窗口 A 搞定。
编写底层的关系换算逻辑（JS） $$\rightarro$$ 另开一个窗口 B。

这样每个窗口的上下文更精准，AI 干活更专注。如果聊着聊着发现右下角的 Token 记忆快满了，直接在输入框打个/选择“压缩”，它就会把前面的内容缩减成摘要，既不会忘掉之前的设定，又腾出了新空间。

第 6 步：用浏览器注释功能微调页面细节

代码写完后，Codex 会在右侧弹出一个内置的浏览器预览页面。这时候，小白最爽的功能来了：你觉得哪个按钮太小了、或者配色太土，直接在预览页面上点击那个不好看的地方，添加注释。比如点击背景，写上：“我觉得这个背景色不好看，换一个绿色的。”，它就会精准定位到那几行代码去修改，比你凭空描述“第 3 个按钮改一下”要精准得多。

第 7 步：随时引导纠偏，别等它跑完再说

AI 干活有时会陷入死循环或者跑偏。一旦你在右侧预览里发现方向不对，不需要等它把大段代码敲完。直接在对话框输入新的修正指令，选择「引导」模式，新指令就会强势介入，立马把方向拉回来。记住，Vibe Coding 的核心不是你懂多少编程，而是需求说得清、跑偏拉得开。具体可在“常规”的“跟进行为”那里进行选择，也可以直接在对话框中输入并发送的。