---
title: "技能目录被截断：先禁用，再调 skills.max_context_tokens"
summary: "启动时只塞技能名和描述，默认大约是模型窗口的 2%。显式值上限 10000。装太多时先 [[skills.config]] 关掉不用的，不要先把预算拉满。"
category: skills
level: intermediate
surfaces: [cli, app]
tags: ["skills.max_context_tokens", "Skills", "上下文"]
canonical: /tips/skill-max-context-tokens/
---

# 技能目录被截断：先禁用，再调 skills.max_context_tokens

启动时只塞技能名和描述，默认大约是模型窗口的 2%。显式值上限 10000。装太多时先 [[skills.config]] 关掉不用的，不要先把预算拉满。

`/skills` 里缺技能、或启动警告说目录被截断时，先关掉不用的，不要先加大窗口：

```toml
[[skills.config]]
path = "/home/you/.agents/skills/noisy/SKILL.md"
enabled = false

[skills]
max_context_tokens = 8000
```

`skills.max_context_tokens` 管的是**可用技能目录**（name / description）进提示的预算，不是选中之后整份 `SKILL.md`。默认大约是当前模型上下文窗口的 2%；你写了正整数才会覆盖，且官方把显式值封顶在 `10000`。窗口未知时，技能页还提过大约 8000 字符的回退，不要把两种单位抄成一件事。

`max_context_tokens` 属于 `[skills]` 表。写进 `[[skills.config]]` 某一条里不会当目录预算。改完必须重启 Codex。

2026 年 7 月有文章还写「2% 写死、调不了」。8 月的 PR 已经加了这个键，不要再照抄那段。目录再大，模型选中技能后仍会读完整说明；真正省上下文的办法是少装、短 description、关掉不用的技能。

## 来源

- [OpenAI · Configuration reference](https://developers.openai.com/codex/config-reference)
- [openai/codex#38978](https://github.com/openai/codex/pull/38978)