快捷键

在 Web 和桌面端的 设置 → 快捷键 中自定义快捷键。该页面也会列出你这个版本里可用的命令（command）ID 和默认值。

Composer（编写器）控件

mod+shift+d 会在当前获得焦点的编辑器或 Composer 中开始听写，并在下一次按下时结束；Esc 丢弃这段录音。在 Composer：开始或结束听写 下更改这个组合键，并在 设置 → 语音 中更改按住或切换的行为。参见语音输入。

在 设置 → 聊天 → 发送快捷键 中选择：由 Enter 直接发送、多行提示词需要 mod+Enter，还是始终需要 mod+Enter。Shift+Enter 插入新的一行。这适用于达到桌面宽度时的 Web 与桌面端 Composer。

后续行为用来在智能体运行期间选择排队（Queue）或转向（Steer）。即使发送快捷键本身需要修饰键，也可以用 mod+Enter 对这一条消息执行相反的操作。mod+Alt+Enter 会发送这条消息，让该对话线程（thread）在后台继续运行，并打开一个全新的、用于新对话线程的 Composer。在新对话线程中，mod+Enter 的作用相同。在 设置 → 快捷键 里的 Composer：相反的排队或转向操作、Composer：在后台开始 或 Composer：发送并开始新对话线程 下更改这些快捷键。这些绑定优先于发送快捷键。点击发送按钮，就会使用已经配置好的后续行为。

对话线程里已经有排队消息时，如果回合（turn）正在运行，mod+Shift+Enter 会把第一条作为转向发送；如果对话线程已经停止，则作为新的回合发送。在快捷键设置里的 队列：发送第一条排队消息 下更改它。

用 mod+shift+m 选择模型，用 mod+shift+h 选择主机。若要让新对话线程直接改到下一台机器，而不是打开菜单，请在快捷键中绑定 Composer：循环切换主机。它没有默认快捷键。

用 mod+shift+e 选择推理强度（effort），用 mod+shift+a 选择权限，用 mod+shift+x 选择工作区，用 mod+shift+g 选择 Git 分支。工作区菜单包含当前检出、新建的工作树（worktree），以及可用时的上一个工作树。用 mod+shift+l 直接复用上一个工作树。

若要在不打开选择器的情况下把推理强度调高或调低一档，请在快捷键中绑定 Composer：提高推理强度 和 Composer：降低推理强度。二者默认都没有绑定。提高会从最高档回绕到最低档，降低会从最低档回绕到最高档。

在模型选择器里，于空白的搜索框中按向左键，或按 Shift+Tab，即可到达提供方（provider）列表。用向上键和向下键移动，用 Enter 选定。向右键回到模型搜索。在搜索内容的末尾按向右键，会移到高亮模型的推理强度档位，按向左键则返回。选定一个模型后，选择器保持打开，并停在它的推理强度上。mod+shift+up 和 mod+shift+down 会直接切换提供方，并清空搜索。这些提供方快捷键也可以在设置里修改。

这些快捷键在当前获得焦点的 Web 或桌面客户端里生效。mod 在 macOS 上表示 Command，在 Windows 和 Linux 上表示 Ctrl，包括 GNOME、KDE Plasma、Niri 和 Hyprland。如果桌面上的自定义快捷键占用了同样的按键，请在设置里另选一个绑定。

复制拉取请求引用

在右侧面板或拉取请求（pull request）页面打开某个 PR 时，用 mod+shift+c 复制它的 URL，用 mod+shift+k 复制带有 # 前缀的编号。两个快捷键都可以在设置里修改。搜索「复制链接或对话线程」或「复制编号」。它们复制的是当前选中的 PR，并且不会动终端里的输入。没有打开 PR 时，mod+shift+c 复制对话线程本身；粘贴进 Composer 后，它会成为一个对话线程标签。

在差异中查找

在差异面板或某个拉取请求的代码标签页里点进一处差异，然后按 mod+f，即可搜索其中的每一个文件，包括已经折叠的文件，以及夹在变更之间、被藏起来的未改动行。Enter 和 Shift+Enter 用来在各个匹配之间移动，落在已折叠文件里的匹配会把该文件打开。Escape 关闭搜索。这个快捷键不能自定义。非常大的未提交差异会随着你的滚动才加载其中的文件，查找也只搜索目前已经加载的文件。

iPad

接上硬件键盘时，用 Cmd+1 到 Cmd+9 打开当前显示出来的前九个对话线程。这些快捷键跟随列表当前的过滤条件和排列顺序。Cmd+K 打开命令面板，用来搜索命令、项目和对话线程。用方向键和 Return 选定一个结果，或用 Cmd+1 到 Cmd+9 直接选定。Escape 或 Cmd+K 关闭该面板。用 > 作为搜索的开头，则只显示操作。

在新的对话线程中，Cmd+Shift+H 把草稿移到下一台机器。

在 Composer 中，Return 用来发送，Shift+Return 用来插入新的一行。回合正在运行时，Cmd+Return 会用另一种后续操作来发送。若要改成由 Return 插入新的一行，请到设置 → 键盘中更改 Return 键的行为；此后改由 Cmd+Return 发送。

Android

接上硬件键盘时，Composer 对 Return 的处理与 iPad 相同，只是用 Ctrl 代替 Cmd。屏幕键盘上的 Return 始终插入新的一行。

编辑配置文件

快捷键保存在环境（environment）所在的那台机器上，默认位于 ~/.t3/userdata/keybindings.json。你可以直接编辑这个文件。它是一个由规则组成的 JSON 数组：

[
  { "key": "mod+g", "command": "terminal.toggle" },
  { "key": "mod+shift+g", "command": "terminal.new", "when": "terminalFocus" }
]

T3 Code 会用默认值创建这个文件，并在之后的各次启动时补入新的默认项。新的默认项不会替换你已经改过的命令。如果新的默认项和你的某个快捷键重叠，由规则顺序决定实际执行哪一条。无效的规则会被忽略；如果这个文件无法解析，T3 Code 就使用默认值。

规则形态

每条规则都需要一个 key 快捷键和一个 command ID。可选的 when 表达式用来限制它在什么情况下运行。

项目脚本使用 script.{id}.run，例如 script.test.run。

按键语法

用 + 把修饰键和按键连起来，例如 mod+shift+d 或 ctrl+l。mod 在 macOS 上表示 Command，在其他系统上表示 Control。其他修饰键还有 cmd / meta、ctrl / control、alt / option 和 shift。

生效条件

可用的上下文键有 terminalFocus、terminalOpen、previewFocus、previewOpen、rightPanelOpen、modelPickerOpen、usagePageOpen、composerFocus、draftThreadRoute、turnRunning、editableFocus、isWeb 和 isDesktop。rightPanelOpen 只适用于 rightPanel.new，并且在右侧面板打开时为真；默认的 mod+t 用它来打开该面板的新建标签页菜单。draftThreadRoute 在草稿对话线程上为真，包括已经恢复的草稿，直到它第一次被发送。editableFocus 在文本框、Composer 或其他编辑器持有键盘时为真。isWeb 在浏览器标签页中为真。isDesktop 在桌面应用中为真。未知键的求值结果为 false。

mod+1 到 mod+9 会跳到前九个对话线程；模型选择器打开时，则跳到各个模型。模型选择器打开期间，跳到对话线程的那些快捷键不会执行。这些默认项使用了 isDesktop，以免抢走浏览器切换标签页的快捷键。如果你希望在浏览器里也使用同样的跳转，请在设置中去掉这个条件。

用 ! 表示非，用 && 表示与，用 || 表示或，也可以使用括号：

{ "key": "mod+j", "command": "terminal.toggle", "when": "terminalOpen && !terminalFocus" }

在当前对话线程中查找

chat.find 会搜索当前活动对话线程中的对话消息和已提议的计划。输入查询之后，会搜索整个对话线程，更早的消息也包括在内。对话线程搜索需要服务器支持；较旧的服务器需要先更新，才能启用它。如果搜索失败，请选择重试。在终端和预览之外，它的默认值是 mod+f。按 Enter 或 Shift+Enter 在各个匹配之间移动，按 Escape 关闭查找。

在浏览器页面上查找

preview.find（浏览器持有焦点时为 mod+f）会在桌面应用中搜索当前打开的页面。它也出现在浏览器的 ⋮ 菜单和命令面板里。如果页面自己处理 mod+f，例如代码编辑器，就会继续使用它自己的查找。这时请通过 ⋮ 菜单使用浏览器的查找。以串流方式显示的浏览器标签页，以及在 Web 浏览器中打开的 T3 Code，都不支持这一功能。

优先级

按键和条件都匹配的规则里，最后一条胜出，哪怕它属于另一条命令。几条规则共用同一个快捷键时，把更具体的那条放在更一般的那条后面。

行为特殊的命令

thread.stop 会中断焦点所在对话线程中正在运行的回合。它没有默认快捷键；请在 设置 → 快捷键 里指定一个。

thread.regenerateTitle 会为焦点所在的对话线程生成一个新标题，作用与对话线程菜单中的重新生成标题相同。它没有默认快捷键。

thread.undo（默认为 mod+z）会撤销侧边栏底部通知里显示的操作，例如取消置顶、办结（settle）、延后（snooze）、归档，或丢弃一份草稿。连续的同类操作会一并撤销。最近一次操作之后，这条通知还会保留五秒钟。刚执行完操作时，即使焦点在 Composer 这样的文本框里，这个快捷键也仍然有效。一旦你输入内容或按下别的键，文本框就会重新使用它自己的撤销。终端始终保留自己的原生快捷键。

navigation.back（默认为 mod+[）和 navigation.forward（mod+]）用来在你访问过的页面之间移动，就像浏览器的后退和前进按钮。

项目不止一个时，chat.new 可能会请你选择一个项目。chat.newLocal 会跳过这个选择器。二者都使用你的新对话线程默认设置。chat.newWithoutProject（mod+alt+n）会开始一个没有项目的对话线程。

保留的快捷键

在桌面应用中，mod+w 关闭当前获得焦点的终端，或右侧面板里的活动标签页。如果已经没有可关闭的东西，它就什么也不做；它绝不会关闭窗口。在浏览器里，mod+w 会关闭浏览器标签页；请把 rightPanel.close 和 terminal.close 改绑到一个还可用的快捷键，例如 alt+w。

mod+shift+t 会在整个应用里重新打开最后关闭的标签页，包括文件、差异、拉取请求、浏览器和设备，顺序就是你关闭它们的顺序。浏览器会在一个新的会话里打开，不保留原来的页面历史。无痕标签页在你重新加载或退出应用之前都可以重新打开。这个快捷键不会撤销已经删掉的工作。浏览器自己也会用它来重新打开浏览器标签页；如果浏览器先抢走了这个快捷键，请在设置里另选一个绑定。

许多默认项都包含 !terminalFocus，这样它们就不会截获终端输入。重新映射这些快捷键时，如果希望行为保持不变，请保留这个条件。

桌面端退出快捷键

macOS 上使用 Cmd+Q，Windows 和 Linux 上使用 Ctrl+Q。在默认的按住模式下，需要按住 1.2 秒，或者在 500 毫秒内按两次。按住依赖于按键重复；如果已经关闭按键重复，请连按两次，或使用应用程序菜单。

把 设置 → 通用 → 确认 → 退出快捷键 改为 直接，则按一次就会退出；改为 按两次，则只有按两次才会退出。从应用程序菜单里选择退出，始终会立刻退出。