
#### 概述

最近很多朋友都在问一个问题：

**Codex 能不能配合 cc-switch 使用 GPT-5.5？能不能像 Claude Code 一样，直接切换不同的模型服务？**

答案是：**可以。**

不过这里面有几个概念容易混在一起。

Codex 是 OpenAI 的 AI 编程助手，可以在终端、VS Code、Cursor 等环境里使用。官方 Codex CLI 支持通过 npm 或 Homebrew 安装，也支持在 VS Code、Cursor、Windsurf 等 IDE 中使用 Codex 插件。

cc-switch 则更像是一个**本地 AI 编程工具的模型配置管理器**。你可以把它理解成：一个统一管理 Claude Code、Codex、Gemini、OpenCode、OpenClaw 等工具 Provider 配置的桌面工具。通过 cc-switch，我们可以把一个 API 中转站的配置导入进去，然后一键切换不同工具使用的模型服务。

这篇文章就按真实使用流程讲一遍：**安装 cc-switch → 注册 API 中转站 → 创建 API Key → 导入 cc-switch → 打开 Codex CLI / VS Code / Cursor 使用 GPT-5.5。**

---

### 一、这套方案适合谁？

这套方案比较适合下面几类人：

- **第一类**，已经在用 Codex、Claude Code、Cursor、VS Code 的开发者。
- **第二类**，想把 GPT-5.5 接入本地编程工具的人。
- **第三类**，手里有自己的 API 中转站，或者使用第三方 API 中转服务的人。
- **第四类**，想统一管理多个模型 Provider 的人。

如果你只是单纯想体验官方 Codex，可以直接用 `codex --model gpt-5.5`。但如果你想把不同 API 服务统一管理起来，或者想在不同 AI 编程工具之间切换，那 cc-switch 会更方便。

### 二、整体流程先看一遍

这篇教程的完整流程如下：

```text
1. 安装 cc-switch
2. 打开 API 中转站
3. 注册账号
4. 创建 API Key
5. 点击“一键导入 cc-switch”
6. 在 cc-switch 里启用 Provider
7. 安装 Codex CLI
8. 使用 codex 命令启动
9. 或者打开 VS Code / Cursor
10. 安装 Codex 插件
11. 在 IDE 里使用 Codex + GPT-5.5
```

你可以把这套流程理解成：**API 中转站负责提供模型接口，cc-switch 负责把接口配置写到本地工具里，Codex / VS Code / Cursor 负责真实使用。**

### 三、第一步：安装 cc-switch

cc-switch 是一个跨平台桌面工具，支持 macOS、Windows、Linux。它的基本使用方式是添加 Provider、启用 Provider，然后重启对应 CLI 工具生效。

**macOS 安装：** 可以用 Homebrew 安装：`brew install --cask cc-switch`，也可以去 GitHub Releases 下载 DMG 安装包。

**Windows 安装：** 下载 MSI 安装包或者便携版 ZIP。安装完成后，直接打开 cc-switch。

**Linux 安装：** Debian / Ubuntu 下载 `.deb` 包后执行 `sudo dpkg -i cc-switch_*.deb`，Fedora / RHEL 下载 `.rpm` 包后执行 `sudo rpm -i cc-switch_*.rpm`。

安装完成后，打开 cc-switch，正常情况下你会看到一个 Provider 管理界面。

也可以直接访问https://github.com/farion1231/cc-switch/releases   下载对应的安装包
![image.png](https://developer.qcloudimg.com/http-save/yehe-2063626/dc8b72e21d2e72dd2717c28d8eb1b86e.png)
### 四、第二步：打开 API 中转站

接下来打开你的 API 中转站。这里不限定具体平台，因为不同人用的中转站不一样。
![image.png](https://developer.qcloudimg.com/http-save/yehe-2063626/25dcc800c0b17bfe668080c53bbdc0b4.png)
一般中转站的首页会有几个入口：注册 / 登录、控制台、令牌 / API Key、模型列表、使用文档、余额 / 充值。你需要先注册一个账号。

注册完成后，进入控制台。通常路径类似：`控制台 → API Key / 令牌管理 → 创建令牌`。

这里建议你创建一个专门给 Codex / cc-switch 用的 API Key，不要把所有工具都共用一个 Key。这样后面如果泄露、限流、停用，都比较好处理。

### 五、第三步：创建 API Key

进入中转站后台后，找到类似“令牌管理 / API Key / Tokens / Keys”的入口，然后点击“创建令牌”。

创建时一般会让你填写：名称（如 codex-gpt55）、分组、额度（按需设置）、过期时间（可选）、模型权限（选择 GPT-5.5 或兼容模型）。

名称可以写得清楚一点，比如：`codex-gpt55`、`ccswitch-codex`、`vscode-codex`、`cursor-codex`。

创建完成后，你会拿到一个 API Key，通常长这样：`sk-xxxxxxxxxxxxxxxxxxxx`。把它复制下来。**注意：API Key 只显示一次，一定要保存好。**

### 六、第四步：点击“一键导入 cc-switch”

很多 API 中转站现在会提供一个按钮：“导入 cc-switch”或“一键导入 cc-switch”。

点击之后，浏览器通常会弹出一个协议链接，类似：`cc-switch://...`。如果你的电脑已经安装了 cc-switch，系统会询问是否打开 cc-switch。点击允许。
![image.png](https://developer.qcloudimg.com/http-save/yehe-2063626/76c172f2e9d23ae8dfa9ec3ed1a675d8.png)
然后 cc-switch 会自动打开导入页面。你需要检查几个核心字段：Provider 名称、Base URL、API Key、模型名称、目标应用（Codex / Claude Code / OpenCode / Universal Provider）。

如果中转站已经做得比较完善，通常这些字段会自动填好。你只需要确认无误，然后点击：添加 → 保存 → 启用。

### 七、如果没有“一键导入”怎么办？

如果你的中转站没有一键导入 cc-switch，也可以手动添加。

打开 cc-switch，进入 Provider 管理页面。点击右上角“+ 添加 Provider”，然后选择“Custom Gateway / 自定义网关 / OpenAI Compatible”（不同版本名字可能略有不同）。

然后填写：

- Provider Name: GPT-5.5 中转
- Base URL: `https://你的中转站域名/v1`
- API Key: `sk-xxxxxxxx`
- Model: `gpt-5.5`

如果要给 Codex 用，就选择 Codex 应用。如果你希望多个工具共用，也可以选择 Universal Provider。

这里新手建议：**先给 Codex 单独建一个 Provider**。跑通之后，再考虑做通用配置。

### 八、第五步：在 cc-switch 里启用 Provider

Provider 添加完成后，还需要启用。在 cc-switch 主界面里，找到你刚才添加的 Provider（比如“GPT-5.5 中转”），点击“Enable / 启用”。

启用后，cc-switch 会把相关配置写入对应工具的配置文件。所以这一步做完之后，建议你：**关闭当前终端 → 重新打开终端 → 再启动 Codex**。这样可以避免环境变量没生效。
![image.png](https://developer.qcloudimg.com/http-save/yehe-2063626/ddc063ebf3fb60bac1f5625e848f6f3d.png)
### 九、第六步：安装 Codex CLI

接下来安装 Codex CLI。OpenAI 官方 Codex 仓库提供了两种常见安装方式。

**npm 安装：** `npm install -g @openai/codex` 或 `npm i -g @openai/codex`

**Homebrew 安装（Mac）：** `brew install --cask codex`

安装完成后检查版本：`codex --version`。如果能看到版本号，说明安装成功。

### 十、第七步：打开 Codex CLI 使用 GPT-5.5

进入你的项目目录：`cd ~/projects/your-project`

启动 Codex：`codex`

如果你要明确指定 GPT-5.5，可以这样：`codex --model gpt-5.5`

如果你的中转站模型名不是 `gpt-5.5`，而是类似 `gpt-5.5-codex`、`openai/gpt-5.5`、`gpt-5.5-2026`，那就按照中转站提供的模型名填写，比如：`codex --model gpt-5.5-codex`

**进入 Codex 后的建议：** 第一句话不要直接让它改代码。可以先让它读项目：

```text
请先不要修改代码。帮我阅读当前项目，说明：
1. 项目使用了什么技术栈
2. 主要目录分别是做什么的
3. 本地如何启动
4. 核心模块在哪里
5. 如果我要二次开发，建议先看哪些文件
```
这样比较稳。

### 十一、Codex 常用命令

下面这些命令可以先记住：

- 查看版本：`codex --version`
- 启动 Codex：`codex`
- 指定模型启动：`codex --model gpt-5.5`
- 进入某个项目：`cd your-project` 然后 `codex`
- 查看 Git 状态：`git status`
- 查看 AI 修改了什么：`git diff`
- 新建测试分支：`git checkout -b codex-test`

运行/构建/测试项目的命令就看你的技术栈了，比如 `npm install`、`npm run dev`、`npm run build`、`go test ./...`、`pytest`、`mvn test` 等。

### 十二、第八步：在 VS Code 里使用 Codex 插件

除了终端，你也可以在 VS Code 里使用 Codex。

打开 VS Code，点击左侧扩展市场，搜索“Codex”，找到发布方是 OpenAI 的“Codex - OpenAI's coding agent”，点击安装。

安装完成后，左侧会出现 Codex 图标。点击图标，登录或者读取本地配置。如果你已经通过 cc-switch 启用了 Codex Provider，通常可以直接使用对应配置。

如果没有生效，可以尝试：关闭 VS Code → 确认 cc-switch 已启用 Provider → 重新打开 VS Code → 再打开 Codex 插件。

### 十三、在 VS Code 里的使用方式

打开一个项目文件夹（File → Open Folder 或者命令行 `code .`），然后在 Codex 面板里输入指令。

如果要修 bug：先把报错贴给它，让它先分析原因、给出相关文件、修改方案，确认后再修改。

如果要开发功能：把需求（比如“增加一个商品筛选功能，支持按名称搜索、按分类筛选、不影响原有分页”）写清楚，让它先告诉你准备改哪些文件，确认后再动手。

**原则就是：先分析，再修改。先小改，再看 diff。**

### 十四、第九步：在 Cursor 里使用 Codex 插件

Cursor 本身就是 VS Code 的分支，所以也可以安装 Codex 插件。打开 Cursor，进入扩展市场，搜索“Codex”，找到 OpenAI 官方的插件，点击安装，完成后重启 Cursor。

然后打开你的项目（`cursor .` 或 Open Folder），找到左侧 Codex 图标。如果图标没显示，可以在扩展列表里确认 Codex 是否启用。

在 Cursor 里使用 Codex 的好处是：Cursor 自己有 AI 能力，Codex 又是另一个项目级 coding agent。你可以根据任务选择：小改动用 Cursor 内置 AI，复杂项目任务用 Codex，需要终端执行用 Codex CLI。

### 十五、Codex CLI、VS Code、Cursor 怎么选？

- **命令行用户推荐 Codex CLI**：适合后端项目、脚本项目、服务器项目、喜欢终端的人。
- **前端/全栈开发推荐 VS Code + Codex 插件**：适合边看代码边问 AI、边改 UI 边调试、习惯插件生态的人。
- **已经在用 Cursor 的推荐 Cursor + Codex 插件**：适合已有 Cursor 工作流，想同时使用 Cursor 内置 AI 和 Codex 的人。

**我的建议是：新手先用 VS Code / Cursor 插件，熟悉后再用 Codex CLI，重度开发者两个都装。**

### 十六、cc-switch 在这里到底起什么作用？

很多人会问：我都装了 Codex，为什么还要 cc-switch？

可以这样理解：**Codex 是干活的人，API 中转站是模型服务，cc-switch 是配置开关。** 它帮你管理 API Key、Base URL、模型名、Provider，以及不同工具的配置一键切换。

如果你只用官方 ChatGPT 登录，确实不一定需要 cc-switch。但如果你有多个中转 API（官方 OpenAI、自己的中转 API、Claude 中转、Gemini 中转等），手动改配置会很麻烦。cc-switch 的价值就是：**不用每次手动改配置文件，点一下就能切。**

### 十七、推荐配置方式

如果你的中转站支持 GPT-5.5，建议这样配置：

- Provider 名称：GPT-5.5 Codex
- Base URL：`https://你的中转站域名/v1`
- API Key：`sk-xxxxxxxx`
- Model：`gpt-5.5`
- 应用：Codex

如果要给 Claude Code 兼容使用，可以再建一个 Claude Code Provider。新手不要一上来搞太复杂，建议先跑通这条链路：**中转站 API Key → cc-switch → Codex CLI**，确认没问题后，再接 VS Code、Cursor 等。

### 十八、使用 GPT-5.5 的建议

GPT-5.5 适合复杂 coding 任务，比如复杂项目阅读、多文件重构、疑难 bug 分析、代码迁移、单元测试补充、接口改造、技术方案生成。

但不是所有任务都要用 GPT-5.5。简单总结代码、改 README、生成注释、写小脚本，用小模型也可以。

我的习惯是：读项目用小模型或 GPT-5.4，改核心代码用 GPT-5.5，复杂 bug 用 GPT-5.5，写测试用 GPT-5.5 或 GPT-5.4，总结文档用小模型。这样成本和效果会比较平衡。

### 十九、真实使用时的标准流程

每次使用 Codex 都按这个流程来：

1. 进入项目：`cd your-project`
2. 新建分支：`git checkout -b codex-test`
3. 启动 Codex：`codex --model gpt-5.5`
4. 让它先读项目（输出技术栈、目录结构、启动方式、核心模块）
5. 让它分析需求（先分析应该改哪些文件，不要直接修改）
6. 确认方案（你看一下它准备改哪些文件）
7. 让它小范围修改（要求尽量少改动、保持原有风格、修改后说明改了哪些文件、执行命令前先询问你）
8. 查看 diff：`git diff`
9. 运行测试（比如 `npm test` 或 `npm run build`）
10. 确认没问题再提交：`git add .` 然后 `git commit -m "feat: add xxx by codex"`

这个流程虽然多几步，但很稳。**不要让 AI 一把梭。**

### 二十、常见问题

**1. 点击导入 cc-switch 没反应怎么办？** 先确认 cc-switch 已经安装并启动。浏览器提示是否打开 cc-switch 时要点击允许。如果还是不行，可以手动复制配置，在 cc-switch 里添加 Custom Gateway。

**2. cc-switch 启用后 Codex 没生效怎么办？** 确认 Provider 已启用，关闭当前终端重新打开，重新执行 codex，检查模型名是否写对、Base URL 是否带 `/v1`、API Key 是否有效。很多时候是终端环境变量没刷新。

**3. Base URL 怎么写？** 大多数 OpenAI Compatible 接口是 `https://你的域名/v1`（比如 `https://api.example.com/v1`）。不要写成 `https://api.example.com`，也不要多写成 `https://api.example.com/v1/chat/completions`。一般只填到 `/v1`。

**4. 模型名写什么？** 以中转站模型列表为准。模型列表里叫什么就填什么，不要凭感觉乱写。

**5. VS Code / Cursor 插件不走 cc-switch 怎么办？** 先确认你在 cc-switch 里启用的是 Codex 相关 Provider，然后完全退出 VS Code / Cursor 再重新打开。如果仍然不生效，可以先用 CLI 测试：`codex --model gpt-5.5`，CLI 跑通后再排查插件。

**6. Codex 可以直接改生产项目吗？** 不建议。最起码要做到：使用 Git、新建分支、小步修改、看 diff、跑测试、人工 review。AI 可以帮你提效，但不要让它无保护地改生产代码。

### 二十一、我推荐的最终组合

如果你是个人开发者，建议装：cc-switch、Codex CLI、VS Code Codex 插件、Cursor Codex 插件。

如果你经常写后端：Codex CLI 为主，VS Code / Cursor 为辅。  
如果你经常写前端：Cursor / VS Code 为主，Codex CLI 为辅。  
如果你经常折腾多个模型服务：cc-switch 必装。

最终结构大概是：API 中转站 → API Key → cc-switch → Codex CLI / VS Code / Cursor → GPT-5.5 辅助开发。

### 二十二、最后总结

这套方案看起来步骤有点多，但理解之后其实很简单。

- API 中转站负责提供模型能力。
- cc-switch 负责管理和切换模型配置。
- Codex 负责进入项目干活。
- VS Code / Cursor 负责提供更顺手的开发界面。

完整链路就是：注册中转站 → 创建 API Key → 导入 cc-switch → 启用 Provider → 安装 Codex → 打开项目 → 开始使用 GPT-5.5 写代码。

我比较建议大家不要只把 AI 当成聊天工具。真正能提升效率的方式，是让它进入你的真实开发流程：读项目、分析需求、改代码、跑测试、看 diff、写文档。

但同时也要记住一点：**AI 可以执行，最终拍板的人还是你。** 尤其是涉及生产环境、数据库、支付、权限、部署这些敏感操作，一定要人工确认。

如果你是第一次尝试，可以先找一个测试项目。先让 Codex 读项目，再让它修一个小 bug，最后让它做一个小功能。跑通这一遍，你基本就能理解：为什么 AI 编程工具正在从“问答助手”变成“开发智能体”。

Codex 能不能配合 cc-switch 使用 GPT-5.5？能不能像 Claude Code 一样，直接切换不同的模型服务？

Codex + cc-switch + GPT-5.5 国内免魔法使用教程：从注册 API 到接入Windown/macOS 桌面版，小白也能看懂

人工智能

开发工具

客户端

Codex可配合cc-switch使用GPT-5.5，实现多模型服务切换。cc-switch作为本地AI编程工具管理器，支持统一配置ClaudeCode、Codex等工具。教程详细讲解从安装cc-switch到在VSCode/Cursor中使用GPT-5.5的全流程，适合开发者统一管理多个API服务，提升AI编程效率。

单元测试

数据库

服务器

智能体

OpenClaw

Windows

ChatGPT

Linux

2026年中大促 | AI 领航 智绘未来

tione

热销域名限时优惠，新客首年免费！


domain

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

Codex + cc-switch + GPT-5.5 国内免魔法使用教程：从注册 API 到接入Windown/macOS 桌面版，小白也能看懂-腾讯云开发者社区-腾讯云

Codex + cc-switch + GPT-5.5 国内免魔法使用教程：从注册 API 到接入Windown/macOS 桌面版，小白也能看懂

Codex + cc-switch + GPT-5.5 国内免魔法使用教程：从注册 API 到接入Windown/macOS 桌面版，小白也能看懂

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐