---
title: "suppress_unstable_features_warning 必须写在顶层，不是 [notice]"
summary: "只关掉「开发中特性已打开」那条警告。写进 [notice] 或 [features] 等于没配。它不会让不稳定开关变安全。"
category: config
level: starter
surfaces: [cli]
tags: ["suppress_unstable_features_warning", "features", "config.toml"]
canonical: /tips/suppress-unstable-features-warning/
---

# suppress_unstable_features_warning 必须写在顶层，不是 [notice]

只关掉「开发中特性已打开」那条警告。写进 [notice] 或 [features] 等于没配。它不会让不稳定开关变安全。

打开 `collab`、`codex_git_commit` 这类 UnderDevelopment 开关后，启动会警告特性不完整。只想消提示、仍然接受风险时：

```toml
suppress_unstable_features_warning = true
```

这是顶层布尔键，写在任何 `[table]` 之前。官方参考写明：它只抑制「已启用开发中特性」的警告。

常见抄错：把它放进 `[notice]`（旁边往往是 `hide_full_access_warning`）或 `[features]`。TOML 会把它收进上一张表，警告原文还是叫你写这个键名，所以看起来「已经写了还不消失」。挪到文件最顶部再新开会话。

关警告不等于这些开关可用。排错时先对照 `codex features list` 和 `/experimental`，确认你真的要开开发中特性，而不是先把警告藏起来。

## 来源

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