这一集直接进入 Codex 和 CCSwitch 的基本设置与操作。如果你已经把 Codex 装好但发现默认模型用不惯或者想切到 DeepSeek、通义千问这类国内服务商那么这篇就是为你准备的。这里不重复讲概念只讲能落地的步骤从安装 Codex CLI 开始到下载启动 CCSwitch再到配置模型供应商和验证请求通路最后把常见的报错一次说完。Codex 是 OpenAI 开源的命令行 AI 编程助手工作方式是直接在终端里用自然语言给它派活它能够读取项目文件、修改代码、执行测试命令。CCSwitch 的价值在于让 Codex 的请求先走到一个本地代理再由这个代理转发到你指定的模型服务商这样做的好处是切换模型时不需要改 Codex 自身配置所有供应商信息都在 CCSwitch 里统一管理。从社区反馈看Codex 接入 DeepSeek、通义千问是当前比较主流的两种用法。本文会演示四部分内容第一Codex CLI 的安装与基本启动第二CCSwitch 的下载、启动与本地代理确认第三在 CCSwitch 中添加 DeepSeek 和千问的供应商配置并让 Codex 正常连通第四结合社区里高频出现的 local proxy 报错给出完整的排查思路。建议阅读对象是正在使用或者准备使用 Codex 的开发者尤其是需要对比多模型效果、或者希望把 Codex 接入国内模型 API 的团队。1. 核心能力速览首先给出一张速览表方便你在继续往下读之前快速判断这套工具链适不适合自己。能力项说明项目类型AI 编程助手 本地配置切换/代理工具主要工具Codex CLIOpenAI 开源、CCSwitch社区配置切换工具主要功能终端内代码理解与生成、模型供应商切换、本地代理转发硬件门槛普通开发机即可无独立显卡要求支持平台Windows / macOS / Linux按客户端版本确认启动方式命令行启动 CodexCCSwitch 按发行包启动接口能力Codex 通过本地代理访问模型服务商CCSwitch 提供本地代理服务批量任务可通过 Codex 非交互模式和脚本循环执行模型接入常见为 DeepSeek、通义千问等 OpenAI 兼容接口适合场景日常编码助手、多模型效果对比、团队统一 API 配置这里需要说明一点CCSwitch 本身不需要 GPU它只负责请求转发和配置管理真正消耗算力的是远端模型服务。所以如果你的目标是“在普通笔记本上跑 Codex”主要门槛不是硬件而是网络连通条件和可用的 API Key。Codex 与 CCSwitch 的分工可以简单概括为Codex 是干活的前端CCSwitch 是负责路由的后端调度。两者配合之后的合理工作流是在 Codex 里正常发需求Codex 把请求发给 CCSwitch 的本地地址CCSwitch 再按你在界面上选的供应商把请求发出去拿到结果后原路返回。理解这条链路后后面排查问题会容易很多。2. 适用场景与使用边界2.1 适合谁这套配置比较适合三类人。第一类是长期在终端里写代码的开发者Codex 能让自然语言直接变成代码操作省去反复切换编辑器的时间。第二类是想做模型效果对比的用户通过 CCSwitch 在 DeepSeek 和千问之间切换可以在同一个 Codex 界面里快速比较不同模型对同一问题的回答质量。第三类是团队使用者统一在 CCSwitch 里维护供应商和 Key成员各自只保留一份 Codex 配置比每个人单独配置 API 地址要省事。2.2 不适合的场景需要先明确边界Codex 加 CCSwitch 的组合不适合作为生产环境的高并发代理使用它就是本地开发工具本地代理服务如果暴露到公网既没有鉴权体系也没有限流能力容易产生安全风险。另外如果你所在的网络环境无法直接访问你选择的模型服务商这套方案也不会自动解决网络问题需要先在系统层面确认到目标 API 的连通性。2.3 合规与安全边界这一点要特别提醒。使用 Codex 接入第三方模型服务商时必须确认你使用的 API Key 是自己申请并且符合服务商条款的。不要使用来源不明的中转服务提交代码因为你的代码会以请求方式发送到远端一旦中转方不靠谱项目源代码和商业秘密都可能泄露。公司项目接入前需要确认第三方 API 的数据隐私政策是否允许代码内容外传。另外API Key 不要提交到 Git 仓库不要写进配置文件后随手分享建议通过环境变量注入。3. 环境准备与前置条件3.1 基础环境清单开始安装之前先检查这几项基础环境。检查项建议要求操作系统Windows 10/11、macOS、主流 Linux 发行版Node.js建议使用当前 LTS 或更新版本npm随 Node.js 安装建议保留默认 registry 或配置内部镜像终端Windows 建议 PowerShell 或 Windows TerminalmacOS/Linux 默认终端即可API KeyDeepSeek 或通义千问等模型服务商的有效 Key磁盘空间工具本身很小预留 1GB 以内足够如果你在公司网络内使用 npm安装 Codex 时可能遇到 registry 访问慢的问题这时可以先用npm config get registry查看当前源再决定是否需要切换为内部镜像源。要注意的是切换 npm 源只影响 npm 包下载不影响 Codex 请求模型服务商的链路。3.2 Codex 登录与账户准备Codex 官方版本通常需要登录 GitHub 账号或者使用 OpenAI 账号认证。社区里也有通过 API Key 直接配置的做法。你需要在安装后确认自己的 Codex 版本是哪种认证方式再决定要不要准备对应的 API Key。从搜索热度中也能看到“Codex 官网登录入口”是大家经常查询的问题这部分每个版本差异较大最稳妥的办法是安装后直接运行codex --version查看版本号再搭配官方文档确认登录方式。3.3 网络连通性确认第三步是确认网络链路。Codex 本身只是命令行工具它要正常工作必须能够访问你配置的模型服务商 API 地址。可以在配置之前先用 curl 做一次连通性验证例如检查 DeepSeek 的 API 地址是否能访问。这样可以把问题拆开是网络不通还是 Codex 配置不对还是 CCSwitch 转发出了问题。网络层面的问题不要绕路解决请确认你的网络环境对目标 API 是否可达并据此申请或调整访问方式。4. 安装部署与启动方式4.1 安装 Codex CLICodex CLI 的常见安装方式是 npm 全局安装。打开终端执行npm install -g openai/codex安装完成后执行版本检查codex --version如果codex命令找不到通常是 npm 全局目录没有加入 PATH。Windows 上可以检查 npm 全局安装路径macOS/Linux 可以检查当前 shell 的 PATH 配置。重新打开终端后再次运行如果仍然提示找不到命令说明路径没有生效需要手动修改。安装过程中如果遇到权限报错Linux/macOS 可以尝试用 sudo 安装但更推荐先修复 npm 全局目录的权限问题避免后续每次更新都用 sudo。Windows 上如果提示脚本执行策略受限可以调整 PowerShell 的执行策略或改用 cmd 执行安装。4.2 下载并启动 CCSwitchCCSwitch 属于社区工具下载时务必通过官方渠道获取优先选择项目官网或官方 GitHub Releases 页面注意核对版本号和校验值。社区工具经常出现第三方打包站下载后可能自带修改过的脚本或捆绑软件风险不小安装前一定先确认来源。下载完成后按平台启动。Windows 下一般是运行解压后的可执行文件macOS 下打开时如果系统提示“无法验证开发者