---
title: "用 @ 点名文件，而不是描述路径"
summary: "TUI 里输入 @ 会模糊搜索文件。把关键路径钉进提示，比让模型自己逛仓库更稳。"
category: prompt
level: starter
surfaces: [cli, app, ide]
tags: ["@", "上下文", "TUI"]
canonical: /tips/mention-files/
---

# 用 @ 点名文件，而不是描述路径

TUI 里输入 @ 会模糊搜索文件。把关键路径钉进提示，比让模型自己逛仓库更稳。

在 CLI 里输入 `@` 会打开统一提及菜单（文件、插件、技能）。也可用 `/mention`。

适合钉死的东西：

- 出 bug 的文件和它的调用方
- 现有实现范例（「照这个写」）
- 失败的测试或 CI 日志
- 设计文档、schema、错误截图（`-i` 附加图片）

大仓库里「你自己找相关代码」会浪费一轮探索。先帮它收窄搜索空间。

## 来源

- [Codex CLI Cheat Sheet](https://www.agenticcodingweekly.com/p/codex-cli-cheat-sheet)