使用这些命令和快捷键来操作 Codex App。
键盘快捷键
| 操作 | macOS 快捷键 | |
|---|---|---|
| 常规 | ||
| 命令菜单 | Cmd + Shift + P 或 Cmd + K | |
| 设置 | Cmd + , | |
| 键盘快捷键 | Cmd + / | |
| 打开文件夹 | Cmd + O | |
| 后退 | Cmd + [ | |
| 前进 | Cmd + ] | |
| 增大字号 | Cmd + + 或 Cmd + = | |
| 减小字号 | Cmd + - 或 Cmd + _ | |
| 切换侧边栏 | Cmd + B | |
| 切换 diff 面板 | Cmd + Option + B | |
| 切换终端 | Cmd + J | |
| 清空终端 | Ctrl + L | |
| 线程 | ||
| 新建线程 | Cmd + N 或 Cmd + Shift + O | |
| 在线程中查找 | Cmd + F | |
| 上一个线程 | Cmd + Shift + [ | |
| 下一个线程 | Cmd + Shift + ] | |
| 语音输入 | Ctrl + M |
若要查找、自定义或重置快捷键，请打开 Settings > Keyboard Shortcuts（设置 > 键盘快捷键）。你可以按命令名称搜索，也可以把搜索框切换为按键模式，然后按下想查找的快捷键。
斜杠命令
斜杠命令让你无需离开线程输入框，就能直接控制 Codex。具体可用命令会随你的环境和权限而变化。
使用斜杠命令
- 在线程输入框中输入
/。 - 从列表中选择一个命令，或继续输入以筛选结果，例如
/status。
你也可以在线程输入框里输入 $，显式调用某个技能。参见技能。
已启用的技能也会出现在斜杠命令列表中。
可用的斜杠命令
| 斜杠命令 | 说明 |
|---|---|
/feedback |
打开反馈对话框，提交反馈，并可选择一并附带日志。 |
/goal |
设置一个 Codex 会持续推进的目标；可先用 /plan 梳理目标。 |
/mcp |
打开 MCP 状态，查看已连接的 MCP servers。 |
/plan |
切换计划模式，用于多步骤规划。 |
/review |
启动代码审查模式，审查未提交改动或与某个基线分支进行比较。 |
/status |
显示线程 ID、上下文使用量和速率限制。 |
用 /goal 设置或管理目标
在 App 输入框中使用 /goal 可以启动目标模式（Goal mode）。目标是一个持久目标，Codex 会持续推进，直到完成任务、暂停，或需要更多输入。若要先和 Codex 一起定义目标，可以先用 /plan，再用 /goal 设置整理后的目标。
如果斜杠命令列表里没有 /goal，请在 config.toml 中启用 features.goals：
[features]
goals = true你也可以从 CLI 运行 codex features enable goals，或直接让 Codex 帮你运行。
目标处于活动状态时，App 会在输入框上方显示进度。你可以用进度行里的按钮暂停或恢复目标、编辑目标文本，或清除目标，而不必再输入另一条斜杠命令。目标运行时，你仍然可以继续发送后续消息来引导 Codex。
关于如何写出有效目标，请参见目标模式。
深链
Codex App 注册了 codex:// URL scheme，因此链接可以直接打开应用内的特定位置。
常用链接
如果只是打开常用 App 位置，可以使用下面这些链接。后续章节会按链接类型列出完整参考。
| 深链 | 打开内容 |
|---|---|
codex://threads/new |
新建本地线程。 |
codex://threads/<thread-id> |
打开一个本地线程。<thread-id> 必须是该线程的 session UUID。 |
codex://settings |
设置。 |
codex://skills |
技能。 |
codex://automations |
打开自动化，并进入创建流程。 |
线程
当你需要打开已有本地线程，或启动一个新线程时，使用这些链接。
| 深链 | 打开内容 |
|---|---|
codex://threads/<thread-id> |
打开一个本地线程。<thread-id> 必须是该线程的 session UUID。 |
codex://threads/new |
新建本地线程。 |
对于 codex://threads/new，可以按需添加下面这些查询参数；它们可以组合在同一个 URL 中。
| 查询参数 | 必填 | 作用 |
|---|---|---|
prompt=<text> |
否 | 设置输入框的初始文本。 |
path=<absolute-path> |
否 | 在本地工作区中打开新线程。path 必须是本地目录的绝对路径；如果有效，Codex 会把该目录作为活动工作区。 |
originUrl=<git-remote-url> |
否 | 根据 Git remote URL 匹配当前 workspace roots 中的某个项目。如果同时提供 path，Codex 会先解析 path。 |
示例：Show me some fun stats about how I've been using Codex
设置
当你需要打开 Settings（设置）或特定设置页时，使用这些链接。
| 深链 | 打开内容 |
|---|---|
codex://settings |
设置。 |
codex://settings/browser-use |
Browser use（浏览器使用）设置。 |
codex://settings/computer-use/google-chrome |
Google Chrome 的 Computer Use（计算机操作）设置。 |
codex://settings/connections |
Remote connections（远程连接）设置。 |
技能
当你需要打开 Skills（技能）时，使用这个链接。
| 深链 | 打开内容 |
|---|---|
codex://skills |
技能。 |
自动化
当你需要打开 Automations（自动化）时，使用这个链接。
| 深链 | 打开内容 |
|---|---|
codex://automations |
打开自动化，并进入创建流程。 |
插件
插件链接会根据你是打开插件、从插件市场安装插件，还是使用本地 marketplace.json 而采用不同格式。插件基础说明见插件。本地或仓库 marketplace 设置见构建插件。
插件详情
| 深链 | 打开内容 |
|---|---|
codex://plugins/<plugin-id> |
打开插件详情页。 |
<plugin-id> 必须能标识插件。对于 OpenAI-curated 插件，使用 <plugin-name>@openai-curated 形式。
Codex 生成的插件链接还可以包含下面这些查询参数。手写链接时可以省略两者。
| 查询参数 | 必填 | 作用 |
|---|---|---|
hostId=<host-id> |
否 | 标识拥有该插件上下文的 Codex host，例如 local 或你配置的某个远程连接。Codex 会提供这些 ID。 |
source=manage |
否 | 保留 App 中的 plugin-management 入口。它不是 admin-only。 |
本地插件
本地或仓库 marketplace 设置见构建插件。
| 深链 | 打开内容 |
|---|---|
codex://plugins/<plugin-name>?marketplacePath=<absolute-marketplace-path> |
从本地 marketplace 打开本地插件详情页。 |
| 查询参数 | 必填 | 作用 |
|---|---|---|
marketplacePath=<absolute-marketplace-path> |
是 | 指向本地 marketplace.json 的绝对路径，例如 /Users/alex/.agents/plugins/marketplace.json。 |
mode=share |
否 | 打开该本地插件的共享流程。 |
Pets
当该功能启用时，可以用这些链接打开 Pets 安装流程。
| 深链 | 打开内容 |
|---|---|
codex://pets/install?name=<pet-name>&imageUrl=<https-image-url> |
打开 Pets 安装流程。 |
| 查询参数 | 必填 | 作用 |
|---|---|---|
name=<pet-name> |
是 | 设置 Pets 名称。 |
imageUrl=<https-image-url> |
是 | 设置 Pets 图片 URL。imageUrl 必须使用 HTTPS。 |
description=<text> |
否 | 设置可选的 Pets 描述。 |