Codex 国内使用保姆级教程:三种接入方案详解 ✍ 苍何🕐 2026-05-30📦 12.0 KB 🟢 已读 𝕏 文章列表 本文详细介绍了 Codex 在国内网络环境下的三种接入方案。作者对比了手动配置 config.toml、使用 Codex++ 图形化管理工具、以及部署 CCX + CC Switch 网关三种方法的优缺点,并提供了具体的配置步骤、环境变量设置及常见排错技巧,旨在帮助用户解决无法充值 Plus 或登录官方账号的痛点,实现 Codex 的流畅使用。 Codex教程API代理配置CCXCodex++OpenAI模型中转技术实战 # 【保姆级教程】Codex 国内也能畅快用,亲测有效 **作者**: 苍何 **日期**: 2026-05-29T15:04:15.000Z **来源**: [https://x.com/canghe/status/2060376680896799094](https://x.com/canghe/status/2060376680896799094) ---  大家好,我是苍何。 前天 CodexGuide 上线后,后台直接炸了。  问得最多的一个问题就是:国内怎么用 Codex?能不能不充 Plus? 说实话,我理解这个痛。 充值 Plus 本身就有门槛,还得搞定支付方式,折腾半天人都麻了。 所以我花了两天时间,把网上能找到的方案全试了一遍,踩了不少坑,最终总结出三种最靠谱的接入方法。 今天一次性分享给你,照着做就行。 > 教程也同步上线 CodexGuide 了,随时可以查阅。  > 看在这么努力肝的份上,star 走起,哈哈哈。  先说个前提,Codex 默认最稳的用法还是官方 GPT 账号登录。 接第三方 API 属于进阶操作,你得知道 config.toml、API Key、Base URL 这些东西是啥。 不懂也没关系,跟着下面一步步来就行。 # 三种方案怎么选 先给你一张表,对号入座: 方案 适合谁 优点 需要注意 手动配置 想理解底层原理的人 透明、可控、方便排障 要自己维护 config.toml,写错就不生效 Codex++ 用桌面 App,想图形化管理的人 有管理界面,配置一键写入 第三方工具,Codex 更新后可能需要适配 CCX + CC Switch 有多个供应商、需要协议转换的人 网关路由 + 一键切换供应商 组件多,需要理解端口和代理链路 讲真的,如果你是小白,直接看方案二就行,最省心。 如果你刚开始学 Codex,建议先看看我之前的 Codex 入门教程,再回来折腾第三方 API。 # 方案一:手动配置 这种方式有个缺点,没办法用 Codex APP 的插件功能。 想用插件的直接跳到方案二。  手动配置的核心就是改一个文件: ``` ~/.codex/config.toml ``` 改之前,先备份,养成好习惯: ``` ● ● ● cp ~/.codex/config.toml ~/.codex/config.toml.backup cp ~/.codex/auth.json ~/.codex/auth.json.backup ```  ## 两类登录思路 思路 怎么理解 适合场景 GPT 登录 保留官方登录态,只改请求转发地址 想保留官方账号能力,同时用中转 API Key 登录 用环境变量里的 Key,直接请求第三方 用 OpenAI API Key 或自建兼容服务 一个建议:别一次改太多东西。先只加一个 provider,跑通了再折腾多套配置。  ## GPT 登录态示例 也就是说,你的 Codex 得先登录 GPT 账号。 第一步,改配置文件: 打开 ~/.codex/config.toml,加入下面的配置。 注意,字段和值要按你实际的服务来填: ``` ● ● ● model = "gpt-5-codex" #这里填你想要的模型 model_reasoning_effort = "high" disable_response_storage = true preferred_auth_method = "apikey" [model_providers.ciyuan] name = "ciyuan" # 填你的模型提供商名字或者中转站名字,这里以词元为例 base_url = "https://ciyuan.today/v1" # 填你的模型提供商的请求 URL wire_api = "responses" # 这里不要变 env_key = "OPENAI_API_KEY" # 这里将会通过环境变量的方式注入并启动Codex APP requires_openai_auth = false ``` 几个容易踩坑的点: - model_provider 要和 [model_providers.xxx] 里的 xxx 完全一致,差一个字母都不行。 - base_url 只写到 /v1,千万别把 /v1/responses 整段写进去。 - wire_api = "responses" 表示用 Responses API 形态请求,别改。 - requires_openai_auth = false 表示不走官方登录态。  第二步,设置环境变量 打开终端,输入: ``` export OPENAI_API_KEY="这里填你的key" ```  第三步,从终端启动 Codex APP 这里有个坑,Mac 用户必须从终端启动,直接点图标可能读不到模型。 启动前先彻底关掉 Codex APP,然后终端输入: ``` open -a Codex ``` 第四步,验证效果 打开 Codex APP,你就能看到模型已经切换成功了:  好家伙,直接起飞。 ## API Key 登录示例 如果你用的是 API Key 方式,记住一个原则:密钥放环境变量里,别写死在配置文件。 ``` export OPENAI_API_KEY="sk-your-api-key" ``` 对应的 config.toml 配置: ``` ● ● ● model = "gpt-5.1-codex-max" model_provider = "my-api-provider" [model_providers.my-api-provider] name = "My API Provider" base_url = "https://example.com/v1" wire_api = "responses" env_key = "OPENAI_API_KEY" requires_openai_auth = false ``` 有一点要注意:如果你的上游只支持 Chat Completions,不支持 Responses API,光改配置是搞不定的,得用 CCX 这类网关做协议转换,后面方案三会讲。 修改鉴权文件 打开 ~/.codex/auth.json,把 OPENAI_API_KEY 改成你模型服务商的 Key:  ## 怎么验证配置成功 配完之后别急,先验证一下: 1. 完全退出 Codex,重新打开。 2. 让它执行一个只读任务,比如总结当前目录结构。 3. 如果报错,先检查 model_provider 名称、base_url、环境变量这几个地方。 4. 出现认证错误,先切回备份配置,别慌。 # 方案二:Codex++ 如果你觉得手动改配置太折腾,Codex++ 了解一下。 它是一个图形化的管理工具,帮你一键搞定中转配置,不用手写 toml 文件。 而且,它支持插件功能,这是方案一做不到的。  适合这些人: - 主要用 Codex 桌面 App 的。 - 不想手写配置文件的。 - 想随时切回官方模式的。 ## 安装步骤 1. 打开 Codex++ Releases,下载安装包。  你会看到两个安装包:「Codex++ 管理工具」和「Codex++ app」,都要装。  1. 安装后打开「Codex++ 管理工具」。 首次打开如果弹这个错误,别慌:  去「系统设置」-「隐私与安全性」,点「仍要打开」就行:  打开后进入管理界面:  同样的方式装好 Codex++ app,管理工具检测全绿就对了:  确认检测到 GPT 登录状态。 1. 添加中转配置。 选「供应商配置」- 添加供应商,填写你的 Base URL 和 Key。 注意,接入方式选「纯API」:  模型列表可以从上游自动获取,如果你配的是中转站,这里能选的模型就很多了:  本质上这个工具就是帮你更方便地写入配置,省得手动改文件:  保存后测试一下联通情况,没问题就直接用:  1. 从 Codex++ 入口启动 Codex。 注意,要从 Codex++ 启动,不是原版 Codex:  重启后,你就能看到 Codex 已经用上了自定义的模型供应商,可选模型一下子多了起来:  插件也能直接用了,这才是完整体验:  你还别说,这个方案是我目前用下来最丝滑的,强烈推荐。 ## 如果想回滚怎么办 - 在管理工具里清除 API 模式,切回官方配置就行。 - 如果 Codex 更新后 Codex++ 不好使了,等它适配就行,不影响原版使用。 # 方案三:CCX + CC Switch 这个方案适合重度玩家,把「网关」和「切换工具」拆开了: - CCX:API 代理网关,负责协议转换和路由。支持 Claude、OpenAI、Codex、Gemini 等多种入口。 - CC Switch:桌面管理工具,一键切换不同供应商配置。  什么时候用这个方案?你有多个国产模型 API、多个中转服务、多个 Key,或者上游只支持 Chat Completions 需要转换成 Responses API 的时候。 ## 第 1 步:部署 CCX 用 Docker 一行命令搞定: ``` ● ● ● docker run -d \ --name ccx \ -p 3000:3000 \ -e PROXY_ACCESS_KEY=your-proxy-access-key \ -e APP_UI_LANGUAGE=zh-CN \ -v $(pwd)/.config:/app/.config \ crpi-i19l8zl0ugidq97v.cn-hangzhou.personal.cr.aliyuncs.com/bene/ccx:latest ``` 启动后浏览器打就能看到了。 ## 第 2 步:添加上游渠道 在 CCX 管理界面里添加你的渠道: 1. 选择上游服务类型。 2. 填 API Key 和 Base URL。 3. 配置模型映射和路由规则。 4. 用自带的测试功能确认能通。 这里有个关键点:Codex 需要 Responses API 入口。如果上游只有 Chat Completions,CCX 会帮你做协议转换,这也是用它的核心原因。 ## 第 3 步:安装 CC Switch 命令行安装: ``` npm install -g cc-switch ``` 初始化: ``` cc-switch init ``` 初始化时填入 CCX 的地址作为中转入口。 ## 第 4 步:切换配置并启动 一行命令切换供应商: ``` cc-switch use <配置名> ``` 然后重启 Codex 就生效了。 切换后建议打开 ~/.codex/config.toml 核对一下: - model_provider 是不是你刚选的。 - base_url 是不是指向 CCX。 - Key 有没有不小心写进公开仓库(这个很重要)。 # 常见踩坑汇总 最后放一张排错表,遇到问题先对照看: 现象 先检查什么 切换后没生效 是否完全重启了 Codex,model_provider 名称是否一致 报认证错误 API Key 是否有效,环境变量是否被当前 shell 继承 报接口路径错误 base_url 是否只写到 /v1,别重复拼 /responses 国产模型无响应 上游是否支持 Responses API,不支持就得用 CCX 转换 插件配置不见了 切换工具是否覆盖了配置,有没有提前备份 说实话,三种方案我都跑通了,日常用的最多的还是方案二 Codex++,省心。 如果你是那种手里有好几个 Key、好几个供应商的重度用户,方案三更适合你。 好了,今天的分享就到这里。 如果这篇教程帮到你了,点个赞让我知道,我后续会继续更新更多 Codex 的实战玩法。 有问题直接评论区问,我看到都会回。 ## 相关链接 - [@canghe](https://x.com/canghe) - [2.8K](https://x.com/canghe/status/2060376680896799094/analytics) - [Upgrade to Premium](https://x.com/i/premium_sign_up) - [11:04 PM · May 29, 2026](https://x.com/canghe/status/2060376680896799094) - [2,831 Views](https://x.com/canghe/status/2060376680896799094/analytics) - [View quotes](https://x.com/canghe/status/2060376680896799094/quotes) --- *导出时间: 2026/5/30 00:15:41*
C Codex 接入 DeepSeek Chat API:CC Switch 本地路由攻略 本文介绍了如何使用 CC Switch 本地路由将 DeepSeek 等兼容 OpenAI Chat Completions 协议的 API 接入 Codex CLI。文章详细解释了本地路由的原理,即将 Codex 的 Responses API 请求转换为 Chat Completions 请求并转发,同时提供了添加 DeepSeek 供应商、开启路由及排查 404 等常见问题的具体操作步骤。 技术 › Codex ✍ Jason Young🕐 2026-05-31 CodexDeepSeekAPICC Switch路由配置OpenAI教程工具与效率Chat API
保 保姆级教程:ChatGPT 官方 Codex 怎么用? 鉴于 Claude Code 账号封禁风险高,本文推荐已拥有 ChatGPT 付费会员的用户尝试官方 Codex。文章详细介绍了 Codex 的适用人群、三种安装方式(CLI、桌面版、插件版),以及三种登录接入方法(官方登录、CC Switch、配置文件)。此外,还涵盖了 Node.js 环境配置、中转站设置、常见报错排查等实操细节。 技术 › Codex ✍ 一🕐 2026-04-30 CodexOpenAIChatGPTCLI教程中转站AI编程配置IDE插件
零 零基础构建私人GPT代理池与中转站指南 本文介绍了一种利用 Codex 快速构建本地 GPT 代理池的方法。通过本地部署 CLIProxyAPI 服务,用户可以实现多账号的集中调度与管理,解决单一账号限制问题。文章详细讲解了环境部署、设备码授权、账号绑定及前端配置的全流程,即使是零基础用户也能在几分钟内完成,并提供了常见报错的排查方案。 技术 › 工具与效率 ✍ 烁皓🕐 2026-04-18 Codex代理池APIOpenAI本地部署教程账号管理CLIProxyAPI
开 开源月入10w+的Codex使用方法(超详细教学) 本文详细介绍了OpenAI推出的AI编程Agent Codex的使用方法,包括其与ChatGPT的区别、注册订阅流程、Web/桌面/CLI/IDE四种安装方式,以及桌面App的页面功能全解,帮助非程序员利用AI提升效率。 技术 › Codex ✍ 产品经理老王霸🕐 2026-07-23 AI编程OpenAICodex教程效率工具Agent
C Codex 史诗级更新的最全面解析 文章详细解析了 OpenAI Codex 的史诗级更新,重点介绍了新增的“Work”区域与 Codex 的区别,以及 sites、Template Creator 等新插件的实测效果。此外,还涵盖了内置浏览器功能升级、前端设计能力的提升、支持多 Agent 并行执行的 Ultra 模式,以及如何将 GPT 网页端聊天接入 Codex 进行头脑风暴的实用技巧。 技术 › Codex ✍ Sac🕐 2026-07-11 CodexOpenAI更新解析Work模式插件前端设计多Agent教程
C Codex 终极使用教程:接入 Kimi 与 Skill 自动化指南 本文是一份针对小白的 Codex 终极使用教程。文章首先指出了 Codex 在多模态和办公场景(如生成 PPT)相较于 DeepSeek V4 的优势,详细介绍了如何通过 CC Switch 工具将性价比高且原生支持多模态的 Kimi 模型接入 Codex。此外,作者还分享了通过 Skill 功能将工作流程固化并设置定时任务的实战案例,旨在帮助用户将重复性工作自动化,极大提升职场效率。 技术 › Codex ✍ 小盖🕐 2026-07-03 CodexKimiOpenAI教程自动化Skill效率工具多模态办公实战CCSwitch
全 全网 Codex Skill 指南:精选资源与安装教程 本文系统梳理了 Codex 的 Skill 生态,指出安装核心 Skill(如 create-plan、gh-fix-ci)是将其从聊天机器人升级为工程团队的关键。文章汇总了必 Star 的官方与社区仓库,按场景(规划、CI/CD、测试、前端等)分类精选了神级 Skill,并提供了保姆级的安装与调用教程,最后分享了自定义 Skill 及进阶组合玩法,帮助开发者最大化利用 AI 编程工具。 技术 › Codex ✍ AYi🕐 2026-06-17 CodexOpenAIAIEngineeringSkill教程DevOpsCI/CD自动化工具效率编程助手
C CODEX 高效工作指南:给小白用户的实用入门课 这是一份面向小用户的 Codex(OpenAI coding agent)入门指南。文章指出 Codex 不是单纯的聊天机器人,而是能读写文件、运行命令的“工作搭档”。作者通过对比 ChatGPT,明确了 Codex 的适用场景,并介绍了 App、CLI、IDE 插件等多种入口。核心内容包含四段式提示词模板、常用工作流(解释项目、修 Bug、加功能、审代码)、配置文件 AGENTS.md 的编写方法,以及 MCP、Skills 和 Automations 的区别与用法。最后强调了安全使用原则及新手从只读理解到自动化的进阶路线。 技术 › Codex ✍ Mr Panda🕐 2026-06-12 AI编程CodexOpenAIAgent教程工作流自动化最佳实践提示词AGENTS.md
全 全网 Codex Skill 指南:精选、安装与进阶玩法 文章指出 Skill 是将 Codex 从聊天机器人转化为高效工程师团队的关键。作者整理了核心资源仓库、按场景分类的神级 Skill(如 create-plan、gh-fix-ci),并提供了保姆级安装教程与进阶组合技,帮助用户通过标准化的 SOP 提升开发效能。 技术 › Codex ✍ AYi🕐 2026-06-07 CodexSkillOpenAIAIagent工程化DevOps教程资源整理
使 使用 CC Switch 解锁 Codex 第三方 API 远程操作能力 本文介绍了 CC Switch v3.16.1 版本新增的“Codex 应用增强”功能。该功能通过将第三方 API 信息写入 config.toml 而非覆盖 auth.json,解决了用户在使用 DeepSeek 等第三方模型时,无法保留 Codex 官方远程操作和插件能力的痛点。文章详细讲解了开启本地路由、配置 DeepSeek 等供应商的具体步骤及原理。 技术 › Codex ✍ Jason Young🕐 2026-06-02 CC SwitchCodexDeepSeek本地路由教程第三方APIOpenAI配置指南
C CC Switch 完整配置教程:一键给 Codex 接入 DeepSeek 本教程详细介绍了如何使用开源工具 CC Switch 将 DeepSeek 接入 Codex 或 Cursor。文章包含两步配置指南:开启本地路由以支持 DeepSeek 的特殊接口格式,以及填入官方或第三方 API Key。文中特别强调了重启客户端的必要性,以实现模型的后端替换。 技术 › 工具与效率 ✍ 荒野饲养员🕐 2026-05-31 教程DeepSeekCodexCursorAPI开源工具配置指南
如 如何玩转现在爆火的 Codex ?保姆级教程系列长文来了,人人都能成为 Codex 大神。 本文是 Codex 使用教程系列的开篇,介绍了 Codex 的核心功能,包括自然语言写代码、自动补全、修复 Bug 等,并将其定位为能真正干活的 AI 同事。文章详细讲解了在 Windows 和 macOS 系统上下载、安装及登录 Codex 桌面端的步骤,以及订阅 Plus 会员的方法和注意事项,旨在帮助用户从入门到精通。 技术 › Codex ✍ 聪哥.sats🕐 2026-05-30 Codex教程安装OpenAIAI编程ChatGPTPlus订阅效率工具