AI custom instructions character limits (2026 cheat sheet).
By Bernard Huang · Updated
ChatGPT's longer Custom Instructions fields are documented at 1,500 characters each. OpenAI Codex caps combined AGENTS.md files at 32 KiB (32,768 bytes, set by project_doc_max_bytes). Claude Personal Preferences, Claude Projects, Claude Code output styles, Meta Muse Soul.md, and Gemini Gems accept full multi-paragraph Markdown blocks without a 1,500-character cliff, though keeping rules under 1,200 characters improves instruction adherence.
On this page
2026 custom instructions limit & path reference table.
| Platform & surface | Exact menu path or file location | Documented cap | Recommended tuning size |
|---|---|---|---|
| ChatGPT Custom Instructions | Settings → Personalization → Custom Instructions | 1,500 characters per longer field | 600–1,200 chars (use our compact generator) |
| ChatGPT Projects | Project → Project Instructions | Multi-kilobyte Markdown (overrides account custom instructions in that project) | 800–2,000 chars |
| OpenAI Codex & ChatGPT Work | ~/.codex/AGENTS.md + repo AGENTS.md / AGENTS.override.md | 32 KiB (32,768 bytes) combined across all files (project_doc_max_bytes) | Keep personal ~/.codex/AGENTS.md under 2 KiB |
| Claude Personal Preferences | Settings → General → Personal Preferences | Multi-paragraph text field (no 1,500-char lock) | 500–1,200 chars (6–10 bullets) |
| Claude Projects | Project → Project Instructions | Shared with project knowledge context window | 800–2,500 chars |
| Claude Code | ~/.claude/CLAUDE.md & ~/.claude/output-styles/*.md | Local Markdown file loaded into session context | 600–1,800 chars with keep-coding-instructions: true |
| Meta Muse | Settings → Personalization → Assistant Identity → Soul.md | Editable Markdown file (alongside Identity.md and Memory.md) | 500–1,500 chars inside How to work with me |
| Google Gemini | Settings → Saved info, Gems, or ~/.gemini/GEMINI.md | Short individual memories in Saved info; full Markdown in Gems and GEMINI.md | 1–2 sentences per Saved info item; 600–1,500 chars in Gems |
| xAI Grok & Grok Bot | Account response settings or Grok Bot Description | Compact text box in Bot Description; full system prompt in API | 500–1,200 chars |
| Cursor & GitHub Copilot | .cursor/rules/*.mdc & .github/copilot-instructions.md | Local repository Markdown files | 600–1,800 chars |
Why shorter tunings beat 10,000-word prompt walls.
Even on surfaces that accept large Markdown files, stuffing thousands of words of personality lore into your global instructions hurts performance for three reasons:
- Instruction dilution: Every rule you add competes for attention with your actual task prompt and with the rules that matter most.
- Over-literal compliance in newer reasoning models: As OpenAI noted in its developer guidance for GPT-6 Astra, newer models listen much harder to system and
AGENTS.mdinstructions than earlier generations did. Forceful, all-caps boundary paragraphs written for older models cause modern agents to halt early or over-apply a formatting rule where it does not belong. - Silent byte-cap truncation in monorepos: In OpenAI Codex, the 32 KiB
project_doc_max_byteslimit is shared across your global~/.codex/AGENTS.md, the repo rootAGENTS.md, and any nested folderAGENTS.md. A compact 700-byte personal tuning leaves over 97% of the budget free for repository build and test instructions.
A universal 580-character tuning block that fits every platform.
This reviewed block is 580 characters (well under ChatGPT's 1,500-character cap and less than 2% of Codex's 32 KiB budget). Paste it anywhere:
Need a version tailored to your own personality profile? Open the Custom Instructions Generator or pick any of the 43 profiles in the library and select ChatGPT · custom instructions for an automatic under-1,500-character export.
Questions people ask.
What is the character limit for ChatGPT Custom Instructions in 2026?
OpenAI documents a 1,500-character limit for the longer Custom Instructions fields under Settings, Personalization, Custom Instructions. Every profile in AgentTune includes a reviewed compact export under 1,500 characters.
What is the byte limit for OpenAI Codex AGENTS.md?
Codex reads up to 32 KiB (32,768 bytes) combined across all AGENTS.md and AGENTS.override.md files in the directory chain, configured by project_doc_max_bytes.
Do ChatGPT Project Instructions have the same 1,500-character limit?
No. Project Instructions inside a ChatGPT Project accept full multi-paragraph Markdown tunings and override your global Custom Instructions inside that project.
How many rules should I put in Claude Personal Preferences or Meta Muse Soul.md?
Six to ten clear bullet points (roughly 500 to 1,200 characters) cover tone, answer order, formatting, and pushback without crowding out your task context.
What changed.
- First published with 2026 character and byte limits across ChatGPT, Codex, Claude, Muse, Gemini, Cursor, and Grok.