AI 助手
TRAE 智能问答助手
你好,我是 TRAE 文档问答助手 🎉 你在阅读当前文档的过程中,无论对文档概念的解释,还是文档内容方面的疑问,都可以随时向我提问,我会全力为你解答
推荐问题
TRAE IDE 里最热门的 Skill 是哪些?
如何创建自定义智能体?
如何配置 Rules?
文档反馈

基础用法

启动 TraeCode CLI 2.0 后,直接在底部输入框描述任务并按 Enter 发送。常见任务包括:

  • 解释仓库结构、模块职责和调用链。
  • 修改 bug 或补齐边界处理。
  • 生成或完善单元测试。
  • 评审当前 Git 改动。
  • 运行测试并根据失败结果修复问题。
  • 整理变更说明、排查日志或生成迁移方案。

对话基础

  • 输入消息:直接在底部输入框(composer)里打字。
  • 发送:按 Enter 提交当前消息。
  • 换行(不发送)Shift+EnterCtrl+JAlt+Enter(终端支持不同时可任选其一)。如果你的终端默认不支持 Shift+Enter,运行 /terminal-setup 安装对应键位绑定。
  • 多行输入:换行后可继续编辑,输入框会自动增高。
  • 排队消息:任务运行期间,按 Tab 可把当前输入排入队列,待当前回合结束后自动发送。用 Alt+Up / Shift+Left 编辑最近排队的那条消息。

输入框里的特殊符号

在输入框开头或中途键入以下字符会弹出对应的辅助面板:

字符

作用

/ 打开 Slash 命令 弹窗,如 /model/review/help
@ 打开 文件检索 弹窗,把项目里的文件「@提及」给智能体作为上下文
! 进入 Shell 命令 模式,直接执行一条 shell 命令(如 !ls
$ 打开 连接器 / 插件(connector) 弹窗

弹窗中可用 ↑/↓Ctrl+P/Ctrl+N 移动,Enter 选中,Esc 关闭。

图片与粘贴

  • 粘贴图片Ctrl+V(macOS(也支持Cmd+V) / Windows)可把剪贴板里的图片作为附件加入消息。
  • 大段文本粘贴:粘贴超过阈值的文本时,输入框会折叠成 [Pasted Content N chars] 占位符,完整内容在提交时自动展开,避免刷屏。

中断、回溯与撤销

  • 中断当前任务Esc(或 Ctrl+C)停止正在运行的回合。
  • 回溯 / 编辑上一条消息:输入框为空时连按 Esc 进入 backtrack,可回到之前某条消息重新编辑。
  • 回退工作区改动/rewind(别名 /undo)回退对话并恢复工作区文件;/undo-rewind 撤销上一次 rewind。

滚动与转录

  • 转录浮层Ctrl+O 打开完整对话的分页浏览视图,支持 ↑/↓PageUp/PageDownHome/End 等导航,q 关闭。
  • 原始模式Alt+R/raw 切换「raw scrollback」复制友好模式,便于直接选中复制纯文本。
  • 复制输出/copy 把最近一条智能体输出复制到剪贴板;/copy N 复制倒数第 N 条。

状态栏

底部状态行(可用 /statusline 自定义显示项)通常展示:当前模型与推理强度、工作目录 / 项目根、Git 分支与 diff 统计、权限 / 审批模式、上下文窗口占用、用量额度、会话标题与 token 用量、版本号等。

终端标题栏显示项可用 /title 配置。