Codex 安装与访问:先判断入口,再判断环境
采集日期:2026-06-17。复测日期:2026-06-17。
新手第一次接触 Codex,最容易把“入口”“安装”“账号权限”“项目环境”混在一起。正确顺序是:先确认你要完成什么工作,再选择入口,最后才处理命令、登录和本地环境。
- 想用一个桌面工作台处理项目、浏览器、审查和本地任务,先看 Codex App 完整说明。
- 想在终端里让 Codex 读仓库、改代码、跑测试,先看 Codex 总览 和 Windows 安装。
- 想快速体验“把一个任务交给 Agent 做完”,先看 Codex 新手第一小时。
- 安装命令、账号入口、支持平台、价格和额度都属于高变动事实,必须回到 Wiki 来源登记 里的官方文档复核。
| 你现在的状态 | 推荐入口 | 原因 |
|---|---|---|
| 没有终端经验,只想看清 Agent 怎么工作 | Codex App | 操作面更完整,能看到任务、浏览器和审查状态 |
| 已经会打开项目、运行命令、提交 Git | Codex CLI | 更接近真实开发流程,适合让 Agent 读仓库和改代码 |
| 主要在编辑器里改小功能 | IDE Extension | 适合围绕当前文件、局部修改和编辑器工作流 |
| 团队要沉淀规范、复盘、PR | App + GitHub 工作流 | 更适合配合 Worktree / GitHub / PR |
这里不要追求“一次装全”。新手先把一个入口跑通,再补 MCP、Skill、自动化和团队规范。
安装前先做三件事
Section titled “安装前先做三件事”- 确认系统边界:Windows 原生、WSL2、macOS、Linux 的行为不完全一样,Windows 问题先看 Windows 与环境报错。
- 确认账号和权限:登录、订阅、组织权限、API 权限可能影响你看到的入口,不要把所有失败都归因于安装命令。
- 确认项目目录:让 Codex 在正确的项目根目录启动,否则它读到的规则、依赖和 Git 状态都可能是错的。
新手常见误区
Section titled “新手常见误区”误区一:看到报错就重装。
很多问题不是安装坏了,而是当前目录、Shell、权限、网络、Node 路径或沙箱策略不对。先定位问题层级,再处理命令。
误区二:把聊天模型用法搬到 Codex。
Codex 不是用来闲聊的主入口。更有效的任务写法是“目标 + 当前项目 + 可改范围 + 验收方式”,可以继续读 Spec / Skill / Memory 三件套。
误区三:复制旧教程命令。
安装命令是高变动内容。本网站会标注复测日期,但真正执行前仍应以官方页面为准。
- 要马上开始:读 Codex 新手第一小时。
- 要排查 Windows:读 Windows 与环境报错。
- 要理解权限弹窗:读 权限、沙箱和审批。
- 要看官方来源边界:读 Wiki 来源登记。
- 官方入口:OpenAI Codex CLI、OpenAI Codex Windows。
- 站内关联:Codex 总览、Windows 安装。
- 分享日期:2026-06-17。
- 复测日期:2026-06-17。