Codex App Commands | 命令与快捷键

使用这些命令和快捷键来操作 Codex App。

使用这些命令和快捷键来操作 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 + G
在线程中查找Cmd + F
上一个线程Cmd + Shift + [
下一个线程Cmd + Shift + ]
语音输入Ctrl + M

若要查找、自定义或重置快捷键，请打开 Settings > Keyboard Shortcuts（设置 > 键盘快捷键）。你可以按命令名称搜索，也可以把搜索框切换为按键模式，然后按下想查找的快捷键。

搜索历史线程和在线程中查找

使用线程搜索（Cmd/Ctrl + G）可以重新打开过去的对话。当你的 Codex desktop app 支持扩展匹配时，它还可以匹配对话内容和 Git 分支名，所以你可以搜索线程中的短语，或搜索 fix/login-redirect 这类分支。

打开某个线程后，使用 Find in thread（在线程中查找）（Cmd + F）可以在当前对话中查找文本。它不会跨其它线程搜索。

斜杠命令

斜杠命令让你无需离开线程输入框，就能直接控制 Codex。具体可用命令会随你的环境和权限而变化。

使用斜杠命令

  1. 在线程输入框中输入 /。
  2. 从列表中选择一个命令，或继续输入以筛选结果，例如 /status。

你也可以在线程输入框里输入 $，显式调用某个技能。参见 技能。

已启用的技能也会出现在斜杠命令列表中。

可用的斜杠命令

斜杠命令说明
/feedback打开反馈对话框，提交反馈，并可选择一并附带日志。
/goal设置一个 Codex 会持续推进的目标；可先用 /plan 梳理目标。
/init为当前项目生成一个 AGENTS.md 脚手架。
/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 帮你运行。

Codex App 输入框上方的目标进度控件

目标处于活动状态时，App 会在输入框上方显示进度。你可以用进度行里的按钮暂停或恢复目标、编辑目标文本，或清除目标，而不必再输入另一条斜杠命令。目标运行时，你仍然可以继续发送后续消息来引导 Codex。

关于如何写出有效目标，请参见 目标模式。

深链

Codex App 注册了 codex:// URL scheme，因此链接可以直接打开应用内的特定位置。把值加入 URL 查询字符串前，请先完成编码。

支持的链接

创建链接时请使用这些规范形式。后续章节会按链接类型列出完整参考。

深链打开内容
codex://threads/new新建本地线程。
codex://new?新建本地线程，并至少带一个新线程查询参数。
codex://threads/打开一个本地线程。 必须是该线程的 session UUID。
codex://settings设置。
codex://skills技能。
codex://automations打开自动化，并进入创建流程。
codex://plugins/install/?marketplace=从已知 marketplace 打开插件安装流程。
codex://plugins/打开插件详情页。
codex://plugins/?marketplacePath=从本地 marketplace 打开本地插件详情页。
codex://pets/install?name=&imageUrl=打开 Pets 安装流程。

线程

当你需要打开已有本地线程，或启动一个新线程时，使用这些链接。

深链打开内容
codex://threads/打开一个本地线程。 必须是该线程的 session UUID。
codex://threads/new新建本地线程。
codex://threads/new?新建本地线程，并可带可选查询参数。
codex://new?新建本地线程。必须至少包含 prompt、path 或 originUrl 之一，否则链接不会执行任何操作。

对于 codex://threads/new 或 codex://new，可以按需添加下面这些查询参数；它们可以组合在同一个 URL 中。

查询参数必填作用
prompt=否设置输入框的初始文本。
path=否在本地工作区中打开新线程。path 必须是本地目录的绝对路径；如果有效，Codex 会把该目录作为活动工作区。
originUrl=否根据 Git remote URL 匹配当前工作区根目录中的某个项目。如果同时提供 path，Codex 会先解析 path。

示例： Show me some fun stats about how I've been using Codex

设置

当你需要打开 Settings（设置）或特定设置页时，使用这些链接。

深链打开内容
codex://settings设置。
codex://settings/browser-useBrowser（浏览器）设置。
codex://settings/computer-use/google-chromeGoogle Chrome 的 Computer Use（计算机操作）设置。
codex://settings/connectionsRemote connections（远程连接）设置。

不受支持的 codex://settings/... 路径会打开主 Settings（设置）页。

技能

当你需要打开 Skills（技能）时，使用这个链接。

深链打开内容
codex://skills技能。

自动化

当你需要打开 Automations（自动化）时，使用这个链接。

深链打开内容
codex://automations打开自动化，并进入创建流程。

插件

插件链接会根据你是从 marketplace 安装插件、打开插件，还是使用本地 marketplace.json 而采用不同格式。插件基础说明见 插件。本地或仓库 marketplace 设置见 构建插件。

插件安装

使用这个形式，可以为 Codex 已经知道的 marketplace 中的插件打开安装流程。

深链打开内容
codex://plugins/install/?marketplace=打开插件详情或安装流程。
查询参数必填作用
marketplace=是标识 marketplace。对于 OpenAI-curated 插件，使用 openai-curated。

安装链接只接受 marketplace 查询参数。如果 Codex 找不到请求的 marketplace 或插件，就会改为打开 Plugins（插件）页。

插件详情

深链打开内容
codex://plugins/打开插件详情页。

<plugin-id> 必须能标识插件。对于 OpenAI-curated 插件，使用 <plugin-name>@openai-curated 形式。

Codex 生成的插件链接还可以包含下面这些查询参数。手写链接时可以省略两者。

查询参数必填作用
hostId=否标识拥有该插件上下文的 Codex host，例如 local 或你配置的某个远程连接。Codex 会提供这些 ID。
source=manage否保留 App 中的 plugin-management 入口。它不是 admin-only。

示例： 打开 OpenAI Developers 插件

本地插件

本地或仓库 marketplace 设置见 构建插件。

深链打开内容
codex://plugins/?marketplacePath=从本地 marketplace 打开本地插件详情页。
查询参数必填作用
marketplacePath=是指向本地 marketplace.json 的绝对路径，例如 /Users/alex/.agents/plugins/marketplace.json。
mode=share否打开该本地插件的共享流程。

Pets

当该功能启用时，可以用这些链接打开 Pets 安装流程。

深链打开内容
codex://pets/install?name=&imageUrl=打开 Pets 安装流程。
查询参数必填作用
name=是设置 Pets 名称。
imageUrl=是设置 Pets 图片 URL。imageUrl 必须使用 HTTPS。
description=否设置可选的 Pets 描述。

另请参见