Codex Team Config: Shared Configuration v2026-01-23
Team Config groups shared Codex settings across repos and machines. Share defaults, rules, and skills with automatic precedence handling and admin enforcement.
TL;DR
- Team Config lets teams standardize Codex settings across repos and machines
- Share config.toml defaults, rules/, and skills/ from centralized locations
- Layered precedence: system → user → repo root → parent folders → working directory
New
- Team Config — Groups shared configuration files (.codex/) so teams can standardize Codex behavior across repositories and machines without per-repo setup.
- Multi-location loading — Codex loads config from working directory, parent folders, repo root, user home (~/.codex/), and system (/etc/codex/) with automatic precedence handling.
- Shareable components — Distribute config.toml defaults, rules/ for command controls, and skills/ for reusable workflows across your team.
- Admin enforcement — requirements.toml overrides all defaults regardless of location, letting admins enforce constraints without blocking user customization.
To learn more, see the Team Config documentation.
Source: Codex
