应创建 .claudeignore 文件过滤冗余路径:一、在项目根目录新建该纯文本文件;二、按 .gitignore 语法编写规则,如 node_modules/、*.log;三、通过启动日志中“loaded .claudeignore”和“skipped n files”验证生效。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

如果您在使用 Hermes Agent 运行 Claude 模型时发现处理了大量无关文件,导致 token 消耗增加、响应延迟上升或费用异常升高,则很可能是项目目录中存在未被过滤的冗余文件。通过创建 .claudeignore 文件可显式声明需排除的路径,从而减少上下文体积、降低推理成本。以下是具体配置步骤:
一、手动创建 .claudeignore 文件
该方法适用于所有操作系统,无需额外工具,直接在项目根目录下生成纯文本忽略文件,Claude 客户端或 Hermes Agent 会在加载上下文前自动读取并跳过匹配路径。
1、打开项目根目录(即运行 Hermes Agent 的工作目录)。
2、新建一个名为 .claudeignore 的纯文本文件(注意开头为英文点号,无扩展名)。
3、使用任意文本编辑器(如 VS Code、Notepad++、nano)打开该文件。
4、按行填写需屏蔽的文件或目录路径模式,每行一条规则。
二、编写标准忽略规则
规则语法与 .gitignore 兼容,支持通配符和注释,Hermes Agent 将逐行匹配路径,命中即跳过上传与解析,不计入上下文长度计算。
1、以 # 开头的行视为注释,不会生效。
2、单独一行 * 表示忽略当前目录所有文件(不含子目录)。
统一LLM网关 - 一个API对接70+AI模型,使用单一API密钥即可调用GPT、Claude、Gemini、Qwen、Deepseek、Grok等主流模型。
3、写入 node_modules/ 可递归屏蔽整个依赖目录。
4、写入 *.log 可忽略所有日志文件。
5、写入 /dist/(前置斜杠)表示仅忽略项目根下的 dist 目录,不匹配子目录中的同名路径。
三、验证 .claudeignore 是否生效
Hermes Agent 在启动分析流程前会输出已加载的忽略规则及匹配统计,可通过日志确认屏蔽行为是否触发,避免误配导致关键文件被遗漏。
1、在终端执行 Hermes Agent 启动命令(例如 hermes run --model claude-3-5-sonnet)。
2、观察控制台首段日志,查找类似 "Loaded .claudeignore with 7 patterns" 的提示行。
3、继续查看后续日志中是否出现 "Skipped 12 files matching .claudeignore" 的计数信息。
4、若未见跳过提示,检查文件名是否拼写为 .claudeignore(非 .claudignore 或 claude.ignore)且位于当前工作目录。









