Codex桌面版入门：接入DeepSeek跑通第一个项目任务

很多人第一次听到 Codex，会以为它只是又一个 AI 聊天工具。但 Codex 真正有价值的地方不在于陪你聊天，而在于它能进入你的项目目录，读取文件、理解代码、修改内容、运行命令，然后根据结果继续修正。这才是它与普通聊天机器人的本质区别。

从技术架构上看，Codex 属于一类被称为「AI 编程代理」（Coding Agent）的工具。与传统的对话式 AI 不同，编程代理具备工具调用能力（Tool Use）——它不仅能生成文本回复，还能调用文件系统读写、终端命令执行、代码解析等一系列外部工具。Codex 在运行时会为每个任务创建一个隔离的沙箱环境，在这个环境中读取你的项目文件、执行修改、运行测试命令，并根据命令的输出结果判断下一步操作。这种「感知环境 → 采取行动 → 观察结果 → 继续推理」的循环，正是 Agent 范式的核心特征，也是它能真正「做事」而不只是「说话」的根本原因。

本文面向零基础新手，只解决一个核心问题：怎么安装 Codex 桌面版，怎么接入 DeepSeek，然后怎么让它在你的项目里完成第一个小任务——跑通一个完整闭环。

开始之前：你需要准备三样东西

在动手之前，请确认以下三个前置条件已经就绪：

1. Codex 桌面版：新手更建议先用桌面版，因为它的界面更直观，可以清晰看到项目、对话、权限和任务状态，不用一上来就面对命令行。
2. CC Switch（建议 3.16.1 或更新版本）：这个版本可以在 Codex 菜单里直接配置 DeepSeek，省去了很多手动填写的麻烦。CC Switch 本质上是一个本地 API 代理和路由工具。Codex 桌面版默认只支持 OpenAI 官方的 API 接口，如果你想使用 DeepSeek 等第三方模型，就需要一个中间层来做「翻译」和「转发」。CC Switch 的作用就是在你的本地机器上启动一个代理服务，拦截 Codex 发出的 API 请求，将其重定向到 DeepSeek 的 API 端点，同时处理好认证、模型映射等细节。你可以把它理解为 Codex 和 DeepSeek 之间的一座桥。
3. 一个 DeepSeek API Key：后面会把它填到 CC Switch 里，让 Codex 通过 DeepSeek 模型来工作。DeepSeek 是国内领先的大模型公司，其推出的 DeepSeek-V3 和 DeepSeek-Coder 系列模型在代码生成、代码理解和多轮推理任务上表现出色，尤其在性价比方面具有显著优势——API 调用价格远低于 GPT-4 等海外模型，非常适合个人开发者和学习者日常使用。你可以在 DeepSeek 开放平台（platform.deepseek.com）注册账号并创建 API Key，新用户通常会获得一定额度的免费调用量。

准备好这三样东西，我们就可以开始了。

第一步：安装 Codex 桌面版

Windows 用户可以从 Codex 官方页面进入下载，也可以直接跳转到 Microsoft Store 搜索 Codex，找到对应页面后点击安装即可。

安装完成后，先打开一次，确认 Codex 能正常进入主界面。如果卡在微软商店下载或者商店打不开，这属于系统环境问题，需要单独排查，本文暂不展开。

关键点在于：确认桌面版能正常启动，界面可以正常加载，这就算第一步完成了。

第二步：用 CC Switch 接入 DeepSeek（重点）

这一步是整个流程中最容易出错的环节，请务必按顺序操作。

添加 DeepSeek 供应商

打开 CC Switch 之后，进入 Codex 菜单，点击右上角的添加按钮，在供应商列表里选择 DeepSeek。

这里有一个重要建议：优先使用内置预设，不要一开始就手动填写配置。内置预设已经帮你处理好了 Base URL、模型名、环境变量等参数，手动填写反而容易出错。

这里解释一下这些参数的含义：Base URL 是 DeepSeek API 的服务地址（类似于 https://api.deepseek.com/v1），它告诉 CC Switch 应该把请求转发到哪里；模型名是你希望调用的具体模型标识（如 deepseek-chat 或 deepseek-coder）；环境变量则是 CC Switch 注入到 Codex 运行环境中的配置项，用于覆盖 Codex 默认的 API 端点设置。内置预设之所以推荐，正是因为它把这些容易填错的字段都预先配好了，避免了拼写错误、路径遗漏等常见问题。

选好之后，填入你自己的 DeepSeek API Key，然后点击「获取模型列表」。如果配置没问题，你会看到 DeepSeek 的模型被正确识别出来。确认模型后，保存并添加。

千万别漏掉：开启路由

这是一个非常容易被忽略的步骤。添加完 DeepSeek 之后，一定要开启路由。你可以在 CC Switch 主页启用 DeepSeek 路由，也可以进入设置页，在路由选项里确认 Codex 的路由开关已经打开。

所谓「路由」，在这里的含义是：CC Switch 需要知道哪些来自 Codex 的 API 请求应该被拦截并转发到 DeepSeek，而不是发送到默认的 OpenAI 端点。开启路由就是激活这条转发规则。如果路由没有开启，CC Switch 虽然已经保存了 DeepSeek 的配置信息，但实际上并不会对 Codex 的请求做任何处理——Codex 的请求仍然会尝试发往默认地址，自然就会失败或者返回错误。

开启路由之后，还需要正确重启 Codex，让新的配置生效。很多新手配置完发现不生效，往往就是卡在这一步——要么忘了开路由，要么忘了重启。重启的原因是 Codex 在启动时会读取环境变量和 API 配置，运行过程中不会动态刷新这些设置，所以修改配置后必须重启才能让新设置生效。

到这里，基础配置就全部完成了。

第三步：让 Codex 完成第一个项目任务

配置完成后，我不建议你第一次打开 Codex 就直接说「帮我做一个完整项目」。这类指令太大，新手也很难判断它到底做得对不对。更稳妥的做法是分三步走。

第一条指令：只做项目理解

打开你的项目后，输入：

请先阅读这个项目的目录结构，告诉我它是做什么的。不要修改文件，只做项目理解。

这一步的目的是确认 Codex 能正常读取你的项目，同时验证它是否真的理解当前代码。如果它能清晰地说出项目结构和功能，说明接入配置没有问题。

从技术角度看，当你发出这条指令时，Codex 会在后台调用文件系统工具，遍历项目目录、读取关键文件（如 package.json、README.md、入口文件等），然后将这些文件内容作为上下文传递给 DeepSeek 模型进行分析。这个过程验证了整条链路的畅通：Codex 桌面版 → CC Switch 路由 → DeepSeek API → 模型推理 → 结果返回 → 界面展示。任何一个环节出问题，你都能在这一步发现。

第二条指令：让它找一个小任务

确认项目理解没问题后，可以进一步说：

请帮我找一个适合新手修改的小任务，说明你准备改哪些文件。先不要动手。

让 Codex 先给出计划，你审核之后再让它执行。这个过程本身就是在建立你对 AI 协作的信任感。这种「先规划后执行」的交互模式在 AI Agent 领域被称为 Plan-then-Execute 范式，它的好处是让人类始终保持对任务的控制权——你可以在 AI 动手之前审查它的方案，发现不合理的地方及时纠正，而不是等它改完一堆文件之后再去善后。

第三条指令：执行第一个任务

第一个任务不需要太复杂，可以是：

• 修改 README 文件
• 调整一处页面文案
• 修一个简单报错
• 补一个很小的功能

关键不是任务多高级，而是跑通一个完整闭环：理解项目 → 提出计划 → 修改文件 → 运行检查命令 → 总结改了什么。

这个闭环在 AI Agent 研究中对应的是经典的**「感知-规划-执行-验证」循环**（Perceive-Plan-Act-Verify）。传统的代码补全工具（如早期的 Copilot）只覆盖了「执行」这一个环节——你写代码时它帮你补全下一行。而 Codex 作为编程代理，覆盖了完整的四个环节：它先感知项目环境（读取文件和目录），然后规划修改方案（分析需要改哪些文件、怎么改），接着执行修改（实际编辑文件），最后验证结果（运行测试或构建命令，检查是否有报错）。如果验证失败，它还会自动进入下一轮循环进行修正。这种端到端的自主工作能力，才是 AI 编程代理真正的价值所在。

只要这个闭环跑通，你就真正理解了 Codex 和普通聊天机器人的区别——普通聊天机器人更多是在回答问题，而 Codex 是进入你的项目，协助你把事情做完。

给新手的四个实用建议

基于实际使用经验，这里总结四条新手最容易踩坑的地方：

1. 不要一开始就做大项目：先从小任务建立信任。你需要先了解 Codex 的能力边界，才能在后续给出更精准的指令。AI 编程代理目前在处理局部、明确的任务时表现最好，而面对跨模块的大型重构或模糊需求时，仍然需要人类的拆解和引导。

2. 不要同时切太多模型：否则出了问题你分不清是模型的问题、配置的问题还是网络的问题。先用一个模型跑稳，再考虑切换。不同模型在代码任务上的表现差异很大——有的擅长生成新代码，有的擅长理解和解释已有代码，有的在长上下文推理上更强。等你对一个模型的能力有了清晰认知后，再对比其他模型才有意义。

3. 注意权限提示：Codex 要读文件、改文件、跑命令的时候，你要清楚自己允许了什么。这不是形式主义，而是对项目安全的基本保障。Codex 桌面版通常提供三种权限级别：只读模式（只能查看文件）、建议模式（可以提出修改但需要你确认）和自动模式（可以直接执行修改和命令）。新手建议从建议模式开始，等熟悉了 Codex 的行为模式后再考虑开放更高权限。

4. 失败时先检查自己：不一定是模型不行，也可能是你的指令太模糊、项目上下文不够、或者配置没有刷新。好的指令是好结果的前提。在 AI 协作中，「提示词工程」（Prompt Engineering）同样适用于编程代理——清晰的任务描述、明确的约束条件、具体的预期输出，都能显著提升 Codex 的执行质量。

总结

Codex 入门的重点不是记住多少命令，而是先让 AI 在你的项目里做完一件小事。安装桌面版、接入 DeepSeek、跑通第一个闭环——这三步走完，你就已经迈过了最关键的门槛。

等这个闭环跑通之后，再去研究 MCP 插件、Agent 模式和更复杂的自动化工作流，才不会迷路。这里简单预告一下这些进阶概念：MCP（Model Context Protocol） 是一种标准化协议，它定义了 AI 模型与外部工具和数据源之间的通信方式。通过 MCP 插件，你可以让 Codex 连接数据库、调用第三方 API、访问文档系统等，大幅扩展它的能力边界。而 Agent 模式则是指让 Codex 以更高的自主性运行——你只需要描述最终目标，它会自行拆解任务、选择工具、执行多步操作并处理中间错误，整个过程中人类干预更少。这些进阶能力都建立在你对基础闭环的熟练掌握之上，所以先跑通，再进阶，这才是正确的学习路径。