了解 Codex 页面基本组成

认识对话和项目​

•

打开 Codex 桌面 App，左侧栏包含两个主要入口：Chat（对话） 和 Project（项目）。​

​

​

​

​

Chat 对话​

•

与 ChatGPT 网页端对话体验基本一致，适合处理日常的、一次性的问答和简单任务。每个对话相互独立，不共享工作目录。​

Project 项目​

•

适合需要操作本地文件的任务，例如生成代码、编写文档、制作 PPT、完成报告。在项目里创建的所有对话都共享同一个本地工作目录，方便统一管理多个子任务。​

•

在项目里下达指令后，Codex 的修改会直接应用到你本地文件夹中的文件。​

对话框功能说明​

Codex 桌面 App 的对话框与 ChatGPT 网页端类似，但额外提供了以下功能：​

​

💡

添加上下文：可以附加文件、截图或其他参考内容​

切换模型：在不同模型之间切换​

控制权限：设定 Codex 在当前任务中的操作权限​

选择工作目录：指定 Codex 在哪个本地文件夹下执行任务​

​

​

​

​

​

55%

​

​

​

​

45%

​

​

设置面板​

点击左下角头像或设置图标可以打开设置面板。​

​

​

​

🌐

•

上图左侧就是 Codex 桌面 App 的设置菜单。不要把它当成一次性必须填完的表单：新手只需要确认「常规」和「权限」能支撑第一个任务，其他设置等真实场景出现后再逐步打开。​

​

​

​

新手先按这四步检查​

先选工作模式：做代码、网站、脚本、仓库任务时选「适用于编程」；写文案、整理资料、做非代码任务时可以选「适用于日常工作」。​

先别急着开最大权限：刚开始建议让 Codex 只在当前工作区内读写文件，遇到联网、系统文件、危险命令时再单独审批。​

先配置工作目录：第一个任务尽量使用一个空文件夹或测试项目，不要直接把重要项目交给新手阶段的 Codex。​

先观察使用情况：如果任务经常中断、额度告急或模型响应变慢，再回到「使用情况」和套餐页面确认限制。​

设置逐项说明​

​

​

常规​

这里决定 Codex 默认以什么方式回答和执行任务。最重要的是「工作模式」和「权限」。如果你要跟着本教程做网页、脚本、代码修改，优先选「适用于编程」；它会保留更多技术细节、命令输出和变更说明。如果只是写提纲、整理资料或改文案，可以切到「适用于日常工作」，回复会更轻量。​

50%

​

​

外观​

外观只影响显示体验，比如浅色 / 深色模式、字体观感、界面密度或窗口呈现方式。它不会改变 Codex 能不能读文件、改代码或联网。​

50%

​

​

​

​

配置​

配置页对应官方文档里的 agent configuration，通常用于管理模型、推理强度、沙盒、审批策略、网络访问和本地配置文件。桌面 App 会把常用项做成可点选的界面，高级用户也可以进一步查看 config.toml 基础配置 与高级配置。​

50%

​

​

个性化​

个性化用于调整 Codex 的沟通风格和默认偏好，例如更详细、更简洁、更偏教学式，或在任务中遵守你的长期习惯。它适合放“你希望 Codex 怎么跟你协作”的规则，不适合放项目级命令。​

50%

​

​

​

​

MCP 服务器​

MCP 服务器让 Codex 连接外部工具，例如浏览器、设计工具、知识库、数据库、飞书、Notion 或自定义系统。官方文档把 MCP 视为扩展 Codex 能力的重要方式，但每接入一个服务，也意味着 Codex 能看到或操作更多上下文。​

小白不要一次性接很多 MCP。先从一个低风险工具开始，比如只读知识库或浏览器测试；需要 API Key 时尽量使用环境变量或系统凭据管理，不要把密钥直接写进教程、截图或对话里。​

50%

​

​

钩子​

钩子是让 Codex 在特定时机自动触发脚本或命令的机制，例如任务开始前准备环境、任务结束后运行格式化、测试或检查。它很适合团队标准化，但也最容易因为命令写错而带来副作用。​

第一次使用时可以先不配置钩子。等你明确知道“每次修改后都必须跑 pnpm lint”或“每次提交前都要生成报告”时，再把这些固定动作写进去。钩子里的命令要短、可重复、失败信息清晰，不要放删除、发布、上传密钥这类高风险动作。​

50%

​

​

​

​

Git​

Git 设置用于管理 Codex 如何理解当前仓库、分支、diff、提交和远程协作。对于真实项目，Git 是你回滚和审查 Codex 修改的安全网。​

新手最好养成两个习惯：让 Codex 开始前先看 git status，结束后列出改动文件和验证结果。不要让 Codex 在你没看 diff 的情况下直接 push 或改主分支；团队项目可以统一使用 codex/ 这类分支前缀。​

新手推荐：每次任务前后看 git status​

50%

​

​

环境​

环境设置通常用于准备项目运行所需的依赖、命令、环境变量和本地初始化步骤。官方 App 文档里的 Local environments 关注的是让 Codex 在可复现的环境里工作，而不是每次都重新猜项目怎么启动。​

你可以把常用准备步骤写成脚本，例如安装依赖、复制示例配置、启动服务。不要把真实生产密钥写进脚本；需要密钥时使用本机环境变量、团队密钥管理或明确的人工审批流程。​

新手推荐：先记录启动命令​

50%

​

​

​

​

工作树​

工作树对应 Git worktree。它允许 Codex 在同一个仓库旁边开出独立工作区，适合并行做多个任务，或让不同 agent 同时处理不同分支而互不覆盖。​

50%

​

​

浏览器​

浏览器设置让 Codex 可以打开网页、点击、输入、截图和检查页面状态。它适合前端验收、登录态页面检查、表单流程测试和资料查阅。官方 App 文档也把 In-app browser 作为桌面 App 的重要能力之一。​

50%

​

​

​

​

电脑操控​

电脑操控让 Codex 像用户一样读取屏幕、点击应用和输入内容。它适合没有 API 或 MCP 的桌面软件，例如设计工具、办公软件、系统弹窗或只能通过 UI 操作的流程。​

这类能力风险高于普通文件编辑。首次使用时只给明确、低风险、可撤销的动作，例如“打开这个窗口并截图说明”。不要让它替你最终确认付款、改密码、删除云文件、发送消息或提交重要表单。​

50%

​

​

已归档对话​

归档对话用于收起不再活跃的线程，让侧边栏保持干净。归档不是删除，通常还可以找回历史上下文、结论和文件修改记录。​

如果一个任务已经完成、验证通过、总结也写好了，就可以归档。还没合并、还在等审批、或者你可能继续追问的任务先不要归档，避免之后找上下文费劲。​

50%

​

​

​

​

使用情况​

使用情况用于查看额度、用量或套餐相关状态。Codex 的可用功能、额度和并发能力会随账号计划变化，具体以 ChatGPT / OpenAI 当前套餐说明为准。​

如果 Codex 变慢、任务被限流、无法启动新任务，先看这里，再去核对 订阅 Plus / Pro 章节。团队账号还要确认管理员是否限制了某些能力。​

新手推荐：遇到限制时先看这里​

50%

​

​

​

50%

​

​

什么时候需要改设置​

​

#HOVrXTJkGhaT text{white-space:pre}.fb0{stroke:var(--N900-FG, 0.15)}.fx0{stroke-miterlimit:10}.fa1{fill:#bbbfc4}.fx1{font:normal 400 12px MonospacedNumber,LarkHackSafariFont,LarkEmojiFont,LarkChineseQuote,-apple-system,BlinkMacSystemFont,Helvetica Neue,Tahoma,PingFang SC,Microsoft Yahei,Arial,Hiragino Sans GB,sans-serif,Apple Color Emoji,Segoe UI Emoji,Segoe UI Symbol,Noto Color Emoji}.fx2{text-anchor:middle}.fx3{dominant-baseline:central}.fx4{stroke:none}.fc0{fill:var(--text-caption)}.fa2{fill:var(--text-link-disabled)}.fa3{fill:#e1eaff}.fc1{stroke:var(--B500)}.fx5{font:700 normal 18px MonospacedNumber, LarkHackSafariFont, LarkEmojiFont, LarkChineseQuote, -apple-system, BlinkMacSystemFont, "Helvetica Neue", Tahoma, "PingFang SC", "Microsoft Yahei", Arial, "Hiragino Sans GB", sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji"}.fx6{text-anchor:start}.fx7{dominant-baseline:alphabetic}.fc2{fill:rgb(0, 0, 0)}.fx8{font:400 normal 16px MonospacedNumber, LarkHackSafariFont, LarkEmojiFont, LarkChineseQuote, -apple-system, BlinkMacSystemFont, "Helvetica Neue", Tahoma, "PingFang SC", "Microsoft Yahei", Arial, "Hiragino Sans GB", sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji"}.fc3{fill:var(--B500)}.fb1{fill:var(--N900-FG, 0.15)}.fa4{fill:var(--bg-body)}AB12345678910你遇到的情况优先检查Codex 回答太技术或太啰嗦每次都问同一个安全命令需要连接 Figma、Notion、飞书或数据库想让任务结束后自动跑测试想同时跑多个仓库任务需要打开网页检查 UI需要操作桌面软件找不到旧任务无法继续启动任务或额度不足常规、个性化常规权限、配置、项目 MCP 服务器钩子、环境Git、工作树浏览器电脑操控已归档对话使用情况、订阅套餐AGENTS.md

​

​