它到底是什么

/terminal-setup 是 Claude Code 内置的一次性终端配置命令，主要作用是让特定终端正确区分 Shift+Enter（换行）和 Enter（提交），并写入若干配套配置项。命令会自动检测当前终端类型，仅对支持的终端写入配置；已有绑定不会被覆盖。

官方文档 code.claude.com/docs/en/terminal-config 收录此命令。官方未在该页面注明最低版本号，但 Apple Terminal 首次启动时的引导弹窗会自动触发此命令，可视为一次性配置向导的底层实现。

怎么触发 / 怎么使用

在 Claude Code 会话的提示框中直接输入，无需附加任何参数：

/terminal-setup

各终端的配置效果

无需运行此命令的终端（开箱即支持 Shift+Enter）

Ghostty、Kitty、iTerm2、WezTerm、Warp、Apple Terminal（Shift+Enter 本身）、Windows Terminal。

即使运行也无效的终端

gnome-terminal、JetBrains IDEs（PyCharm、Android Studio 等）——官方文档对这些终端的说明是无法配置 Shift+Enter，请改用 Ctrl+J 或先输入 \ 再回车换行。

运行约束 / 限制

跟同类原语对比

经典使用场景

• 首次在 VS Code 集成终端使用 Claude Code，发现 Shift+Enter 直接提交而非换行，运行一次 /terminal-setup 修复。
• 在 Cursor 或 Zed 中使用 Claude Code 时的同类一次性配置。
• 使用 Apple Terminal 且在首次启动时点击了"跳过"引导弹窗，事后补跑此命令以启用 Option 键作为 Meta 键。
• 使用 iTerm2 且需要 /copy 命令能写入系统剪贴板时，通过此命令授权剪贴板访问。

常见坑

1. 在 tmux 内部运行的注意事项：多数情况下建议在裸宿主终端下运行 /terminal-setup；但 iTerm2 是例外，官方文档说明它即使从 tmux 内运行也能被检测并正确配置。此外，即使宿主终端已配置好，tmux 本身仍需在 ~/.tmux.conf 中加入以下内容才能透传 Shift+Enter：

   set -g allow-passthrough on
   set -s extended-keys on
   set -as terminal-features 'xterm*:extkeys'
   

   复制

2. VS Code GPU 加速被关闭：命令会将 terminal.integrated.gpuAcceleration 设为 "off" 以防止集成终端乱码。如需恢复，在 VS Code 设置中手动改回 "auto" 并执行 Developer: Reload Window。

3. gnome-terminal / JetBrains IDEs 无解：官方文档对这些终端的说明是无法配置 Shift+Enter。只能改用 Ctrl+J 或 \ + Enter 插入换行。

4. Shift+Enter 在 tmux 内仍失效：即使宿主终端和 tmux 都已配置，仍可能无法正确透传 Shift+Enter；此情况下回退到 Ctrl+J 即可。

来源

• Configure your terminal for Claude Code — code.claude.com 官方文档
• Commands — Claude Code Docs — code.claude.com 官方命令参考