codex配置deespeek

云青黛

230人浏览 · 2026-09-06 13:36:53

云青黛 · 2026-09-06 13:36:53 发布

Codex 与 CC Switch 手动安装配置教程

包含 DeepSeek（DS）接入 Codex 的完整步骤

整理日期：2026 年 9 月 6 日

本文面向需要在本地使用 Codex CLI，并通过 CC Switch 管理 OpenAI、DeepSeek 等供应商的用户。建议按照“安装 Codex → 首次登录 → 安装 CC Switch → 添加供应商 → 验证”的顺序操作。

一软件关系与安装准备

Codex CLI 是实际运行代码分析、修改和命令执行的工具；CC Switch 是桌面管理器，用于保存和切换供应商、API Key、模型及本地路由配置。CC Switch 不能替代 Codex CLI，二者需要分别安装。

项目	作用	最低建议
Codex CLI	在终端中运行 AI 编程任务	Windows 10+、macOS、主流 Linux
CC Switch	管理 Codex/Claude/Gemini 等工具的供应商和配置	Windows 10+、macOS 12+、Ubuntu 22.04+/同类发行版
DeepSeek API	提供 DeepSeek Chat/Reasoner 模型	有效 API Key 和可用额度

下载原则：Codex 使用 OpenAI 官方安装入口；CC Switch 使用项目 GitHub Releases 页面。不要使用不明来源的二次打包程序。

二安装 Codex CLI

2.1 Windows

以管理员权限不是必需条件，普通 PowerShell 即可执行官方安装命令：

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

安装后关闭并重新打开 PowerShell，验证版本：

codex --version

如需先检查脚本再执行，可使用：

Invoke-WebRequest https://chatgpt.com/codex/install.ps1 -OutFile "$env:TEMP\install-codex.ps1"
Get-Content "$env:TEMP\install-codex.ps1"
powershell -ExecutionPolicy Bypass -File "$env:TEMP\install-codex.ps1"

2.2 macOS 与 Linux

curl -fsSL https://chatgpt.com/codex/install.sh | sh

更谨慎的下载检查方式：

curl -fsSL https://chatgpt.com/codex/install.sh -o /tmp/install-codex.sh
less /tmp/install-codex.sh
sh /tmp/install-codex.sh

2.3 npm 或 Homebrew 方式

已有 Node.js 的用户可以使用 npm：

npm install -g @openai/codex

Homebrew 用户可以使用：

brew install --cask codex

更新命令：

npm install -g @openai/codex
# 或
brew upgrade --cask codex

三首次登录与 Codex 基础验证

进入项目目录并启动 Codex：

cd path/to/your-project
codex .

首次启动时选择“Sign in with ChatGPT”，在浏览器完成登录。随后可输入：

请介绍一下这个项目的目录结构，并指出程序入口。

如果系统提示找不到命令，可检查 PATH：

# Windows
where.exe codex

# macOS/Linux
which codex

常见处理方式是重新打开终端，或检查 Codex 安装目录/npm 全局目录是否已经加入 PATH。

四手动安装 CC Switch

官方下载：CC Switch GitHub Releases

4.1 Windows

普通 Intel/AMD 电脑选择以下任一文件：

CC-Switch-v版本号-Windows.msi：标准安装版。
CC-Switch-v版本号-Windows-Portable.zip：绿色便携版。

ARM Windows 选择文件名中带 Windows-arm64 的版本。绿色版示例：

Expand-Archive .\CC-Switch-v版本号-Windows-Portable.zip -DestinationPath C:\Tools\CC-Switch
C:\Tools\CC-Switch\CC-Switch.exe

4.2 macOS

下载 CC-Switch-v版本号-macOS.dmg，双击后将应用拖入 Applications。官方 macOS 版本已签名和公证。Homebrew 用户也可以使用：

brew install --cask cc-switch

4.3 Debian/Ubuntu、Fedora 和通用 Linux

系统	文件与命令
Debian/Ubuntu	下载 .deb；执行 sudo apt install ./CC-Switch-v版本号-Linux-x86_64.deb
Fedora/RHEL/openSUSE	下载 .rpm；执行 sudo dnf install ./CC-Switch-v版本号-Linux-x86_64.rpm
通用 Linux	chmod +x CC-Switch-v版本号-Linux-x86_64.AppImage；./CC-Switch-v版本号-Linux-x86_64.AppImage
Arch Linux	paru -S cc-switch-bin

ARM64 设备应下载文件名中带 arm64 的构建版本。Wayland + NVIDIA 环境若出现黑屏或无法点击，可尝试：

CC_SWITCH_GDK_BACKEND=wayland ./CC-Switch-v版本号-Linux-x86_64.AppImage

五在 CC Switch 中配置 Codex

启动 CC Switch 后，选择 Codex 应用，点击右上角“+”添加供应商。首次启动如果检测到已有 Codex 配置，可以先选择导入，避免覆盖原有设置。

1. 选择预设或自定义配置。

2. 填写 API Key、模型和端点信息。

3. 点击“添加/保存”，再点击“启用”。

4. 关闭已有 Codex 终端并重新启动。

5.1 OpenAI 官方登录

选择“OpenAI 官方”或“官方登录”预设，按 Codex 的 ChatGPT/OAuth 流程完成登录。恢复官方登录时，也可以重新启用该预设并重启 Codex。

5.2 第三方供应商

选择 OpenRouter、DeepSeek、Kimi、智谱 GLM、MiniMax 等预设。预设一般会自动填充端点和协议，只需填写 API Key；如果界面提供“获取模型”按钮，建议优先使用它获取真实模型 ID。

5.3 配置文件位置

Codex 常见配置文件：

~/.codex/auth.json
~/.codex/config.toml

# Windows 对应
%USERPROFILE%\.codex\auth.json
%USERPROFILE%\.codex\config.toml

CC Switch 数据目录通常为：

~/.cc-switch/cc-switch.db
~/.cc-switch/settings.json
~/.cc-switch/backups/

六配置 DeepSeek 给 Codex 使用

DeepSeek 常用接口是 OpenAI Chat Completions，而 Codex 原生主要使用 Responses API。因此，通过 CC Switch 使用 DeepSeek 时，通常需要开启本地路由映射，由 CC Switch 完成协议转换。

6.1 准备 DeepSeek API Key

打开 DeepSeek 开放平台，登录后进入 API Keys 创建密钥，并确认账户有可用额度。

DeepSeek 开放平台

6.2 使用 DeepSeek 预设

1. CC Switch → Codex → “+” → 添加供应商。

2. 预设选择“DeepSeek”。

3. 填写 API Key。

4. 点击“获取模型”，从返回列表选择模型；常见示例为 deepseek-chat、deepseek-reasoner。

5. 保存并启用。

模型名称会随 DeepSeek 和 CC Switch 版本更新，实际使用时应以“获取模型”返回的模型 ID 为准。

6.3 开启本地路由映射

编辑 DeepSeek 供应商，确认以下选项已开启：

需要本地路由映射。
CC Switch 代理服务。
Codex 接管。

代理服务默认地址通常为：

http://127.0.0.1:15721

当本地路由工作时，Codex 的端点可能被设置为：

base_url = "http://127.0.0.1:15721/v1"

使用 DeepSeek 时不要关闭 CC Switch 代理，否则 Codex 发出的 Responses 请求无法转换为 DeepSeek 所需的 Chat Completions 请求。

6.4 自定义 DeepSeek 配置

如果当前版本没有 DeepSeek 预设，可以选择“自定义”，填写以下信息：

字段	示例	说明
API Key	你的 DeepSeek API Key	不要提交到 Git 或发送给他人
Base URL	https://api.deepseek.com	部分兼容接口要求带 /v1，以获取模型结果为准
模型	deepseek-chat	也可使用获取模型返回的其他 ID
本地路由映射	开启	Chat Completions 供应商必须开启

不建议把 DeepSeek 手动配置成 wire_api = "responses"；协议转换应由 CC Switch 本地路由完成。

6.5 模型映射

开启本地路由后，可以在模型映射表中填写：

模型 ID	显示名称	用途
deepseek-chat	DeepSeek Chat	通用对话和代码任务
deepseek-reasoner	DeepSeek Reasoner	推理类任务

保存模型映射后需要重启 Codex，/model 列表才会刷新。

七验证与故障排查

7.1 验证清单

检查项	预期结果
Codex 版本	codex --version 能正常返回版本
CC Switch	应用可以正常启动并显示 Codex
供应商	DeepSeek 卡片已添加并处于启用状态
本地路由	代理状态为运行中，通常监听 127.0.0.1:15721
模型	/model 中能看到 DeepSeek 模型
请求	Codex 能完成一次简单代码分析

7.2 常见错误

现象	处理方法
401 Unauthorized	检查 API Key、账户余额和密钥状态。
model not found	重新点击“获取模型”，使用返回的真实模型 ID。
502 Bad Gateway	确认 CC Switch 代理、Codex 接管和本地端口均已开启。
切换后仍使用旧模型	完全退出 Codex，再执行 codex .。
找不到 codex 命令	重新打开终端，检查 PATH 或 npm 全局目录。
AppImage 黑屏/无法点击	Wayland + NVIDIA 可尝试设置 CC_SWITCH_GDK_BACKEND=wayland。