软件装上了，窗口也打开了，但真正能让它进入项目工作的条件还没有凑齐。这也是 Codex 看起来“下载容易、开始困难”的原因。

下面按一条比较稳妥的标准流程，把 Windows 下的安装、登录、模型选择和第一次验证讲清楚。最后再看一下，为什么 MotoAgent 里的 Codex 更适合不想反复折腾环境的人。

一、安装 Codex 前，先把环境准备好

Windows 电脑建议先准备 Git 和 Node.js。Python 不是 Codex 的硬性前置条件，但处理脚本、数据或自动化任务时通常会用到。

可以在 PowerShell 中执行：

winget install --id Git.Git
winget install --id OpenJS.NodeJS.LTS
winget install --id Python.Python.3.14

安装完成后关闭当前终端，再打开一个新的 PowerShell，确认命令已经进入系统路径：

git --version
node --version
python --version

如果能正常输出版本号，说明基础环境已经就绪。这里最好不要跳过“关闭并重新打开终端”这一步，很多“命令不存在”其实只是旧终端还没有读取新的 PATH。

二、Windows 原生安装：适合先快速跑起来

如果项目主要放在 Windows 文件夹中，或者只是想先体验 Codex，可以直接使用 PowerShell 安装方式：

irm https://chatgpt.com/codex/install.ps1 | iex

安装结束后检查版本：

codex --version

如果提示找不到 `codex`，先关闭 PowerShell，再重新打开。仍然找不到时，检查安装目录是否已经加入 PATH，或者重新执行安装命令。

Windows 原生方式的优点是路径直观，桌面文件和项目目录比较容易管理。缺点是部分 Linux 工具链、Shell 脚本和开发依赖的行为与服务器环境不完全一致。

三、需要 Linux 工具链时，选择 WSL2

如果日常项目使用 Linux 命令、Shell 脚本或容器工具，WSL2 通常更接近实际开发环境。管理员 PowerShell 中先执行：

wsl --install

按提示重启电脑，进入 Linux 终端后安装 Codex：

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

WSL2 下建议把项目放在 Linux 自己的目录，例如：

mkdir -p ~/code
cd ~/code

不建议第一次就把整个 Windows 磁盘映射给智能体。项目目录越小，权限边界越清楚，出现误操作时也更容易恢复。

四、登录之后，模型和权限才是关键

安装只是把命令放进系统，登录才是让 Codex 进入可用状态。启动登录流程：

codex login

按界面提示选择登录方式。登录完成后，运行：

codex

第一次进入对话，不要马上交给它一个大型项目。先使用这些内置命令确认状态：

/status       查看当前登录和工作状态
/model        查看或切换模型
/permissions  查看当前权限
/review       检查当前项目改动

不同版本的命令入口可能略有变化，以当前界面显示为准。重点是先确认三件事：当前模型可以回复，当前目录是目标项目，文件和终端权限没有超出预期。

五、第一条任务应该用来验证，而不是用来炫技

进入项目目录后，可以发送一条小而完整的指令：

请先分析当前项目，不要修改文件。
请说明项目入口、主要目录、运行方式和可能的风险。
如果需要执行命令，请先列出命令并等待确认。
最后用三点总结你的判断。

这一步能验证 Codex 是否看到了正确的项目，也能观察它是否会在没有授权的情况下主动修改文件。

确认环境没有问题后，再进行一次可回滚的小改动：

请在当前项目中新建 hello.py：
1. 输出当前时间和运行环境；
2. 添加中文注释；
3. 执行一次验证；
4. 如果报错，先说明原因再修复；
5. 最后列出实际修改过的文件。

这条指令同时检查了文件创建、终端执行、错误处理和结果汇报。比直接让它重构整个项目，更适合作为第一次验收。

六、为什么很多人装好之后，仍然觉得配置复杂？

问题通常不在某一个按钮，而在几个配置层叠在一起：

所以“安装成功”与“能够稳定工作”是两件事。标准流程的价值，就是把每一层拆开验证，避免在一个错误现象上反复试错。

七、不想反复配环境，MotoAgent 里的 Codex 怎么用？

如果只是想尽快开始体验 Codex，MotoAgent 提供了一个更直观的入口。安装完成后，打开软件，进入 Codex 对话，就可以从模型、会话和项目任务开始使用，不必先在多个终端和配置文件之间来回切换。

上图是启动后的实际 MotoAgent Codex 界面。账户信息已经做模糊处理，保留了对话区、模型信息、权限提示和代码返回区域。它更像一个完整的工作台：左侧管理不同会话，中间处理任务，底部继续输入指令。

一个比较实用的使用顺序是：

• 打开 MotoAgent，进入 Codex 会话；
• 先选择当前可用的模型；

• 指定一个测试项目目录；
• 发送只读分析任务；

• 确认结果后，再允许创建文件或运行测试。

例如可以直接发送：

请检查当前项目的目录结构，先不要修改文件。
用表格说明每个主要目录的作用，并指出最适合从哪里开始阅读。

如果只是做代码解释、生成小脚本或整理项目文档，这样的轻量任务已经足够。需要修改代码时，再逐步打开对应权限，使用过程会更稳。

八、两种方式应该怎么选？

MotoAgent 解决的是入口和配置体验，不会替代代码审查。涉及数据库、支付、账号权限和线上部署的改动，仍然需要人工检查、测试和回滚方案。

结语：先把第一条任务跑通，再决定要不要深入配置

Codex 的标准安装并不难，真正容易让人停下来的，是安装、登录、模型、目录和权限被分散在不同层级里。

如果希望理解完整机制，可以按 Windows 或 WSL2 的标准流程逐项验证；如果目标只是尽快开始使用，MotoAgent 里的 Codex 把这些入口集中到一个界面，安装后就能直接进入对话和项目任务。

最稳妥的起点始终是一条只读分析指令。先确认它看到了什么、准备做什么，再让它修改文件。这样既能快速上手，也能保留对项目的控制感。

单独看，每一步都不算复杂。真正让人花时间的是，安装、登录、模型接口、API Key 和配置文件分散在不同地方，任何一项没有对上，最后都可能只看到一个打不开或无法回复的终端窗口。

下面先按照公开文档走一遍手动方案，再看为什么有人会选择带有内置 Codex 和模型入口的桌面工具。

一、先理解 Codex 和 DeepSeek 的关系

Codex 是编程智能体，负责理解项目、读取文件、修改代码和执行命令；DeepSeek 是模型服务，负责理解指令、分析代码并生成回复。

简单说，Codex 决定“怎么干活”，DeepSeek 决定“用什么模型来思考”。安装 Codex 并不等于已经连接 DeepSeek，接入模型之后，也不代表已经授予它修改项目和运行命令的权限。

二、按照官方路线安装 Codex

OpenAI 官方文档当前给出的流程是：安装 Codex、启动并登录、进入项目目录后发送第一条任务。Codex CLI 文档 也把“模型、目录和权限”列为启动后的主要配置项。

1. 安装 Codex

macOS 或 Linux 可以使用官方安装方式：

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

Windows 则需要根据官方页面当前提供的安装方式选择 npm 或其他安装入口。远程安装脚本执行前，建议先确认来源和内容，避免把未知脚本直接交给系统运行。

2. 启动并完成登录

进入一个测试项目目录，启动 Codex：

cd ~/code/test-project
codex

第一次运行时，按照终端提示完成登录。进入后可以先使用这些命令查看当前状态：

/status       查看当前会话配置
/model        选择模型和推理强度
/permissions 选择文件和命令权限
/review       检查代码修改

如果 Codex 能够启动，但还没有进入项目目录，后面的文件操作就没有明确范围。第一次测试建议新建一个空文件夹，不要直接连接重要项目。

三、按照 DeepSeek 官方方案接入模型

DeepSeek 官方文档说明，其接口支持 OpenAI Responses API 格式，并提供了专门的 Codex 集成说明。当前文档列出的模型包括 `deepseek-v4-flash`、`deepseek-v4-pro`，以及支持图片输入的 `deepseek-v4-flash-vision-exp`。DeepSeek 的 Codex 集成文档 对配置字段进行了说明。

方法一：使用官方一键配置脚本

macOS 或 Linux 可以运行：

bash <(curl -fsSL https://cdn.deepseek.com/api-docs/codex-deepseek-setup-en.sh)

Windows PowerShell 可以运行：

irm https://cdn.deepseek.com/api-docs/codex-deepseek-setup-en.ps1 | iex

脚本运行前需要先启动过 Codex，让本机生成 `~/.codex` 目录。随后根据菜单选择模型，再把 DeepSeek API Key 写入 Codex 配置。

这一步看起来已经很接近“一键完成”，但实际使用仍然要面对三个问题：脚本是否执行成功、API Key 是否有效、当前模型是否支持 Codex 所需的 Responses API。任何一步出错，都需要回到终端排查。

方法二：手动修改 `config.toml`

DeepSeek 官方给出的核心配置思路如下，API Key 需要替换成账户中实际申请的密钥：

model = "deepseek-v4-flash"
model_provider = "deepseek"
preferred_auth_method = "apikey"
forced_login_method = "api"
model_reasoning_effort = "high"
[model_providers.deepseek]
name = "deepseek"
base_url = "https://api.deepseek.com/"
wire_api = "responses"
experimental_bearer_token = "你的 DeepSeek API Key"

配置文件通常位于：

~/.codex/config.toml

配置完成后重新启动 Codex，再用 `/status` 查看模型、提供方和当前目录是否已经生效。DeepSeek 的 Responses API 文档还特别说明，部分工具类型并不完全支持，不能因为模型能正常回复，就默认所有 Codex 工具都可用。Responses API 兼容说明

四、第一条测试指令应该验证什么？

不要一开始就把完整项目交给 Codex。可以先发送一个范围很小的任务：

请检查当前测试项目：
1. 说明当前目录有哪些文件；
2. 不修改任何内容；
3. 判断当前环境是否适合运行 Python；
4. 最后列出你准备使用的模型和权限。

这条指令主要验证模型是否接通、项目目录是否正确，以及 Codex 是否遵守“先查看、不修改”的边界。

确认无误后，再测试文件创建：

请在当前测试项目中新建 hello.py，只输出一句中文问候。
创建后执行一次验证，不要修改其他文件，最后说明实际执行了什么。

如果只返回代码而没有创建文件，优先检查文件权限；如果模型回复正常但无法执行命令，再检查终端权限和当前工作目录。

五、为什么很多人最后会选择内置方式？

手动安装的优点是配置透明，每个环节都可以自己控制；缺点是遇到网络、登录、密钥或版本变化时，需要自行处理。

对只想快速体验的人来说，问题往往不是不会写配置，而是不想把几天时间花在配置上。MotoAgent 的做法，是把 Codex 作为内置编程入口，同时提供 DeepSeek 等模型选择，让使用者在同一个工作区里完成智能体、模型、项目目录和权限的设置。

下面这张是电脑中已安装并启动的 MotoAgent 实际界面，可以看到 OpenClaw、Codex、Hermes 和 Claude 位于同一个入口中。本文只用它说明界面结构和切换关系，具体模型状态仍以当前版本和本机配置为准。

这里的“内置”并不代表所有任务都不需要确认。文件访问、终端执行和模型额度仍然应该按照实际任务逐步开启。它解决的主要是重复安装和多处配置的问题。

六、手动方案和内置方案怎么选？

如果目标是研究 Codex 的运行机制，手动方式值得走一遍；如果目标是尽快完成一次代码、文档或图片任务，内置入口更省准备时间。

七、每天可以先用免费模型做一次小测试

刚开始使用时，不必马上把所有模型和权限都配置完整。可以在 MotoAgent 中先检查当前可用的免费模型，用一条轻量指令确认聊天和任务返回是否正常。

例如每天先做一次项目说明、代码解释或小脚本测试，确认模型状态后再处理重要任务。FreeHub 中的模型、额度和可用时间可能随服务规则调整，实际情况以当前页面显示为准。

这一步的意义不是把所有功能都承诺为免费，而是让使用者在投入时间配置复杂项目之前，先用较低成本建立判断。

八、几个容易忽略的安全问题

• API Key 不要写进公开代码仓库，也不要直接发到聊天群；
• 远程安装脚本执行前，确认来源和脚本内容；

• 第一次测试使用空目录或副本，不要直接授权重要项目；
• 开启终端权限后，先观察命令，再逐步扩大权限范围；

• 模型返回的代码需要实际运行和人工检查，不能只看文字说明。

结语：先把模型接通，再决定是否深入配置

国内安装 Codex 并接入 DeepSeek，手动路线并不神秘：先安装并登录 Codex，再配置模型提供方、接口地址、API Key 和项目权限，最后用小任务验证。

真正麻烦的是这些配置分散在不同地方，而且模型接口和工具能力并不完全等价。想了解底层机制，可以按照官方方案逐项配置；想快速体验，则可以选择把 Codex、DeepSeek 和工作区集中起来的内置方式。

无论选择哪一种方式，第一步都不应是交出整个项目，而应该是用一个小任务确认模型、目录和权限都在预期范围内。