---
title: "用 .codexignore 把生成物踢出上下文"
summary: "node_modules、dist、生成代码会占掉推理额度。给仓库加一份 gitignore 风格的排除表。"
category: config
level: intermediate
surfaces: [cli, ide, app]
tags: [".codexignore", "上下文", "配置"]
canonical: /tips/codexignore-generated/
---

# 用 .codexignore 把生成物踢出上下文

node_modules、dist、生成代码会占掉推理额度。给仓库加一份 gitignore 风格的排除表。

在仓库根放 `.codexignore`，写法与 gitignore 相同。先排除 `vendor/`、`dist/`、`node_modules/`、`*.min.js`、`*.generated.ts` 这类大而无关的树。

这和沙箱不是一回事：ignore 管「看见什么」，sandbox / approval 管「能改什么」。两边都要设。

非 Git 项目或嵌套根目录时，同时检查 `project_root_markers`。根认错了，`AGENTS.md`、`.codex/config.toml` 和 workspace 边界都会一起错。

## 来源

- [Codex CLI Power-User Playbook](https://codex.danielvaughan.com/2026/06/04/codex-cli-power-user-playbook-non-obvious-features-configuration-tricks-v0137/)
- [OpenAI · Best practices](https://developers.openai.com/codex/learn/best-practices)