按键绑定¶

在 Web 和桌面端的 设置 → 按键绑定 中自定义快捷键。该页面还会列出当前版本中可用的命令 ID 和默认值。

Composer 控制¶

mod+shift+d 在聚焦的编辑器或 Composer 中开始听写，再次按下则结束；Esc 会丢弃录音。在 Composer: Start or Finish Dictation 下更改组合键，并在 设置 → 语音 中更改按住或切换行为。请参阅 语音输入。

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

后续行为 会在智能体运行时选择 Queue 或 Steer。使用 mod+Enter 对单条消息执行相反操作，即使发送快捷键需要修饰键。mod+Alt+Enter 发送消息，同时让该线程在后台继续运行，并打开一个新的新线程 Composer。在新线程中，mod+Enter 执行相同操作。在 设置 → 按键绑定 中的 Composer: Opposite Queue or Steer Action、Composer: Start in Background 或 Composer: Send and Start New Thread 下更改这些快捷键。这些绑定优先于发送快捷键。点击发送按钮可使用配置的后续行为。

当线程有排队消息时，mod+Shift+Enter 会在回合运行期间将第一条作为 steer 发送，或在线程停止时作为新回合发送。在按键绑定中的 Queue: Send First Queued Message 下更改此项。

使用 mod+shift+m 选择模型，使用 mod+shift+h 选择主机。要将新线程切换到下一台机器而不是打开菜单，请在按键绑定中绑定 Composer: Cycle Host。它没有默认快捷键。使用 mod+shift+e 调整 effort，mod+shift+a 调整权限，mod+shift+x 调整工作区，mod+shift+g 调整 Git 分支。工作区菜单包含当前 checkout、新的 worktree，以及可用时的上一个 worktree。使用 mod+shift+l 直接复用上一个 worktree。

要在不打开选择器的情况下将 effort 调整一步，请在按键绑定中绑定 Composer: Increase Effort 和 Composer: Decrease Effort。两者默认均未绑定。Increase 从最高级别循环到最低级别，decrease 从最低级别循环到最高级别。

在模型选择器中，在空的搜索字段中按 Left 或 Shift+Tab 可到达提供商列表。使用 Up/Down 移动，Enter 选择。Right 返回模型搜索。在搜索末尾按 Right 会移动到高亮模型的 effort 级别，Left 返回。选择模型后，选择器会保持打开在其 effort 上。mod+shift+up 和 mod+shift+down 直接切换提供商并清除搜索。这些提供商快捷键也可以在设置中更改。

这些快捷键在聚焦的 Web 或桌面端客户端内生效。mod 在 macOS 上使用 Command，在 Windows 和 Linux（包括 GNOME、KDE Plasma、Niri 和 Hyprland）上使用 Ctrl。如果自定义桌面快捷键占用了相同的按键，请在设置中选择其他绑定。

复制拉取请求引用¶

当 PR 在右侧面板或 Pull requests 页面中打开时，使用 mod+shift+c 复制其 URL，使用 mod+shift+k 复制带 # 前缀的编号。这两个快捷键都可以在设置中更改。搜索“Copy Link or Thread”或“Copy Number”。它们会复制选中的 PR，且不影响终端输入。如果没有 PR，mod+shift+c 会复制线程本身，粘贴到 Composer 中时会作为线程片段（thread chip）显示。

在 Diff 中查找¶

点击 Diff 面板或拉取请求的 Code 选项卡中的 diff，然后按 mod+f 搜索其中的每个文件，包括折叠的文件和隐藏在更改之间的未更改行。Enter 和 Shift+Enter 在匹配项之间移动，折叠文件中的匹配项会打开该文件。Escape 关闭搜索。此快捷键不可配置。非常大的未提交 diff 会在滚动时加载其文件，而 find 只会搜索已加载的文件。

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 始终插入新行。

编辑配置文件¶

按键绑定存储在该环境对应的机器上，默认位于 ~/.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。

When 条件¶

可用的上下文键包括 terminalFocus、terminalOpen、previewFocus、previewOpen、rightPanelOpen、modelPickerOpen、usagePageOpen、composerFocus、draftThreadRoute、turnRunning、editableFocus、isWeb 和 isDesktop。 rightPanelOpen 仅适用于 rightPanel.new，并且在右侧面板打开时为 true；默认的 mod+t 使用它来打开面板的新建标签页菜单。 draftThreadRoute 在草稿会话中为 true，包括恢复的草稿，直到首次发送为止。 editableFocus 在文本字段、撰写框或其他编辑器拥有键盘焦点时为 true。isWeb 在浏览器标签页中为 true。isDesktop 在桌面应用中为 true。未知键的计算结果为 false。

mod+1 到 mod+9 跳转到前九个会话，并在模型选择器打开时跳转到模型。当模型选择器打开时，会话跳转不会执行。这些默认值使用 isDesktop，因此不会占用浏览器的标签页切换快捷键。如果希望在浏览器中获得相同的跳转，请在设置中移除该条件。

使用 ! 表示非，&& 表示与，|| 表示或，并使用括号组合键：

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

在当前线程中查找¶

chat.find 在当前会话中搜索对话消息和建议的计划。输入查询会搜索整个会话，包括较早的消息。会话搜索需要服务器支持；请更新旧版服务器以启用该功能。如果搜索失败，请选择重试。在终端和预览之外，它默认为 mod+f。按 Enter 或 Shift+Enter 在匹配项之间移动，按 Escape 关闭查找。

优先级¶

键和条件都匹配的最后一条规则生效，即使它属于不同的命令。当多个规则共享同一快捷键时，请将更具体的规则放在通用规则之后。

具有特殊行为的命令¶

thread.stop 中断聚焦会话中正在运行的对话轮次。它没有默认快捷键；请在设置 → 键位绑定中指定一个。

thread.undo（默认为 mod+z）撤销侧边栏底部通知中显示的操作，例如取消置顶、完结、稍后提醒、归档或丢弃草稿。连续的同类型操作会一起撤销。通知在最近一次操作后仍会保留五秒。刚执行操作后，即使在撰写框等文本字段中，该快捷键也有效。一旦您输入内容或按下其他键，该字段就会恢复自身的撤销功能。终端始终保留其原生快捷键。

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 毫秒内按两次。长按需要键盘重复功能；如果禁用了重复功能，请使用两次按键或应用菜单。

将设置 → 常规 → 确认 → 退出快捷键更改为直接（按一次即退出）或双击（仅按两次退出）。从应用菜单中选择退出始终会立即退出。