Codex 搭配国产大模型实战教程：DeepSeek + 通义千问接入（含PyCharm集成）

一、前言

Codex 是一款优秀的 AI 编程助手，原生依赖海外模型，本文将手把手教大家通过 Codex++ 中转站 改造 Codex，先后接入 DeepSeek、阿里云通义千问 两款国产大模型，同时完成 PyCharm 插件集成，全程图文实操，新手也能跟着配置。

二、环境准备清单

  1. Codex++ 增强启动器（核心中转工具）
  2. 官方原版 Codex 客户端
  3. DeepSeek / 阿里云百炼 账号及 API Key
  4. CC-Switch 模型切换工具（辅助配置）
  5. PyCharm（需安装对应 AI 插件）

三、第一步：安装 Codex++ 中转站

Codex++ 是 Codex 的外部增强启动器，不会修改 Codex 原文件，通过脚本注入实现模型转发，是接入国产大模型的核心工具。

1. 下载地址

GitHub 开源地址：https://github.com/BigPizzaV3/CodexPlusPlus
进入页面后点击 Releases，根据系统选择安装包：

  • Windows：CodexPlusPlus-*-windows-X64-setup.exe
  • macOS Intel：CodexPlusPlus-*-macos-x64.dmg
  • macOS Apple Silicon：CodexPlusPlus-*-macos-arm64.dmg
    在这里插入图片描述
    在这里插入图片描述

2. 安装流程

  1. 双击安装包，可自定义安装目录（建议安装到非系统盘，如 D:\codex++）；
  2. 等待安装完成，桌面会生成两个图标：
    • Codex++：静默启动入口，直接启动 Codex 并加载增强配置；
    • Codex++管理工具：控制面板，用于配置、修复、切换模型。
      在这里插入图片描述

四、第二步：Codex 接入 DeepSeek 大模型

1. 获取 DeepSeek API 信息

  1. 官网地址：https://www.deepseek.com，注册并登录账号；
  2. 进入开放平台-API Keys：https://platform.deepseek.com/api_keys；
  3. 点击创建 API Key，Key 仅创建时可复制，务必妥善保存；
  4. 确保账号内有余额，否则 API Key 无法正常调用；
  5. 官方 API 基础地址：https://api.deepseek.com
  6. 可用模型：deepseek-v4-pro、deepseek-v4-flash。
    在这里插入图片描述
    在这里插入图片描述

2. Codex++ 供应商配置

  1. 打开 Codex++管理工具，左侧选择【供应商配置】；
    在这里插入图片描述
    在这里插入图片描述

  2. 点击【添加供应商】，按以下参数逐项填写：

    • 名称：deepseek
    • 接入模式：纯API
    • 配置模型：deepseek-v4-pro 或 deepseek-v4-flash（二选一）
    • Base URL：https://api.deepseek.com
    • Key：粘贴你复制的 DeepSeek API Key
    • 上游协议：选择 Chat Completions
      在这里插入图片描述

  3. 填写完成后点击保存，并将该供应商设为当前使用。
    在这里插入图片描述

3. 安装官方 Codex 客户端

  1. 微软商店下载地址：https://apps.microsoft.com/detail/9plm9xgg6vks?hl=zh-CN&gl=CN
  2. 点击下载并自动安装，等待部署完成；

在这里插入图片描述
在这里插入图片描述
3. 首次打开原版 Codex 后，直接关闭程序及后台进程(右键退出)。
在这里插入图片描述

4. 启动测试 DeepSeek

  1. 双击桌面 Codex++（不要直接打开原版 Codex）；
    在这里插入图片描述

  2. 客户端右下角选择已配置的 deepseek-v4-pro/deepseek-v4-flash；
    在这里插入图片描述

  3. 在对话框输入指令测试，正常返回内容即代表接入成功。
    在这里插入图片描述

注意：后续启动 Codex 统一使用 Codex++ 入口。

五、第三步：安装 CC-Switch 模型切换工具

由于 Codex 原生优先支持 Responses API，DeepSeek 存在兼容性问题，我们搭配 CC-Switch 切换为阿里云通义千问（完美适配 Codex）。

1. 下载 & 安装

  1. 项目地址：https://github.com/farion1231/cc-switch/releases
  2. 拉到页面底部，Windows 系统下载 CC-Switch-xxx-Windows.msi；
  3. 双击安装包，一路【下一步】完成安装。
    在这里插入图片描述

2. 路由配置

  1. 打开 CC-Switch，进入【设置】-【路由】；
    在这里插入图片描述

  2. 开启路由总开关、勾选 Codex；

  3. 默认服务地址：http://127.0.0.1:15721，保持默认即可。
    在这里插入图片描述

六、第四步：Codex 接入阿里云通义千问（推荐）

通义千问拥有免费额度，且原生兼容 Codex 的 Responses API，稳定性更强。

1. 获取阿里云百炼 API 信息

  1. 阿里云百炼控制台：https://bailian.console.aliyun.com/

  2. 进入【API Key】管理页面，创建专属 API Key；
    在这里插入图片描述

  3. 华北2（北京）Base URL：https://dashscope.aliyuncs.com/compatible-mode/v1

  4. 推荐模型：qwen3.7-max（免费额度可用，无需付费订阅）。

  5. 百炼平台的文档中codex一栏会教我们如何配置codex auth.json

  6. 不要用上面的token-plan,那个要充值才能用,直接往下划到下图显示的位置,这个有免费额度,可以试用,后面你们觉得可以再考虑换成token-plan的
    在这里插入图片描述

2. CC-Switch 配置通义千问

  1. CC-Switch 首页选择【Codex】，点击右侧加号添加供应商；
    在这里插入图片描述

  2. 填写配置参数：

    • 供应商名称：自定义（如通义千问）
    • API 请求地址：https://dashscope.aliyuncs.com/compatible-mode/v1
    • API Key：粘贴阿里云百炼密钥
    • 模型名称：qwen3.7-max

  3. 保存配置，工具会自动写入 Codex 的 config.toml、auth.json 配置文件。
    在这里插入图片描述
    在这里插入图片描述

3. 系统环境变量配置（Windows）

好,配置好Codex auth.json后继续按照官方文档执行
在这里插入图片描述

  1. 按下 Win+R，输入 cmd 打开命令行；
  2. 执行命令（替换为你自己的阿里云 API Key）： 
    setx OPENAI_API_KEY "你的阿里云百炼API Key"
  3. 关闭当前 CMD，重新打开，执行以下命令验证是否生效： 
    echo %OPENAI_API_KEY%
  4. 终端正常输出 API Key，代表环境变量配置成功。
    在这里插入图片描述

4. 命令行验证 Codex

新 CMD 窗口直接输入 codex，若正常启动并显示 model: qwen3.7-max，说明模型接入完成。
在这里插入图片描述

七、第五步：PyCharm 集成 Codex + 通义千问

实现 IDE 内直接使用国产大模型辅助编码。

1. 安装 CC GUI 插件

  1. 打开 PyCharm，依次点击 文件 → 设置 → 插件(Marketplace)；
  2. 搜索 CC GUI (Claude or Codex)，点击安装，完成后重启 PyCharm。
    在这里插入图片描述

2. 安装依赖 SDK

  1. 重启后右侧工具栏打开 CC GUI；
    在这里插入图片描述

  2. 进入【SDK依赖管理】，分别安装 Claude Code SDK 和 Codex SDK；
    在这里插入图片描述

  3. 等待依赖自动安装（耗时较长，耐心等待），显示版本号即为安装完成。

3. 关联本地 Codex 配置

  1. 在 CC GUI 中进入【设置】-【供应商管理】，选择 Codex；
    在这里插入图片描述

  2. 点击显式授权，读取本地 ~/.codex/ 下的配置文件；
    在这里插入图片描述

  3. 在模型列表我们先手动加一个模型, qwen3.7-max，切换为当前使用模型。

  4. 在这里插入图片描述

4. 最终测试

在 CC GUI 输入对话指令，模型正常响应代码/问答内容，即 PyCharm 集成全部完成。
在这里插入图片描述

八、补充说明 & 避坑总结

1. 常见问题

  1. Codex 启动失败：检查 Codex++ 路由、CC-Switch 路由是否正常开启；
  2. API 调用无响应：核对 API Key、Base URL、模型名称是否填写错误；
  3. 环境变量不生效：setx 命令修改环境变量后，必须重启 CMD/PyCharm。

2. 选型建议

  1. DeepSeek：推理能力强，但和 Codex Responses API 兼容性一般；
  2. 通义千问：免费额度友好、完美适配 Codex；
  3. 额外提示：Codex Token 消耗较高，追求性价比可优先选择 Claude Code 对接国产大模型。

3. 核心工具汇总链接

  • Codex++：https://github.com/BigPizzaV3/CodexPlusPlus
  • CC-Switch：https://github.com/farion1231/cc-switch
  • DeepSeek 开放平台：https://platform.deepseek.com/
  • 阿里云百炼：https://bailian.console.aliyun.com/
  • 官方 Codex 下载：https://apps.microsoft.com/detail/9plm9xgg6vks?hl=zh-CN&gl=CN

九、总结

本文通过 Codex++ 实现了 Codex 客户端的模型转发，先后完成 DeepSeek、通义千问两款国产大模型接入，同时落地 PyCharm IDE 集成。整套方案摆脱了原生海外模型限制，利用国产大模型免费额度即可实现 AI 辅助编程，适合开发人员日常调试、写代码、查 Bug 使用。

# pycharm # 策略模式 # ide
Logo
AI Agent技术社区

Agent 垂直技术社区，欢迎活跃、内容共建。

更多推荐

cover

云客服是什么？2026 年 6 月最新核心技术解析与入门指南

avatar AI Agent技术社区

大模型 API 聚合服务从工具走向基础设施：星链4SAPI的企业价值

它涵盖 GPT、Claude、Gemini 等主流模型，接入方式与 OpenAI 官方接口兼容，同时支持多模态数据处理、线路优化、人民币结算、企业级账务管理、国内备案主体等条件。迁移成本同样不可忽视。尤其是金融、教育、医疗、政企服务、ToB SaaS 等行业，供应商资质、备案状态、数据流向、费用凭证及合同主体都会被反复核查。从这个角度看，星链4SAPI 值得被重点评估，是因为它把国内企业真正关心的

avatar AI Agent技术社区
cover

阿里成立 Token Foundry 事业部，CEO 亲自挂帅：大模型进入商业化冲刺阶段

avatar AI Agent技术社区