XCode 操作说明

XCode 的输入框不是纯聊天框，而是一个：

> AI + 编辑器 + 命令调度器的融合终端

主要有三类前缀触发器：

| 符号 | 类型 | 本质作用 | |------|------|----------| | / | Command（命令） | 执行内置操作 | | @ | Context（上下文） | 引用文件/代码/目录 | | ! | Bash 模式 | 直接执行终端命令，stdout/stderr 自动注入上下文 | | # | Memory（记忆注入） | 把内容持久写入 CLAUDE.md 项目记忆 | | & | Async（异步任务） | 后台/云端异步执行任务 | | \ + Enter | Multiline（多行输入） | 换行不发送，写多行内容 | | 无前缀 | 自然语言 | 普通任务指令 |

---

/ —— 操作型命令（最重要）

/ 是 XCode 中触发内置命令/工具的核心符号，类似终端命令行的指令前缀。

输入 / 会弹出命令列表。常见高频命令：

| 命令 | 作用 | |------|------| | /help | 查看全部能力 | | /clear | 清空对话 | | /plan | 进入规划模式 | | /model | 切换模型 | | /context | 查看上下文使用情况 | | /export | 导出对话 | | /status | 环境状态 | | /tasks | 管理后台任务 | | /theme | 主题切换 | | /memory | 编辑 CLAUDE.md |

例如：

/plan 实现一个用户登录模块

---

@ —— 上下文注入

@ 后面跟文件名，会主动联想：

引用单文件：

@main.py 帮我检查 bug

引用多个文件：

@main.py @main2.py 这两个是否有重复逻辑？

引用整个目录：

@src/ 分析项目结构并给出优化建议

引用错误日志：

@npm-debug.log 找出失败原因

XCode 会把文件内容真实加载进推理上下文。

---

! —— Bash 命令

通过在输入前加上 ! 直接运行 bash 命令，无需通过 XCode：

! ls -la
! npm test
! git status

Bash 模式：

• 将命令及其输出添加到对话上下文
• 显示实时进度和输出
• 支持 Ctrl+B 后台运行长时间命令
• 不需要 XCode 解释或批准命令

---

Vim 编辑器模式

使用 /vim 命令启用 vim 风格编辑，或通过 /config 永久配置。

模式切换

| 命令 | 操作 | 来自模式 | |------|------|----------| | Esc | 进入 NORMAL 模式 | INSERT | | i | 在光标前插入 | NORMAL | | I | 在行首插入 | NORMAL | | a | 在光标后插入 | NORMAL | | A | 在行尾插入 | NORMAL | | o | 在下方打开行 | NORMAL | | O | 在上方打开行 | NORMAL |

导航（NORMAL 模式）

| 命令 | 操作 | |------|------| | h/j/k/l | 向左/下/上/右移动 | | w | 下一个单词 | | e | 单词末尾 | | b | 上一个单词 | | 0 | 行首 | | $ | 行尾 | | gg | 输入开始 | | G | 输入结束 |

编辑（NORMAL 模式）

| 命令 | 操作 | |------|------| | x | 删除字符 | | dd | 删除行 | | D | 删除到行尾 | | yy/Y | 复制（yank）行 | | p | 在光标后粘贴 | | P | 在光标前粘贴 | | . | 重复最后一个更改 |

---

命令历史

XCode 为当前会话维护命令历史：

• 历史按工作目录存储
• 使用 /clear 命令清除
• 使用上/下箭头导航
• 注意：历史扩展（!）默认禁用

使用 Ctrl+R 反向搜索

按 Ctrl+R 交互式搜索命令历史：

• 开始搜索：按 Ctrl+R 激活
• 键入查询：输入文本搜索
• 导航匹配：再次按 Ctrl+R 循环浏览较旧匹配
• 接受匹配：按 Tab 或 Esc 接受并编辑；按 Enter 立即执行
• 取消搜索：按 Ctrl+C 取消

---

后台 bash 命令

XCode 支持在后台运行 bash 命令，允许您在长时间运行的进程执行时继续工作。

当 XCode 在后台运行命令时，它异步运行命令并立即返回后台任务 ID。XCode 可以在命令继续在后台执行时响应新提示。

要在后台运行命令：

• 提示 XCode 在后台运行命令
• 按 Ctrl+B 将常规 Bash 工具调用移到后台（Tmux 用户按两次）

主要功能：

• 输出被缓冲，XCode 可以使用 TaskOutput 工具检索
• 后台任务具有用于跟踪和输出检索的唯一 ID
• 当 XCode 退出时，后台任务会自动清理

要禁用所有后台任务功能：

export XCODE_DISABLE_BACKGROUND_TASKS=1

常见后台命令：

• 构建工具（webpack、vite、make）
• 包管理器（npm、yarn、pnpm）
• 测试运行器（jest、pytest）
• 开发服务器
• 长时间运行的进程（docker、terraform）

---

按键说明

常规控制

| 快捷键 | 描述 | 上下文 | |--------|------|--------| | Ctrl+C | 取消当前输入或生成 | 标准中断 | | Ctrl+D | 退出 XCode 会话 | EOF 信号 | | Ctrl+G | 在默认文本编辑器中打开 | 编辑提示或响应 | | Ctrl+L | 清除终端屏幕 | 保留对话历史 | | Ctrl+O | 切换详细输出 | 显示工具使用详情 | | Ctrl+R | 反向搜索命令历史 | 交互式搜索 | | Ctrl+B | 后台运行任务 | Tmux 用户按两次 | | Esc + Esc | 回退代码/对话 | 恢复到之前状态 | | Option+P / Alt+P | 切换模型 | 不清除提示 | | Option+T / Alt+T | 切换扩展思考 | 启用/禁用扩展思考 |

文本编辑

| 快捷键 | 描述 | 上下文 | |--------|------|--------| | Ctrl+K | 删除到行尾 | 存储已删除文本供粘贴 | | Ctrl+U | 删除整行 | 存储已删除文本供粘贴 | | Ctrl+Y | 粘贴已删除文本 | 粘贴用 Ctrl+K/U 删除的文本 | | Alt+Y | 循环粘贴历史 | 循环浏览以前删除的文本 | | Alt+B | 光标向后移动一个单词 | 单词导航 | | Alt+F | 光标向前移动一个单词 | 单词导航 |

多行输入

| 方法 | 快捷键 | 上下文 | |------|--------|--------| | 快速转义 | \ + Enter | 在所有终端中工作 | | macOS 默认 | Option+Enter | macOS 默认设置 | | Shift+Enter | Shift+Enter | iTerm2、WezTerm、Ghostty、Kitty | | 控制序列 | Ctrl+J | 多行换行符 | | 粘贴模式 | 直接粘贴 | 代码块、日志 |

Shift+Enter 在 iTerm2、WezTerm、Ghostty 和 Kitty 中无需配置即可工作。对于其他终端（VS Code、Alacritty、Zed、Warp），运行 /terminal-setup 以安装绑定。