Codex 小白指南（完整版）

一、先搞懂 Codex 是什么

1.1 一句话理解

很多人第一次听到 Codex，会下意识把它当成"又一个 AI 写代码工具"。但如果只把它当成"帮我写代码的 ChatGPT"，你很容易低估它。

AI 编程工具的进化，简单说就是四步走：

一句话总结：Copilot 帮你补代码，ChatGPT 帮你想代码，Cursor 陪你改项目，而 Codex 开始帮你执行工程任务。

1.2 它和别的 AI 工具有什么区别

Codex vs ChatGPT：ChatGPT 像"顾问"（你问它，得到答案，然后自己去执行）；Codex 像"实习生"（你交代任务，它真的去干活、把活干完）。合理用法：先用 ChatGPT 想清楚，再用 Codex 做项目执行。

Codex vs Cursor：Cursor 像"AI 编辑器"，Codex 像"工程 Agent"。合理用法：用 Cursor 做日常编码和局部修改，用 Codex 做任务推进和工程交付。

Codex vs Claude Code：Claude Code 更像"终端里长期协作的 AI 工程搭档"（命令行、深度上下文、hooks/subagents 扩展）；Codex 更偏"OpenAI 生态里的多端工程 Agent"（App、CLI、IDE、Web 多个入口流转）。通常：喜欢终端长期协作选 Claude Code；已在用 ChatGPT/OpenAI 生态、想多端切换选 Codex。

1.3 Codex 能做什么（适合的任务）

Codex 真正擅长的，是在真实项目里完成一组工程任务，大致分几类：

• 读懂陌生项目：技术栈、入口文件、核心模块、测试/构建命令、哪些文件不能随便动。
• 解释代码、梳理逻辑：这个函数干嘛的、接口调用链路、状态从哪来、这个 bug 可能和哪些文件有关。
• 修 bug / 加功能：可复现 bug、新增设置页、加表单校验、加接口、加导出按钮、优化前端页面。
• 写测试、做重构：补单元测试、提取重复逻辑、拆分过长函数、封装 API 请求（但必须加边界，见下）。
• 写文档、整理 PR：README、安装说明、接口文档、PR 描述、commit message、更新日志。
• 跑命令、看 diff、做 review：运行测试/lint/typecheck/build，查看 git 状态与改动，检查修改结果。

1.4 什么时候不适合直接交给它

不建议直接让 Codex 处理：

• 生产数据库、真实用户数据
• 支付核心逻辑、权限和安全核心模块
• 大规模架构迁移
• 没有备份的重要项目、没有测试的核心业务
• 你自己也无法验收的任务

1.5 四个使用入口

二、安装前准备

2.1 账号准备（个人用户）

• 一个 ChatGPT 账号
• 能正常访问 ChatGPT / OpenAI 服务的网络
• 选择当前包含 Codex 的 ChatGPT 套餐（名称、额度、功能范围会变化，以官方页面和你账号显示为准）

2.2 系统准备

• Codex App：支持 macOS 和 Windows
• Codex CLI：支持 macOS、Windows 和 Linux

2.3 软件工具准备

2.4 项目目录准备（很重要）

Codex 不是单纯聊天工具，它需要进入一个具体项目目录工作。官方入门流程也是：登录后选择电脑上的文件夹或 Git 仓库，再开始第一个任务。

建议提前建一个专门练习目录，例如 D:\AI-Codex-Projects（Windows）或 ~/AI-Codex-Projects（Mac），里面放练习项目：

AI-Codex-Projects/
├── hello-web/
├── ai-tools-page/
└── landing-page-demo/

2.5 权限与安全准备（必看）

Codex 可以读取、修改文件，还能在项目目录里运行命令。所以安装前要注意：

推荐每个项目先初始化 Git：

git init
git add .
git commit -m "initial commit"

这样 Codex 改坏了也可以回退。

三、选哪个入口：四种形态对比

各入口在文档站也有独立介绍：快速开始、Codex CLI 使用指南。

四、第一次上手

4.1 Codex App（新手最推荐）

下载与安装

macOS 安装

1. 点击左上角苹果图标 →「关于本机」，确认芯片类型：Apple M1/M2/M3/M4 → 选 Apple Silicon 版本；Intel → 选 Intel 版本。
2. 进入 Codex App 官方页面，下载对应版本，打开安装包，把 Codex 拖进「应用程序」文件夹。
3. 第一次打开若提示"从互联网下载的应用"，选择「打开」即可。

Windows 安装

1. 进入 Codex App 官方页面，选择 Windows 版本。
2. 一般会跳转到 Microsoft Store 安装，点击「获取」或「安装」即可。

第一次打开

登录完成后，系统会让你选择一个项目目录。可以理解为：Codex 要进哪个文件夹工作。

• 新手建议第一次选一个干净的练习目录（如 hello-codex），不要直接选 C 盘，也不要一上来就选重要工作项目。
• 推荐结构：

  AI-Codex-Projects/
  └── hello-codex/
      └── index.html

必须懂的 6 个概念（用"公司"来类比）

第一次推荐操作流程

1. 登录 ChatGPT
2. 选择一个练习项目目录
3. 新建或选择一个 thread
4. 在任务窗口输入一个简单任务
5. 等 Codex 修改文件
6. 打开 Review Pane
7. 查看 diff
8. 确认没问题后再继续修改

推荐第一个任务（足够简单，用来熟悉流程）：

请帮我做一个简单网页，要求：
1. 黑色背景
2. 页面中间显示大字 Hello, Codex
3. 字体白色
4. 页面整体水平和垂直居中
5. 只使用 HTML 和 CSS

关于 Diff（最重要的一步）

Diff 是代码改动对比。绿色 = 新增内容，红色 = 删除内容。

等待批准 / 归档

• 等待批准：Codex 执行任务时经常需要你权限批准，会在对话处提示"等待批准"，点击允许后继续。
• 归档（Archive）：把已完成、暂时不用的 thread 收起来，让任务列表更干净（不是删除代码，也不是合并代码）。

设置里要关注的两点

• 剩余额度：查看当前账号额度、速率限制或使用情况（具体以界面为准）。
• 对话窗口 / 权限控制：见下一章。

4.2 Codex CLI（命令行版）

安装

macOS / Linux（两种常见方式）

方式一：npm 安装（已装 Node.js 推荐）

node -v      # 确认 Node.js 已装
npm -v
npm install -g @openai/codex
codex --version

方式二：Homebrew（Mac）

brew install --cask codex
codex

Windows

node -v
npm -v
npm install -g @openai/codex
codex --version

另一种安装方式（来自官方文档站）：

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

第一次运行与登录

codex          # 启动，首次会提示登录

两种登录方式：

1. 用 ChatGPT 账号登录（小白首选）：codex login → 选 Sign in with ChatGPT → 浏览器打开登录页 → 登录后回传终端。
2. 用 OpenAI API Key 登录（开发者/自动化/CI）：设置环境变量后 codex login --with-api-key。

codex login status     # 检查登录状态
codex logout          # 退出登录

新手最该记住的 10 个终端命令

推荐新手工作流：

cd 项目目录
git status
codex                 # 启动，输入任务
/diff                 # 看改动
git diff              # 再在 Git 里检查一次
git add .
git commit -m "说明"
codex archive         # 或 /quit 退出

TUI 常用命令（进入 Codex 后输入，以 / 开头）

新手最该记住的 8 个：

推荐 CLI 使用流程：

/init → /permissions → /model → /plan → 输入任务 → /diff → /review → /status → /compact → /quit

三种核心能力（CLI）

• 编码闭环：在同一会话讨论任务、检查计划、编辑代码、运行命令并评审最终 diff。
• Skills 与 Plugins：用 /skills 选择本地 skill，/plugins 浏览插件，只启用当前任务需要的能力。
• 发布前评审：运行 /review 启动独立评审，结合仓库的 lint、类型检查、测试和构建完成验证。

危险命令与危险参数（看到先问）

看到这些内容，先让 Codex 解释：

请解释这条命令的作用、风险，以及有没有更安全的替代方案。

4.3 Codex IDE Extension（编辑器插件）

把 Codex 直接装进 VS Code / Cursor / Windsurf 的侧边栏里使用。

安装步骤：打开编辑器 → 扩展市场 → 搜索 Codex → 安装 OpenAI 的 Codex 扩展 → 重启编辑器 → 侧边栏找到 Codex → 登录账号 → 打开项目文件夹开始使用。

能做什么：读当前文件、读选中代码、直接改代码、运行命令、修复报错、生成文档、切换模型、调整推理、控制权限、委托云端。

支持编辑器：VS Code、VS Code Insiders、Cursor、Windsurf、JetBrains 系列（IntelliJ / PyCharm / WebStorm / Rider）。新手优先推荐 VS Code 或 Cursor。

4.4 Codex Web / Cloud（网页云端）

在网页里使用，连接 GitHub 仓库，让 Codex 在云端环境读取代码、执行任务、修改文件，并生成可 review 的结果。

• 入口：chatgpt.com/codex
• 流程：登录 ChatGPT → 连接 GitHub → 选仓库 → 选分支 → 输入任务 → 等云端运行 → 看结果和 diff → 满意后创建 Pull Request（PR）
• 小白建议：刚开始做本地练习用 Codex App；项目放到 GitHub 后，再学 Codex Web。
• 关键概念：Repository（仓库）= 放在 GitHub 上的项目文件夹；Branch（分支）= 代码的独立版本；PR = 把修改后的版本提交给你检查。

五、安全与权限（一定要看）

5.1 沙盒（Sandbox）= Codex 的安全围栏

Codex App 不是普通聊天工具，它能读文件、改文件、运行命令，所以必须有一个"围栏"限制它能碰哪里、能不能联网、能不能改项目外的文件。

官方 sandbox 模式包括 read-only、workspace-write、danger-full-access 几类。对应关系：

5.2 推荐的权限组合

CLI 新手推荐：

codex --sandbox workspace-write --ask-for-approval on-request

意思是：Codex 可以在当前项目里工作，但敏感操作要先问我。

• sandbox: workspace-write = 允许在当前项目里工作
• approval: on-request = 敏感操作先问你

5.3 API Key 保护

• 用 .env 文件存放密钥，且不要上传到 Git/GitHub（配合 .gitignore）。
• 不要把 API Key：写进代码、发别人、截图公开、上传 GitHub、放进 README、放进前端网页、提交 Git 仓库。
• 泄露立刻去 OpenAI Platform 删除或重新生成。

5.4 用 Git 兜底（最重要的一条安全习惯）

没有 Git，Codex 改错了你很难回退；有了 Git，你可以随时检查和恢复。

git init
git add .
git commit -m "initial commit"
# Codex 每次改完：
git status      # 看哪些文件变了
git diff        # 看具体变了什么
# 不满意：git checkout / 让 Codex revert

六、模型、推理强度与额度

6.1 推荐模型

当前主力是 gpt-5.6 系列（Sol / Terra / Luna），上一代 gpt-5.5 仍可继续用。下表「不支持」列标出该模型当前无法运行在哪类任务上。

默认 Power 设置使用 gpt-5.6-sol + 中等推理强度；需要更深入推理转向 Powerful；想更快更省转向 Efficient；选 gpt-5.6-luna 或自选模型/强度请打开 Advanced。

6.2 怎么选 Sol / Terra / Luna

• Sol：复杂、开放式工作。模糊、困难或高价值任务，需要分析、判断或打磨。
• Terra：务实通用。过去交给 GPT-5.5 的日常工作，可优先从 Terra 开始。
• Luna：清晰、可重复。提取、分类、转换、结构化摘要等高吞吐任务。

6.3 App 的 Power 模式与模型对应

桌面 App 把"模型 + 推理强度"打包成几个易懂档位，不用手动调参：

6.4 选择推理强度

优先用能产出所需结果的最低推理强度；只有需要时再提高。强度越高越慢、越费额度。

• Max：给所选模型更多时间深入推理，适合最困难且深度优先的问题。
• Ultra：用子智能体并行处理可拆分的复杂任务；大多数任务并不需要。

6.5 配置默认本地模型

桌面 App、CLI 与 IDE 扩展共用同一个 config.toml。指定模型：

model = "gpt-5.6"

未指定时使用推荐模型。云端任务目前无法更改默认模型。

6.6 套餐与额度

Codex 已包含在你的 ChatGPT Free / Go / Plus / Pro / Business / Edu / Enterprise 套餐中，两者共享使用量。额度与功能可用性取决于计划、地区与工作区设置。

使用限制 / 额度

• 能发多少条 Codex 消息，取决于模型、任务规模复杂度，以及任务在本地还是云端运行。
• 本地消息与云端任务共享一个五小时窗口，可能还有额外每周限制。
• 进行中的会话轮次若达到限制，在公平使用限制内智能体仍可完成该轮工作。
• Plus / Pro 用户达到限制后可购买额外 credits，无需升级计划。

本地消息额度估算（每 5 小时窗口）

Credits 费率（示例，每百万 token）

功能可用性差异（节选）

七、核心功能详解

7.1 自动化

Codex 自动化 = 让 Codex 不只是"听你指挥"，而是能按规则定期帮你巡查项目、发现问题、处理问题。就像给项目请了一个"AI 值班工程师"：平时不打扰你，有问题来提醒，简单问题先尝试修，最后让你审核决定。

示例：让 Codex 每周复盘近期会话记录，沉淀成可复用的工作流档案（注意：不要复现原始日志、隐私内容、密钥、长对话原文）。

7.2 插件 / Skill / MCP —— 最容易混淆的三个概念

记住一张总表：

7.3 Skill（固定工作方法）

如果你经常让 Codex 做同一类任务（写 README、做代码 Review、生成网页、整理文档），就可以把这套流程做成 Skill。

当请求与 skill 用途匹配时，ChatGPT 可自行选择该 skill；也可从输入框显式选择。ChatGPT 支持 @ 提及，Codex 支持用 $ 提及 skills。

最简单的 SKILL.md 结构：

# Skill 名称
## 适用场景
## 工作目标
## 工作流程
## 输出格式
## 注意事项

怎么用：

• 用已有 Skill：在 Codex CLI 输入 /skills，或直接用 $readme-skill 这样的名字调用。
• 用 $skill-creator 创建：告诉它你想创建什么 Skill、触发场景、工作流程、输出格式、限制，它会帮你生成 SKILL.md。
• 手动创建：在项目 .agents/skills/技能名/SKILL.md 写文件。

放置位置：

• 项目里的 .agents/skills → 只给当前项目用
• 用户级 Skill 目录 → 多个项目通用
• 团队 / 管理员配置 → 团队共享
• 插件里 → 打包分发给别人安装

创建 skills（四步）

1. 选择一项聚焦任务。记录你通常会提供的文件、链接或笔记，以及完成结果应达到的样子。
2. 向 ChatGPT 描述工作流。新建聊天，以 "Build me a skill…" 开始，说明目标、执行步骤、预期格式，以及始终包含或避免的内容，可附模板或优质示例。
3. 评审并试用草稿。检查指令，用真实请求测试；若遗漏步骤或偏离格式就继续调整。
4. 安装并复用。启用后 ChatGPT 可在相关请求中使用该 skill，也可显式选择；工作区允许时还能分享给团队成员。

7.4 插件（能力包）

plugins 让可复用能力更容易安装和共享，可把 skills 与 GitHub / Google Drive / Slack 等服务的 app 组合，也可包含提供额外工具与上下文的 MCP server。安装后可直接描述任务，或输入 @ 选择具体 plugin 或其中的 skill。

在 Codex App 里：打开 App → 搜索/浏览插件 → 点开详情 → 点 Add to Codex → 新开一个 thread 使用。

在 Codex CLI 里：启动 codex → 输入 /plugins → 搜索、Install、Uninstall、Space（启停）。

常见能力方向：Chrome（操作浏览器）、GitHub（仓库协作）、Computer Use（操作电脑）、Build Web Apps（一句话生成网页）、Figma（设计稿转代码）、Documents / Presentations / Spreadsheets（办公交付）、HyperFrames / Remotion（视频生成）。

7.5 MCP（连接外部工具的接口）

MCP 让 Codex 连接更多外部工具、数据源或服务（文档 MCP、数据库 MCP、GitHub MCP、Figma MCP、Notion MCP、浏览器 MCP 等）。

CLI 常用命令：

codex mcp list                       # 查看已配置
codex mcp add context7 -- npx -y @upstash/context7-mcp   # 添加
codex mcp remove context7            # 删除
/mcp                                 # 会话内查看可用工具

配置写在 ~/.codex/config.toml。新手建议先用于不需要复杂授权的文档类 MCP。

7.6 记忆系统（AGENTS.md）

让 Codex 记住长期有用的信息。AGENTS.md 是写给 Codex 看的项目规则说明书。

放在哪里：

• 项目根目录 AGENTS.md → 整个项目的总规则
• 子目录里的 AGENTS.md → 某个模块的专属规则
• 用户级 ~/.codex/AGENTS.md → 你所有项目的个人通用规则

可以在 Codex App 设置里找到"个性化 / 指令"，输入个人通用偏好（例如：禁止批量删除文件或目录，需要删除时一次只删一个明确路径的文件）。

一个前端项目 AGENTS.md 模板要点：写清技术栈、常用命令（install/dev/build）、项目结构、代码规范、UI 规则、禁止事项（不改 .env、不输出密钥、不删核心功能、不随便加依赖）、完成任务后输出"改了哪些文件 / 为什么 / 是否要 build / 提醒检查 diff"。

7.7 代码管理（Git 与 GitHub）

Git Worktree：给同一个 Git 项目额外开一个独立工作副本（像草稿本），效果满意后再合并回正式项目。适合让 Codex 大胆改代码、同时做多个任务、比较大方案 A/B/C、降低污染主项目的风险。

在 Codex 中使用 Git 的标准流程：

初始化 Git → 写好 .gitignore → 先 commit 一次 → 新建分支 → 让 Codex 修改 → 查看 diff →
运行项目/构建 → 满意后 commit → push 到 GitHub → 创建 PR

7.8 云端运行（Cloud）

云端运行适合：你不方便一直开着本地电脑时继续处理；适合修 bug、改功能、写文档、代码 review、处理 issue。不适合：本地私密文件、没上传 GitHub 的项目、高风险生产操作。

更多 Skill 与 Plugin 细节见 技能与插件 页；CLI 命令见 Codex CLI 使用指南。

八、标准工作流：六步法

很多人刚开始用 Codex，会直接一句话丢给它"帮我做个网站 / 改这个功能"。这样不是不行，但容易出问题：AI 改得很快，你却不知道它到底改了什么，也不敢放心交付。

真正稳定的方式，是让需求经过 "理解 → 计划 → 修改 → 验证 → 检查 → 验收" 这几步。

标准六步

第一步：需求拆解

别只说"优化首页"。先把需求拆成关键问题：

• 背景是什么：项目处于什么阶段、遇到什么情况、为什么现在要改、属于什么类型（UI / Bug / 新功能 / 重构）。
• 要解决什么具体问题：把"优化首页"改成"优化首页首屏标题、副标题和 CTA 按钮"。
• 哪些文件可能相关：提前告诉 Codex（如 app/page.tsx、components/Hero.tsx）。
• 哪些功能不能动：登录逻辑、接口地址、数据结构、路由结构、已有组件、依赖版本。
• 什么结果算完成：UI 优化 / Bug 修复 / 新功能 / 性能优化 各自的完成标准。
• 需要哪些测试：页面预览、控制台检查、构建测试、单元测试、手动流程、移动端。
• 有哪些风险：影响范围过大、样式污染、依赖风险、逻辑风险、数据风险、兼容风险。

第二步：让 Codex 制定计划

先不要写代码。让 Codex 先输出计划，你确认后再执行：

先不要写代码，也不要修改任何文件。
请先根据当前需求和项目结构，制定一个修改计划。等我确认后，再开始执行。

（也可以在 App / CLI 里用 /plan 进入计划模式。）

第三步：小步实现

一次只改一个功能点。 比如优化首页拆成：①只优化首屏标题副标题 ②只调整 CTA 按钮 ③只优化移动端布局 ④只补充卖点卡片 ⑤只处理最终样式细节。

明确限制：

本次只实现当前功能点。
不要顺手重构无关代码。
不要修改命名、目录结构、依赖版本和全局配置。
如果遇到不确定，请先停下来问我，不要自行决定。

第四步：测试

不是相信 Codex 说"完成"，而是用结果证明它真的完成。按顺序：

1. 单元测试：npm test / pnpm test
2. 类型检查：npm run typecheck / tsc --noEmit
3. lint：npm run lint
4. 构建：npm run build
5. 手动测试：UI、表单、登录、支付、上传必须手动点一遍
6. 浏览器测试：看页面显示、Console 报错、Network、移动端
7. 回归测试：不只测新功能，还要测旧功能有没有被改坏

第五步：代码审查

两轮审查：Codex 自审 + 人工审查。最终交付的人是你，不是 Codex。重点盯 diff 的四类高风险：

• 边界条件：空数据、接口失败、未登录、权限不足、移动端尺寸、重复点击
• 安全问题：是否暴露密钥/token、权限判断是否缺失、输入是否校验
• 是否误删：看似没用、实际有用的代码被删（旧组件、fallback、配置项）
• 业务逻辑：代码能跑但逻辑错（跳错页、价格算错、越权）

第六步：提交与复盘

交付不是结束，复盘才是下一次效率提升的开始。

• 生成 commit：用 conventional commit 格式（feat: / fix: / style: / refactor: / docs:），说明改了什么、为什么、影响哪里、是否通过测试。
• 写 PR：说明本次修改、原因、涉及文件、测试结果、风险、需要 reviewer 重点看的地方。
• 记录问题：这次过程中遇到什么问题、原因、如何解决、下次如何避免。
• 沉淀 Prompt：好用的提示词（如"不要顺手重构无关代码"）记下来，以后作为固定规则。
• 更新 AGENTS.md：以后每次都要遵守的规则，写进项目级 AGENTS.md。

九、实战案例库

以下案例来自《Codex 橙皮书》，均以"宠物零零食"项目演示，核心流程一致，供你照搬。

案例一：制作宠物零零食前端页面网站

1. 本地创建文件夹 Pet treats，选择该文件夹。
2. 开启计划模式，生成初步项目计划，确认后执行。
3. 打开 index.html 预览，用注释功能在页面做细节修改。
4. 创建 Git 仓库管理代码。
5. 新增"月销量 / 热销榜"等功能。
6. 检查没问题后 push 代码，上传到 GitHub 仓库。
7. 通过 GitHub Pages 发布（Settings → Pages → 保存，等几分钟得到链接）。

案例二：给网站增加功能和优化页面

• 新建用户登录注册页面（购买需保存地址信息）。
• 创建宠物分类并在分类下做食品分类（先用计划模式确认 AI 理解需求）。
• 用注释功能优化细节；加入购物车后点击购买提示确认地址；提交 Git 保存。

案例三：制作管理后台

• 先使用计划模式 → 检查效果 → 提交 Git 保存代码。

案例四：制作品牌招商 PPT

• 安装 PPT Skill（把 GitHub 上对应 Skill 地址发给 Codex 让它安装）。
• 用 / 选择对应 Skill，生成完整招商 PPT，下载查看。

案例五：制作宣传视频

• 安装视频插件（如 HyperFrames）。
• 计划生成视频 → 效果预览 → 得到成品宣传视频。

十、附录

10.1 常见问题排查

安装类

• codex --version 没输出 → 没装好，重新安装
• command not found → 命令没加入 PATH，重开终端或重装
• Windows 安装后找不到命令 → PowerShell 没刷新环境变量，关闭重开

登录类

• 不知道有没有登录 → codex login status
• 浏览器没自动打开 → codex login --device-auth
• API Key 登录失败 → 检查 OPENAI_API_KEY 环境变量

项目目录类

• Codex 看不到项目文件 → 先 cd 项目目录
• Codex 读错文件 → 退出后进入正确目录重启
• 一句话：你在哪个目录运行 codex，它就默认把那个目录当项目。

权限和沙盒类

• 提示需要批准 → 看懂后再允许
• 不能联网 → 沙盒限制，需要时手动批准
• 推荐设置：sandbox: workspace-write + approval: on-request

命令运行类

• npm run dev 失败 → 先看 package.json
• 命令卡住 → 用 /ps 查看后台任务，/stop 停止

Diff 和改动类

• 不知道改了什么 → 输入 /diff
• 改动太多 → 要求最小改动
• 删了重要代码 → 用 Git 恢复或让它 revert

通用排查流程：

codex --version → codex login status → pwd/cd 确认目录 → git status →
codex doctor → /permissions → /diff → /ps → /stop → /compact

10.2 第三方模型接入（CC Switch + DeepSeek，非官方）

CC Switch 是第三方开源桌面工具，用来统一管理不同 Agent 工具（Claude Code、Codex、Gemini CLI 等）的配置，核心用途：Provider 切换、MCP 统一管理、Skills 管理。

以接入 DeepSeek 为例：

1. 进入官网 https://ccswitch.io/zh/ 下载安装。
2. 在 DeepSeek 官网创建 API Key。
3. 打开 CC Switch → 添加模型 → 粘贴 API Key。
4. 开启本地路由映射（设置里将路由全部打开）→ 启用。
5. 若 CC Switch 路由、模型服务和 Codex 侧配置都兼容，再打开 Codex 就可能通过这套非官方路由使用 DeepSeek 等第三方模型。

10.3 术语表