CLI 命令

Qwen Code 支持多个内置命令，帮助你管理会话、自定义界面并控制其行为。这些命令以斜杠（/）、@ 符号（@）或感叹号（!）作为前缀。

斜杠命令（/）

斜杠命令提供对 CLI 本身的元级别控制。

内置命令

• /bug

  • 描述： 提交关于 Qwen Code 的 issue。默认情况下，issue 会提交到 Qwen Code 的 GitHub 仓库中。你在 /bug 后输入的字符串将成为该 bug 的标题。你可以通过在 .qwen/settings.json 文件中修改 advanced.bugCommand 设置来更改 /bug 的默认行为。

• /chat

  • 描述： 手动保存和恢复对话历史记录，支持交互式分支对话状态或从后续会话中恢复之前的状态。
  • 子命令：
    • save
      • 描述： 保存当前对话历史记录。你必须添加一个 <tag> 来标识对话状态。
      • 用法： /chat save <tag>
      • 检查点位置详情： 默认的聊天检查点保存位置为：
        • Linux/macOS: ~/.qwen/tmp/<project_hash>/
        • Windows: C:\Users\<YourUsername>\.qwen\tmp\<project_hash>\
        • 当你运行 /chat list 时，CLI 只会在这些特定目录中扫描可用的检查点。
        • 注意： 这些检查点用于手动保存和恢复对话状态。如需了解文件修改前自动创建的检查点，请参阅 Checkpointing 文档。
    • resume
      • 描述： 从之前的保存点恢复对话。
      • 用法： /chat resume <tag>
    • list
      • 描述： 列出可用于恢复对话状态的标签。
    • delete
      • 描述： 删除已保存的对话检查点。
      • 用法： /chat delete <tag>
    • share
      • 描述： 将当前对话写入指定的 Markdown 或 JSON 文件。
      • 用法： /chat share file.md 或 /chat share file.json。如果未提供文件名，则 CLI 会自动生成一个。

• /clear

  • 描述： 清除终端屏幕内容，包括 CLI 中可见的会话历史和滚动缓冲区。底层会话数据（用于历史回溯）可能会根据具体实现保留，但视觉显示会被清除。
  • 快捷键： 随时按 Ctrl+L 执行清屏操作。

• /summary

  • 描述： 根据当前对话历史生成全面的项目摘要，并将其保存至 .qwen/PROJECT_SUMMARY.md。此摘要包含整体目标、关键知识、最近的操作以及当前计划，非常适合在未来的会话中继续工作。
  • 用法： /summary
  • 功能特性：
    • 分析整个对话历史以提取重要上下文信息
    • 创建结构化的 Markdown 摘要，分为目标、知识、操作和计划等部分
    • 自动保存到项目根目录下的 .qwen/PROJECT_SUMMARY.md
    • 在生成与保存过程中显示进度指示器
    • 与“Welcome Back”功能集成，实现无缝会话恢复
  • 注意： 此命令需要至少有两条消息的有效对话才能生成有意义的摘要。

• /compress

  • 描述： 使用摘要替换整个聊天上下文。这可以节省未来任务使用的 token 数量，同时保留高层次的历史总结。

• /copy

  • 描述： 将 Qwen Code 最后一次输出的内容复制到剪贴板，便于分享或复用。

• /directory（或 /dir）

  • 描述： 管理多目录支持的工作空间目录。
  • 子命令：
    • add：
      • 描述： 添加目录到工作空间。路径可以是绝对路径或相对于当前工作目录的相对路径。此外也支持基于主目录的引用方式。
      • 用法： /directory add <path1>,<path2>
      • 注意： 在限制性沙盒配置文件中禁用。如果你正在使用此类配置，请改用启动会话时传入 --include-directories 参数。
    • show：
      • 描述： 显示所有通过 /directory add 和 --include-directories 添加的目录。
      • 用法： /directory show

• /editor

  • 描述： 打开一个对话框选择受支持的编辑器。

• /extensions

  • 描述： 列出当前 Qwen Code 会话中的所有活跃扩展。详见 Qwen Code Extensions。

• /help（或 /?）

  • 描述： 显示有关 Qwen Code 的帮助信息，包括可用命令及其使用方法。

• /mcp

  • 描述： 列出已配置的 Model Context Protocol (MCP) 服务器、其连接状态、服务器详细信息及可用工具。
  • 子命令：
    • desc 或 descriptions：
      • 描述： 显示 MCP 服务器和工具的详细说明。
    • nodesc 或 nodescriptions：
      • 描述： 隐藏工具描述，仅显示工具名称。
    • schema：
      • 描述： 显示工具配置参数的完整 JSON Schema。
  • 快捷键： 随时按 Ctrl+T 切换是否显示工具描述。

• /memory

  • 描述： 管理 AI 的指令上下文（默认由 QWEN.md 文件加载的分层内存；可通过 contextFileName 配置）。
  • 子命令：
    • add：
      • 描述： 将以下文本添加到 AI 的记忆中。用法：/memory add <text to remember>
    • show：
      • 描述： 展示从所有上下文文件（例如 QWEN.md）加载的所有分层内存的完整拼接内容。这样你可以查看提供给模型的指令上下文。
    • refresh：
      • 描述： 重新从所有上下文文件（默认为 QWEN.md）中加载分层指令内存，这些文件位于全局、项目/祖先目录和子目录中。这将更新模型获取最新的上下文内容。
    • 注意： 关于上下文文件如何贡献于分层内存的更多细节，请参见 CLI Configuration 文档。

• /model

  • 描述： 切换当前会话所使用的模型。打开一个对话框让你根据认证类型从中选择可用模型。
  • 用法： /model
  • 功能特性：
    • 显示适用于当前认证类型的全部可用模型列表
    • 展示每个模型的功能描述和能力（如视觉支持）
    • 更改仅对当前会话生效
    • 支持 Qwen 模型（通过 OAuth）和 OpenAI 模型（通过 API Key）
  • 可用模型：
    • Qwen Coder： 来自阿里云 ModelStudio 的最新 Qwen Coder 模型（版本：qwen3-coder-plus-2025-09-23）
    • Qwen Vision： 来自阿里云 ModelStudio 的最新 Qwen Vision 模型（版本：qwen3-vl-plus-2025-09-23），支持图像分析
    • OpenAI Models： 当使用 OpenAI 认证时可用（通过环境变量 OPENAI_MODEL 配置）
  • 注意： 模型选择仅作用于当前会话，不会跨不同 Qwen Code 会话持久化。若要设置默认模型，请在配置中使用 model.name 设置项。

• /restore

  • 描述： 将项目文件还原到执行某个工具前的状态。这对于撤销工具所做的文件修改特别有用。如果不带工具调用 ID 运行，它将列出可恢复的检查点供选择。
  • 用法： /restore [tool_call_id]
  • 注意： 仅当 CLI 被调用时带有 --checkpointing 选项或者通过 settings 配置启用时才可用。更多信息请参阅 Checkpointing 文档。

• /settings

  • 描述： 打开设置编辑器以查看并修改 Qwen Code 的各项设置。
  • 详情： 此命令提供了用户友好的界面来更改控制 Qwen Code 行为和外观的设置。它相当于手动编辑 .qwen/settings.json 文件，但具有验证和引导机制防止错误发生。
  • 用法： 直接运行 /settings 即可打开编辑器。然后你可以浏览或搜索特定设置项，查看它们的当前值，并进行所需调整。某些设置的变更立即生效，而其他一些则需要重启程序。

• /stats

  • 描述： 显示当前 Qwen Code 会话的详细统计信息，包括 token 使用情况、缓存 token 节省量（如有）、以及会话持续时间。注意：只有在使用 API 密钥认证且启用了缓存的情况下才会显示缓存 token 信息，在目前的 OAuth 认证下不显示。

• /theme

  • 描述： 打开一个对话框允许你更改 Qwen Code 的视觉主题。

• /auth

  • 描述： 打开一个对话框允许你更改认证方式。

• /approval-mode

  • 描述： 更改工具使用的审批模式。
  • 用法： /approval-mode [mode] [--session|--project|--user]
  • 可用模式：
    • plan：仅分析，不修改文件或执行命令
    • default：要求批准文件编辑或 shell 命令
    • auto-edit：自动批准文件编辑
    • yolo：自动批准所有工具
  • 示例：
    • /approval-mode plan --project（为此项目持久化 plan 模式）
    • /approval-mode yolo --user（为此用户跨项目持久化 YOLO 模式）

• /about

  • 描述： 显示版本信息。提交 issue 时请附上此信息。

• /agents

  • 描述： 管理专门针对聚焦任务的 AI 子代理。子代理是具备特定专业知识和工具访问权限的独立 AI 助手。
  • 子命令：
    • create：
      • 描述： 启动交互向导创建新的子代理。该向导指导你完成位置选择、AI 驱动提示词生成、工具选择和可视化定制过程。
      • 用法： /agents create
    • manage：
      • 描述： 打开交互管理对话框以查看、编辑和删除现有子代理。展示项目级和个人级代理。
      • 用法： /agents manage
  • 存储位置：
    • 项目级： .qwen/agents/（团队共享，优先级更高）
    • 用户级： ~/.qwen/agents/（个人代理，可在多个项目间使用）
  • 注意： 如需详细了解如何创建和管理子代理，请参阅 Subagents 文档。

• /tools

  • 描述： 显示当前 Qwen Code 中可用的工具列表。
  • 用法： /tools [desc]
  • 子命令：
    • desc 或 descriptions：
      • 描述： 显示每个工具的详细描述，包括提供给模型的工具全称及其完整描述。
    • nodesc 或 nodescriptions：
      • 描述： 隐藏工具描述，只显示工具名称。

• /quit-confirm

  • 描述： 退出 Qwen Code 前显示确认对话框，让你决定如何处理当前会话。
  • 用法： /quit-confirm
  • 功能特性：
    • 立即退出： 不保存任何内容直接退出（等同于 /quit）
    • 生成摘要后退出： 使用 /summary 创建项目摘要后再退出
    • 保存对话后退出： 使用自动生成的标签保存当前对话后再退出
  • 快捷键： 按两次 Ctrl+C 触发退出确认对话框
  • 注意： 当你单次按下 Ctrl+C 时，此命令会自动触发，作为防止意外退出的安全机制。

• /quit（或 /exit）

  • 描述： 立即退出 Qwen Code，无需确认对话框。

• /vim

  • 描述： 开启或关闭 vim 模式。启用 vim 模式后，输入区域支持 NORMAL 和 INSERT 模式下的 vim 式导航和编辑命令。
  • 功能特性：
    • NORMAL 模式： 使用 h, j, k, l 移动光标；使用 w, b, e 按单词跳转；使用 0, $, ^ 定位行首/尾；使用 G（或 gg）跳转到指定行号
    • INSERT 模式： 标准文本输入，按 Esc 返回 NORMAL 模式
    • 编辑命令： 使用 x 删除字符，c 修改文本，i, a, o, O 插入文本；支持复杂操作如 dd, cc, dw, cw
    • 计数支持： 可以前缀数字（如 3h, 5w, 10G）执行重复动作
    • 重复上次命令： 使用 . 重复最后一次编辑操作
    • 持久设置： Vim 模式偏好会被保存到 ~/.qwen/settings.json 并在下次会话中恢复
  • 状态指示： 启用时会在页脚显示 [NORMAL] 或 [INSERT]

• /init

  • 描述： 分析当前目录，默认创建名为 QWEN.md 的上下文文件（或由 contextFileName 指定的文件名）。如果已有非空文件存在，则不做改动。该命令初始化一个空文件，并提示模型填充项目相关的指令内容。

• /language

  • 描述： 查看或更改 UI 和 LLM 输出的语言设置。
  • 子命令：
    • ui：设置 UI 语言（zh-CN 或 en-US）
    • output：设置 LLM 输出语言
  • 用法： /language [ui|output] [language]
  • 示例：
    • /language ui zh-CN（将 UI 语言设为简体中文）
    • /language output English（将 LLM 输出语言设为英文）

### 自定义命令

快速入门，请参见下方的[示例](#example-a-pure-function-refactoring-command)。

自定义命令允许你将最喜爱或最常用的 prompt 保存为个人快捷方式，在 Qwen Code 中重复使用。你可以创建仅适用于单个项目的命令，也可以创建在所有项目中全局可用的命令，从而简化工作流程并确保一致性。

#### 文件位置与优先级

Qwen Code 从两个位置发现命令，并按特定顺序加载：

1.  **用户命令（全局）：** 位于 `~/.qwen/commands/`。这些命令在你正在处理的任何项目中都可用。
2.  **项目命令（本地）：** 位于 `<your-project-root>/.qwen/commands/`。这些命令是当前项目特有的，可以纳入版本控制并与团队共享。

如果项目目录中的命令与用户目录中的命令同名，则**始终使用项目命令**。这允许项目使用特定于项目的版本覆盖全局命令。

#### 命令命名与命名空间

命令的名称由其相对于 `commands` 目录的文件路径决定。子目录用于创建带命名空间的命令，路径分隔符（`/` 或 `\`）会被转换为冒号（`:`）。

- 位于 `~/.qwen/commands/test.toml` 的文件会成为命令 `/test`。
- 位于 `<project>/.qwen/commands/git/commit.toml` 的文件会成为带命名空间的命令 `/git:commit`。

#### TOML 文件格式 (v1)

你的命令定义文件必须使用 TOML 格式编写，并使用 `.toml` 文件扩展名。

##### 必填字段

- `prompt` (String)：命令执行时发送给模型的 prompt。可以是单行或多行字符串。

##### 可选字段

- `description` (String)：对该命令功能的简短一行描述。这段文字会显示在 `/help` 菜单中你的命令旁边。**如果你省略此字段，系统将根据文件名自动生成一个通用描述。**

#### 处理参数

自定义命令支持两种强大的参数处理方法。CLI 会根据你的命令 `prompt` 内容自动选择正确的方法。

##### 1. 使用 `{{args}}` 的上下文感知注入

如果你的 `prompt` 包含特殊占位符 `{{args}}`，CLI 会将该占位符替换为用户在命令名后输入的文本。

这种注入的行为取决于它被使用的位置：

**A. 原始注入（Shell 命令外部）**

当在 prompt 的主体中使用时，参数会按用户输入的原样注入。

**示例 (`git/fix.toml`):**

```toml

# 调用方式：/git:fix "按钮未对齐"

description = "为给定问题生成修复方案。"
prompt = "请为这里描述的问题提供代码修复：{{args}}。"

模型接收到的是：请为这里描述的问题提供代码修复："按钮未对齐"。

B. 在 Shell 命令中使用参数（在 !{...} 块内）

当你在 shell 注入块（!{...}）中使用 {{args}} 时，这些参数会在替换前自动进行 shell 转义（shell-escaped）。这使得你可以安全地将参数传递给 shell 命令，确保生成的命令语法正确且安全，同时防止命令注入漏洞。

示例（/grep-code.toml）：

prompt = """
请总结模式 `{{args}}` 的查找结果。
 
搜索结果：
!{grep -r {{args}} .}
"""

当你运行 /grep-code It's complicated：

1. CLI 检测到 {{args}} 同时出现在 !{...} 块内外。
2. 外部：第一个 {{args}} 直接替换为原始值 It's complicated。
3. 内部：第二个 {{args}} 替换为转义后的版本（例如，在 Linux 上是 "It's complicated"）。
4. 实际执行的命令是 grep -r "It's complicated" .。
5. CLI 会提示你确认这个确切、安全的命令后再执行。
6. 最终 prompt 被发送出去。

2. 默认参数处理

如果你的 prompt 中没有包含特殊占位符 {{args}}，CLI 会使用默认行为来处理参数。

如果你为命令提供了参数（例如：/mycommand arg1），CLI 会在 prompt 的末尾追加你输入的完整命令，并用两个换行符分隔。这样可以让模型同时看到原始指令和你刚刚提供的具体参数。

如果你没有提供任何参数（例如：/mycommand），则 prompt 会原样发送给模型，不追加任何内容。

示例 (changelog.toml):

这个示例展示了如何通过为模型定义角色、说明在哪里找到用户输入以及指定预期格式和行为来创建一个健壮的命令。

 
# In: <project>/.qwen/commands/changelog.toml
 
# 调用方式：/changelog 1.2.0 added "Support for default argument parsing."
 
description = "向项目的 CHANGELOG.md 文件添加新条目。"
prompt = """
 
# 任务：更新变更日志
 
你是这个软件项目的专家维护者。用户调用了添加新变更日志条目的命令。
 
**用户的原始命令会附加在你的指令下方。**
 
你的任务是从用户输入中解析出 `<version>`、`<change_type>` 和 `<message>`，然后使用 `write_file` 工具正确更新 `CHANGELOG.md` 文件。
 
## 预期格式
命令遵循以下格式：`/changelog <version> <type> <message>`
- `<type>` 必须是以下之一："added"、"changed"、"fixed"、"removed"。
 
```markdown
## 行为
1. 读取 `CHANGELOG.md` 文件。
2. 找到指定 `<version>` 的部分。
3. 在正确的 `<type>` 标题下添加 `<message>`。
4. 如果版本或类型部分不存在，则创建它。
5. 严格遵守 "Keep a Changelog" 格式。
"""
 
当你运行 `/changelog 1.2.0 added "New feature"` 时，发送给模型的最终文本将是原始提示后跟两个换行符和你输入的命令。

3. 使用 !{...} 执行 Shell 命令

你可以通过在 prompt 中直接执行 shell 命令并注入其输出，使你的命令更加动态化。这非常适合从本地环境中获取上下文信息，例如读取文件内容或检查 Git 状态。

当自定义命令尝试执行 shell 命令时，Qwen Code 现在会在继续执行前提示你进行确认。这是一个安全措施，确保只有预期的命令才能被执行。

工作原理：

1. 注入命令： 使用 !{...} 语法。
2. 参数替换： 如果块内包含 {{args}}，它会自动进行 shell 转义（参见上方的 Context-Aware Injection）。
3. 健壮解析： 解析器能够正确处理复杂的 shell 命令，包括嵌套大括号的情况，比如 JSON 数据。注意： !{...} 内部的内容必须保持大括号（{ 和 }）配对。如果你需要执行包含未配对括号的命令，请考虑将其包装在一个外部脚本文件中，并在 !{...} 块中调用该脚本。
4. 安全检查与确认： CLI 会对最终解析后的命令（即参数转义和替换之后的结果）执行安全检查。系统将弹出一个对话框，显示即将执行的确切命令。
5. 执行与错误报告： 命令开始执行。如果命令失败，注入到 prompt 中的输出将包含错误信息（stderr），后跟状态行，例如 [Shell command exited with code 1]。这有助于模型理解失败的具体上下文。

示例 (git/commit.toml)：

此命令获取暂存区的 git diff，并使用它来请求模型生成一条 commit 消息。

 
# 位于：<project>/.qwen/commands/git/commit.toml
 
# 调用方式：/git:commit
 
description = "根据暂存的更改生成 Git commit message。"
 
# prompt 中使用 !{...} 来执行命令并注入其输出。
prompt = """
请根据以下 git diff 生成一条 Conventional Commit 格式的 commit message：
 
```diff
!{git diff --staged}
```
 
"""
 
```
 
当你运行 `/git:commit` 时，CLI 首先会执行 `git diff --staged` 命令，然后将 `!{git diff --staged}` 替换为该命令的输出结果，最后将完整拼接好的 prompt 发送给模型处理。
 
##### 4. 使用 `@{...}` 注入文件内容
 
你可以使用 `@{...}` 语法将文件内容或目录列表直接嵌入到你的 prompt 中。这对于创建需要操作特定文件的命令非常有用。
 
**工作原理：**
 
- **文件注入**：`@{path/to/file.txt}` 会被替换为 `file.txt` 的内容。
- **多模态支持**：如果路径指向受支持的图像（如 PNG、JPEG）、PDF、音频或视频文件，它将被正确编码并作为多模态输入注入。其他二进制文件会被优雅地处理并跳过。
- **目录列表**：`@{path/to/dir}` 会被遍历，目录及其所有子目录中的每个文件都会被插入到 prompt 中。如果启用了 `.gitignore` 和 `.qwenignore`，则会遵循这些忽略规则。
- **工作区感知**：命令会在当前目录和任何其他工作区目录中搜索路径。如果绝对路径在工作区内，则允许使用。
- **处理顺序**：`@{...}` 的文件内容注入会在 shell 命令 (`!{...}`) 和参数替换 (`{{args}}`) _之前_ 处理。
- **解析规则**：解析器要求 `@{...}` 内部的内容（即路径）具有平衡的大括号 (`{` 和 `}`)。
 
**示例 (`review.toml`)：**
 
此命令注入一个 _固定_ 的最佳实践文件 (`docs/best-practices.md`) 的内容，并使用用户的参数为代码审查提供上下文。
 
```toml
 
```toml
# 位置： <project>/.qwen/commands/review.toml
 
# 调用方式： /review FileCommandLoader.ts
 
description = "使用最佳实践指南审查提供的上下文。"
prompt = """
你是一位代码审查专家。
 
你的任务是审查 {{args}}。
 
在提供审查意见时，请参考以下最佳实践：
 
@{docs/best-practices.md}
"""
```
 
当你运行 `/review FileCommandLoader.ts` 时，`@{docs/best-practices.md}` 占位符会被该文件的内容替换，而 `{{args}}` 则会被你提供的文本替换，之后生成的完整 prompt 会发送给模型。
 
#### 示例：一个“纯函数”重构命令
 
让我们创建一个全局命令，用于要求模型重构一段代码。
 
**1. 创建文件和目录：**
 
首先确保用户命令目录存在，然后创建一个 `refactor` 子目录用于组织结构，并创建最终的 TOML 文件。
 
```bash
mkdir -p ~/.qwen/commands/refactor
touch ~/.qwen/commands/refactor/pure.toml
```
 
**2. 向文件中添加内容：**
 
在编辑器中打开 `~/.qwen/commands/refactor/pure.toml` 并添加以下内容。我们包含可选的 `description` 字段作为最佳实践。
 
```toml
 
# In: ~/.qwen/commands/refactor/pure.toml
 
# 此命令将通过以下方式调用：/refactor:pure
 
description = "要求模型将当前上下文重构为纯函数。"
 
prompt = """
请分析我在当前上下文中提供的代码。
将其重构为一个纯函数。
 
你的回复应包括：
1. 重构后的纯函数代码块。
2. 简要说明你所做的关键更改以及为什么这些更改有助于实现纯函数特性。
"""
```
 
**3. 运行命令：**
 
就是这样！你现在可以在 CLI 中运行你的命令了。首先，你可以添加一个文件到上下文中，然后调用你的命令：
 
```
> @my-messy-function.js
> /refactor:pure
```
 
Qwen Code 将会执行你在 TOML 文件中定义的多行 prompt。
 
## 输入提示快捷键
 
这些快捷键直接应用于输入提示中的文本操作。
 
- **撤销：**
  - **键盘快捷键：** 按 **Ctrl+z** 撤销输入提示中的上一个操作。
 
- **重做：**
  - **键盘快捷键：** 按 **Ctrl+Shift+Z** 重做输入提示中上次被撤销的操作。
 
## At 命令 (`@`)
 
At 命令用于将文件或目录的内容作为 prompt 的一部分发送给模型。这些命令支持 Git 感知过滤。
 
- **`@<path_to_file_or_directory>`**
  - **说明：** 将指定文件或多个文件的内容注入到当前的 prompt 中。这在你需要针对特定代码、文本或一组文件提问时非常有用。
  - **示例：**
    - `@path/to/your/file.txt Explain this text.`
    - `@src/my_project/ Summarize the code in this directory.`
    - `What is this file about? @README.md`
  - **详细说明：**
    - 如果提供的是单个文件路径，则读取该文件内容。
    - 如果提供的是目录路径，则尝试读取该目录及其子目录下的所有文件内容。
    - 路径中如果包含空格，需要用反斜杠转义（例如：`@My\ Documents/file.txt`）。
    - 内部使用 `read_many_files` 工具来实现功能。内容会被先获取并插入到你的查询中，然后再发送给模型。
    - **Git 感知过滤：** 默认情况下会排除被 Git 忽略的文件（如 `node_modules/`、`dist/`、`.env`、`.git/`）。可以通过 `context.fileFiltering` 设置更改此行为。
    - **文件类型：** 此命令适用于基于文本的文件。虽然它可能会尝试读取任何类型的文件，但底层的 `read_many_files` 工具为了保证性能和相关性，可能会跳过或截断二进制文件或非常大的文件，并会在工具输出中标明哪些文件被跳过了。
  - **输出：** CLI 会显示一条工具调用消息，表明使用了 `read_many_files`，同时还会展示处理状态以及所涉及的文件路径信息。
 
- **`@`（单独的 @ 符号）**
  - **说明：** 如果你只输入了一个 `@` 符号而没有跟路径，那么整个查询将原样传递给模型。当你需要在 prompt 中明确讨论 `@` 这个符号本身时，这个方式可能很有用。
 
### `@` 命令的错误处理
 
- 如果 `@` 后面指定的路径未找到或无效，将显示错误消息，查询可能不会发送到模型，或者会发送但不包含文件内容。
- 如果 `read_many_files` 工具遇到错误（例如权限问题），也会报告此错误。
 
## Shell 模式和透传命令（`!`）
 
使用 `!` 前缀可以直接在 Qwen Code 内与系统 shell 进行交互。
 
- **`!<shell_command>`**
  - **说明：** 使用 `bash`（Linux/macOS）或 `cmd.exe`（Windows）执行指定的 `<shell_command>`。命令的所有输出或错误信息都会显示在终端中。
  - **示例：**
    - `!ls -la`（执行 `ls -la` 并返回 Qwen Code）
    - `!git status`（执行 `git status` 并返回 Qwen Code）
 
- **`!`（切换 Shell 模式）**
  - **说明：** 单独输入 `!` 可以切换 Shell 模式。
    - **进入 Shell 模式：**
      - 启用后，Shell 模式会使用不同的颜色和“Shell 模式指示器”。
      - 在 Shell 模式下，你输入的内容会被直接解释为 shell 命令。
    - **退出 Shell 模式：**
      - 退出后，UI 将恢复为标准外观，并重新启用正常的 Qwen Code 行为。
 
- **注意事项：** 所有通过 `!` 执行的命令都具有与你在终端中直接运行时相同的权限和影响。
 
- **环境变量：** 当通过 `!` 或 Shell 模式执行命令时，子进程中会设置 `QWEN_CODE=1` 环境变量。这使得脚本或工具可以检测其是否从 CLI 中运行。