Windows 本地部署 Codex 全攻略:CC Switch 接入 DeepSeek 与模型自由切换
本教程专为 Windows 用户打造,教你通过 CC Switch 将 VSCode Codex 插件无缝对接 DeepSeek 模型。全程无需 OpenAI 账号、海外网络或付费订阅,利用本地协议转发即可零成本解锁强大的智能编码能力,轻松搞定代码补全、重构与 BUG 修复。
一、前置环境准备
1、安装node.js
官网:https://nodejs.org/zh-cn 推荐 Node.js 22 LTS 版本及以上,下载 Windows 的 LTS 安装包
安装时,务必勾选 Add to PATH(自动写入系统环境变量),其余默认下一步
安装完成,打开Powershell验证:
bash
node -v
npm -v
能正常输出版本号即为成功。
2、安装 Git(强烈推荐,可选)
作用:Codex Agent 可以读取 Git 历史、文件变更记录,理解项目结构,代码分析效果更好;不装 Git 也能跑,只是缺少 Git 相关上下文。
官网:https://git-scm.com/install/windows 选择 64 位 Windows 安装包,默认安装即可,一路下一步,会自动配置 PATH。
安装完成,打开Powershell验证:
bash
git --version
输出版本号即安装成功。
二、获取DeepSeek API Key
打开 https://platform.deepseek.com/ 注册登录
在左侧菜单栏【API Keys 】中,创建密钥,复制 sk-xxxx,妥善保存,只显示一次。

注意:账户需要充值余额(DeepSeek 按 token 计费,不充值无法调用)
三、安装 CC Switch
CC Switch 作用:本地拦截 Codex 的 OpenAI 请求,无缝转为 DeepSeek 接口,实现免登录、免梯子。
官网下载地址:https://ccswitch.io/zh/download 推荐下载 安装版 (.msi)
四、安装Codex
在安装 Codex 时,你可以根据自身的工作习惯,在
命令行工具(CLI)和图形界面(GUI)中任选其一,也可以将两者同时安装、协同使用。它们共享同一套核心配置与账号凭据,但在交互方式和适用场景上各有侧重:① Codex CLI(命令行工具)
- 主要场景:专为终端重度用户设计。适合需要编写自动化脚本、接入 CI/CD 流水线、进行批量代码重构,或希望在纯键盘流下快速执行任务的开发者。
- 特点:轻量高效,无缝融入现有的 Shell 工作流。
② Codex GUI(图形界面)
- 主要场景:适合新手入门、需要可视化代码审查(Review UI)、多任务并行管理,或希望在 IDE 中边写边改的用户。
- 特点:提供直观的交互界面,支持通过鼠标点击管理文件变更与自动化流程,大幅降低使用门槛。
1、安装Codex CLI
打开 PowerShell 执行全局安装:
bash
npm install -g @openai/codex
验证安装:
bash
codex --version
能正常输出版本号即为成功。
2、Codex 桌面端
下载Codex Windows桌面客户端:https://chatgpt.com/zh-Hans-CN/download/
客户端会安装在系统的【Microsoft Store】

五、CC Switch 配置 DeepSeek 模型
打开 CC Switch 顶部切换到 Codex 标签页 , 右上角【+】添加供应商,选择预设 DeepSeek
API 地址会自动填充,只需要填入你的API Key

配置模型:在【高级选项】中,可以配置要调用的模型,我们这里选择默认的模型

配置完成后,回到CC Switch首页,启用 DeepSeek 供应商

六、启动Codex进行测试
1、测试CLI
打开 PowerShell 输入:
bash
codex

可以看到模型已经是deepseek-v4-flash ,并且可以进行对话
2、测试GUI(如已安装)
打开桌面端,直接对话测试,能正常回答即代表配置完全生效。

七、VSCode 接入 Codex 实现 AI 编程
VSCode 扩展商店搜索安装:Codex - OpenAI's coding agent

安装后重启 VSCode,先打开项目文件夹

然后打开 Codex 面板,VSCode 自动读取本地 Codex 配置,直接进行对话

至此整套部署全部完成。你现在拥有三条可用的交互入口:终端 Codex CLI、独立 Codex 桌面 GUI、VSCode 内置 Codex 助手,三者共用同一套代理配置,底层统一调用 DeepSeek 代码模型。
后续如果需要切换模型供应商,只需要在 CC Switch 里更换启用的模型,完全退出所有 Codex 进程(关闭终端、托盘退出桌面端、重启 VSCode),重新打开即可加载新配置。