文档概述本方案旨在 Rocky Linux 系统上通过CC Switch工具将OpenAI Codex命令行编程工具的 AI 模型后端切换为DeepSeek-V4-Pro。文档记录了完整的安装、配置、验证流程及常见问题解决方法。适用场景在终端中使用 AI 辅助编程偏好 DeepSeek 模型能力希望绕过对 OpenAI 官方 API 的直接依赖。1. 环境准备1.1 系统要求操作系统Rocky Linux 8 或 9 (本指南基于 Rocky Linux 9 测试)网络要求服务器需能正常访问互联网以安装软件包和调用 API。用户权限具备sudo权限的用户或可直接使用root用户本指南使用root普通用户命令前需加sudo。1.2 安装基础依赖Codex 和 CC Switch 均依赖 Node.js 环境。# 安装 Node.js 和 npm通过官方源安装较新版本 curl -fsSL https://rpm.nodesource.com/setup_20.x | bash - dnf install -y nodejs # 验证安装 node -v # 应显示 v20.x 或更高 npm -v # 应显示 10.x 或更高潜在问题若系统提示bubblewrap相关警告这是沙箱安全组件的提示不影响核心功能。若想消除警告可执行dnf install -y bubblewrap。2. 安装并配置 CC Switch核心桥梁工具CC Switch 是一个图形化配置工具用于统一管理多个 AI 模型供应商的 API 配置并自动为 Codex 搭建本地代理。2.1 安装 CC Switch# 使用 npm 全局安装 npm install -g ccswitch # 安装完成后启动 CC Switch 图形界面会默认打开浏览器 ccswitch注意确保防火墙允许访问 CC Switch 的 Web 端口通常为15721。若无法自动打开浏览器可手动访问http://服务器IP:15721。2.2 在 CC Switch 中添加 DeepSeek 供应商在 CC Switch 界面顶部点击Codex标签页。点击右上角的按钮选择DeepSeek预设。在弹出的配置窗口中API Key粘贴你在 DeepSeek 开放平台申请的 API Key。其他字段Base URL、默认模型保持预设值即可通常为deepseek-v4-pro或deepseek-v4-flash。点击保存。2.3 启用本地路由关键步骤点击 CC Switch 右上角的齿轮图标设置进入路由页面。开启本地路由总开关。在“路由启用”区域打开Codex的开关。确认本地代理地址默认为http://127.0.0.1:15721/v1后续配置需要用到。3. 安装并配置 Codex3.1 安装 Codex CLI# 通过 npm 全局安装 OpenAI Codex npm install -g openai/codex # 验证安装 codex --version # 应显示版本号如 v0.140.03.2 配置 Codex 配置文件手动修改以确保生效虽然 CC Switch 声称能自动修改但根据实际测试手动修改~/.codex/config.toml文件更为可靠。创建配置目录并编辑配置文件mkdir -p ~/.codex vi ~/.codex/config.toml将以下完整配置写入文件# 指定默认模型和供应商 model deepseek-v4-flash model_provider deepseek # 定义 deepseek 供应商 [model_providers.deepseek] name DeepSeek # 关键指向 CC Switch 的本地代理地址 base_url http://127.0.0.1:15721/v1 env_key DEEPSEEK_API_KEY # 关键使用 Responses API 协议 wire_api responses说明若你希望使用deepseek-v4-pro模型可将model值替换为deepseek-v4-pro。base_url的端口号请以 CC Switch 实际显示为准。保存并退出。4. 验证与启动4.1 确保相关服务已启动CC Switch必须保持在运行状态终端窗口中保持ccswitch进程活跃。确保 CC Switch 界面的“路由”页面显示“已激活”状态。4.2 设置环境变量可选但推荐为避免每次输入 API Key可在~/.bashrc中设置echo export DEEPSEEK_API_KEY你的DeepSeek API密钥 ~/.bashrc source ~/.bashrc4.3 启动 Codex 并验证模型codex预期正确输出应包含model: deepseek-v4-flash high /model to change这表明 Codex 已成功连接到 DeepSeek 模型。此时你可以直接输入问题开始使用。5. 常见问题与解决方案问题现象可能原因解决方法/model命令只显示 ChatGPT 选项正常现象。通过代理添加的第三方模型不会出现在此列表中。应以启动界面显示的model:为准。无需处理。启动 Codex 显示Model metadata not foundCodex 无法获取 DeepSeek 模型的完整元数据。此为警告不影响对话功能可直接忽略。Codex 无法启动或报连接错误CC Switch 未运行base_url端口配置错误防火墙拦截。1. 检查ccswitch是否在运行2. 核对~/.codex/config.toml中的base_url端口3. 确保防火墙开放15721端口。提示bubblewrap not found系统缺少沙箱组件。dnf install -y bubblewrap可消除此提示不影响核心功能。npm install 时报EEXIST错误文件冲突。在安装命令后加--force如npm install -g openai/codex --force。6. 日常使用建议模型切换如需临时切换模型可编辑~/.codex/config.toml中的model字段然后重启 Codex。启动流程每次使用前先确保 CC Switch 已在运行界面打开或后台服务活跃再执行codex。性能提示deepseek-v4-flash注重响应速度deepseek-v4-pro更擅长复杂推理可根据任务选择。7. 总结本方案通过 CC Switch 搭建本地代理解决了 Codex 原生只支持 OpenAI 官方模型的问题实现了在 Rocky Linux 下使用 DeepSeek-V4-Pro 模型进行 AI 辅助编程。整个流程的关键在于CC Switch 的本地路由配置和手动修改 Codex 配置文件。按照文档操作后你应该能得到一个稳定运行的 DeepSeek Codex 开发环境。