Claude 与 Codex 接入 DeepSeek-V4-Pro 模型完整教程

本教程详细讲解如何下载并安装 Claude（桌面客户端）与 Codex（OpenAI CLI 工具），并通过 CC-Switch 工具跳过官方登录，直接接入 DeepSeek-V4-Pro 模型，大幅降低使用成本。

---

目录

1. 准备工作
2. Claude 客户端接入 DeepSeek-V4-Pro
3. Codex 接入 DeepSeek-V4-Pro
4. 常见问题与注意事项
5. 参考资源

---

准备工作

1. 获取 DeepSeek API Key

在使用任何工具之前，需要先获取 DeepSeek 的 API Key：

• 访问 DeepSeek 开放平台
• 注册并登录账号
• 在「API Keys」页面创建新的 API Key
• 复制并妥善保存（格式为 sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx）

DeepSeek-V4-Pro 的定价极具竞争力，缓存命中率高达 98.5%，缓存价格低至 0.02 元/百万 token，非常适合日常开发使用。

2. 科学上网（如需要）

由于部分页面（如 Claude 官网下载页）可能需要科学上网才能访问，可尝试以下免费方案：

• ikuuu 免费机场：https://ikuuu.win/user （GitHub 上也有大量免费机场可供选择）
• 也可通过 GitHub 搜索「免费机场」或「free proxy」寻找合适的节点
• 科学上网指南地址：https://hlxliao.top/archives/ke-xue-shang-wang-zhi-nan--ji-chang-fang-shi-

注意：免费节点稳定性有限，重要工作建议使用付费服务。

---

Claude 客户端接入 DeepSeek-V4-Pro

第一步：下载 Claude 桌面客户端

访问 Claude 官方下载页面：

https://claude.com/download

⚠️ 注意：Claude 官网目前不支持在中国大陆地区直接访问和下载，需要科学上网后方可正常打开。请参考「准备工作 - 科学上网」部分的建议。

选择对应操作系统版本下载：

• Windows：下载 .exe 安装包
• macOS：下载 .dmg 镜像文件

安装完成后，不要登录 Claude 账号（我们通过 CC-Switch 跳过登录步骤）。

第二步：下载并安装 CC-Switch

CC-Switch 是一款开源免费的工具，专门为 Claude Code / Codex / Gemini / OpenCode 等 CLI 工具设计，支持一键切换模型供应商，内置 DeepSeek、智谱 GLM、Kimi、通义千问、豆包等国产模型的预设。

下载地址：

https://github.com/farion1231/cc-switch/releases
NPM 包：https://www.npmjs.com/package/cc-model-switcher

⚠️ 注意：CC-Switch 托管在 GitHub 上，如果 GitHub 页面打不开或下载速度很慢，建议使用科学上网后再访问。

平台	推荐下载
Windows	CC Switch Setup v2.0.3.exe（安装版）或绿色版 .exe
macOS	CC Switch-v2.0.3-mac.zip（兼容 Intel + Apple Silicon）
Linux	CC Switch-v2.0.3.AppImage

macOS 用户若首次打开提示「未知开发者」，请在 系统设置 → 隐私与安全性 → 仍要打开，或在终端执行：

xattr -cr "/path/to/CC Switch.app"

第三步：开启 Claude Code 开发者模式

在配置 CC-Switch 之前，需要先启用 Claude Code 的开发者模式，以便后续接入第三方 API：

1. 打开已安装的 Claude 桌面客户端
2. 进入设置（Settings），找到「开发者模式」（Developer Mode）选项
3. 将其开启（部分版本可能需要勾选「启用第三方 API 代理」或类似选项）
4. 开启后关闭 Claude 客户端，等待后续 CC-Switch 配置完成后再重新启动

开发者模式允许 Claude Code 通过本地代理（如 CC-Switch）接入第三方模型服务，是接入 DeepSeek 的前提条件。

第四步：配置 DeepSeek 供应商

1. 打开 CC-Switch，点击界面右上角的「+」按钮
2. 在「预设」下拉框中选择「DeepSeek」
3. 填写你从 DeepSeek 开放平台获取的 API Key
4. 端点地址会自动填充为 https://api.deepseek.com/anthropic
5. 点击「添加」完成配置

第五步：切换模型并启动

1. 在 CC-Switch 主界面中，点击 DeepSeek 卡片的「启用」按钮

   • 或者右键点击系统托盘中的 CC-Switch 图标，直接选择 DeepSeek

2. 点击 CC-Switch 设置中的「路由」选项，开启路由功能

3. 开启路由后，启动 Claude Code 客户端（此时客户端会自动检测 CC-Switch 的代理配置）

4. 在 Claude Code 中进入设置，选择「配置第三方 API」

5. 系统会自动检测到 CC-Switch 的本地代理地址，确认后点击「测试连接」

6. 连接测试通过后，点击「应用变更」保存配置

7. 配置即时生效，无需重启终端，即可进入使用页面

第六步：验证配置

打开终端，输入：

claude

然后输入测试指令：

> 你好，请简单介绍一下自己

如果 AI 正常回复，且回复内容体现为 DeepSeek 模型特征，说明配置成功。

---

Codex 接入 DeepSeek-V4-Pro

Codex 是 OpenAI 推出的命令行 AI 编程助手，支持直接在终端中使用。以下提供两种接入方式：CC-Switch 和 Codex++，任选其一即可。

第一步：下载 Codex

下载地址：

https://chatgpt.com/zh-Hans-CN/codex/

在终端通过以下命令安装：

# 使用 npm 全局安装
npm install -g @openai/codex

或者通过 pip 安装：

pip install openai-codex

安装完成后，不要直接登录，通过以下任一工具绕过认证并接入 DeepSeek。

---

方案 A：通过 CC-Switch 配置 Codex

如果你已经按照上一章节完成了 CC-Switch 的安装和 DeepSeek 供应商配置，Codex 可以直接复用该配置：

1. 确保 CC-Switch 中 DeepSeek 供应商已启用
2. CC-Switch 会自动拦截 Codex 的 API 请求并转发至 DeepSeek
3. 在终端中启动 Codex：

codex

方案 B：通过 Codex++ 配置 Codex（推荐）

Codex++ 是一款开源免费的 Codex 管理工具，支持图形化配置第三方模型供应商，无需额外安装代理工具即可接入 DeepSeek。

下载 Codex++

下载地址：

https://github.com/BigPizzaV3/CodexPlusPlus/releases

⚠️ 注意：Codex++ 托管在 GitHub 上，如果页面打不开或下载速度很慢，建议使用科学上网后再访问。

根据操作系统选择对应版本：

• Windows：下载 .exe 安装包
• macOS：下载 .dmg 镜像文件

配置 DeepSeek 供应商

1. 下载并安装 Codex++ 后，打开 Codex++ 应用
2. 在界面中点击「供应商配置」选项
3. 点击「手动添加供应商」
4. 填写供应商信息：
   • 名称：填入 DeepSeek（或任意便于识别的名称）
   • API Key：填入你从 DeepSeek 开放平台获取的 API Key
   • API 接入地址：填入 https://api.deepseek.com
   • 上游协议：选择「Chat Completions」
5. 点击「保存」

启用并测试

1. 在供应商配置页面中，找到刚添加的 DeepSeek 供应商
2. 点击「使用该供应商」将其设为当前供应商
3. 点击「测试连接」验证配置是否成功
4. 连接通过后，切换到「概览」页面
5. 点击「启动 Codex++」，等待自动唤起 Codex 终端
6. 如果 Codex 未能自动响应，可手动点击右上角的「重启 Codex」按钮

💡 提示：Codex 首次启动时可能需要加载资源，如果加载较慢，可临时开启科学上网加速。启动成功后，后续日常使用 Codex 无需科学上网。

---

验证 Codex 配置

在 Codex 交互界面中测试：

> 用 Python 写一个快速排序算法

如果返回正常代码且响应速度符合 DeepSeek 特征，说明接入成功。

---

命令行替代方案（cc-model-switcher）

如果偏好纯命令行操作，也可以使用 npm 包 cc-model-switcher：

# 安装
npm install -g cc-model-switcher

# 切换到 DeepSeek
cc_switch deepseek

# 查看所有可用模型
cc_switch --list

# 交互式选择
cc_switch -i

配置文件位于 ~/.models.json，可手动编辑添加自定义模型。

---

常见问题与注意事项

Q1：CC-Switch 无法启动？

• 确保系统已安装 Git Bash（Windows 用户）
• 检查是否有防火墙拦截
• 尝试以管理员权限运行

Q2：DeepSeek-V4-Pro 报错「model not found」？

• 检查是否在请求中包含了图片。DeepSeek-V4-Pro 是纯文本模型，不支持图片输入，包含图片的上下文会报错
• 确认 API Key 有效且余额充足

Q3：终端中 claude 命令无法识别？

• 确保 Claude 客户端已正确安装
• Windows 用户需检查环境变量是否配置
• 尝试重启终端

Q4：如何切换回 Claude 官方模型？

• 在 CC-Switch 中点击当前供应商的「禁用」按钮
• 或者右键系统托盘图标选择「使用官方服务」
• Claude 的 API 请求将恢复为官方路由

Q5：DeepSeek 消耗速度太快？

• 合理使用 DeepSeek 的缓存机制：相似上下文可大幅降低费用（缓存命中价格仅 0.02 元/百万 token）
• 不同任务建议使用不同模型：简单任务用 DeepSeek，复杂推理任务可切换回 Claude Opus/Sonnet

Q6：CC-Switch 安全吗？

• CC-Switch 是开源项目（GitHub: farion1231/cc-switch），代码公开可审查
• API Key 存储在本地配置文件中，不会上传到第三方服务器
• 建议将配置文件权限设置为 chmod 600（macOS/Linux）

---

参考资源

视频教程

工具	参考视频
Claude + CC-Switch 接入 DeepSeek	Bilibili BV1RdLm6PEFF
Codex + CC-Switch 接入 DeepSeek	Bilibili BV1G8Gv6XEFF
Claude Code 免登录接入 DeepSeek V4	Bilibili BV16sRCB4EKW

官方与下载链接

资源	地址
Claude 下载	https://claude.com/download
Codex 下载	https://chatgpt.com/zh-Hans-CN/codex/
Codex++ Releases	https://github.com/BigPizzaV3/CodexPlusPlus/releases
CC-Switch GitHub	https://github.com/farion1231/cc-switch
CC-Switch Releases	https://github.com/farion1231/cc-switch/releases
cc-model-switcher (npm)	https://www.npmjs.com/package/cc-model-switcher
DeepSeek 开放平台	https://platform.deepseek.com
ikuuu 免费机场	https://ikuuu.win/user

社区与文档

资源	地址
CC-Switch 快速入门	https://github.com/farion1231/cc-switch/blob/main/docs/user-manual/zh/1-getting-started/1.4-quickstart.md
CC-Switch 供应商配置	https://github.com/farion1231/cc-switch/blob/main/docs/user-manual/zh/2-providers/2.1-add.md
Codex + CC 穷鬼工作流	https://github.com/aiskyhub/codex_with_cc

---

最后更新：2026 年 6 月 09 日
本教程基于 CC-Switch v2.0.3+ 和 DeepSeek-V4-Pro 编写，如有版本更新请以各项目官方文档为准。