Reference · Limits & Quotas

AI custom instructions character limits (2026 cheat sheet).

Exact field lengths, byte caps, and file paths across ChatGPT, OpenAI Codex, Claude, Claude Code, Meta Muse, Gemini, Cursor, and Grok.

Quick answer: ChatGPT caps each Custom Instructions field at 1,500 characters, and OpenAI Codex caps combined AGENTS.md files at 32 KiB (32,768 bytes via project_doc_max_bytes). Claude Personal Preferences, Claude Projects, Claude Code, Meta Muse Soul.md, and Gemini Gems accept multi-paragraph Markdown without a 1,500-character cliff, though keeping rules between 500 and 1,200 characters improves instruction adherence.
On this page

2026 custom instructions limit & path reference table.

Platform & surfaceExact menu path or file locationDocumented capRecommended tuning size
ChatGPT Custom InstructionsSettings → Personalization → Custom Instructions1,500 characters per longer field600–1,200 chars (use our compact generator)
ChatGPT ProjectsProject → Project InstructionsMulti-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.md32 KiB (32,768 bytes) combined across all files (project_doc_max_bytes)Keep personal ~/.codex/AGENTS.md under 2 KiB
Claude Personal PreferencesSettings → General → Personal PreferencesMulti-paragraph text field (no 1,500-char lock)500–1,200 chars (6–10 bullets)
Claude ProjectsProject → Project InstructionsShared with project knowledge context window800–2,500 chars
Claude Code~/.claude/CLAUDE.md & ~/.claude/output-styles/*.mdLocal Markdown file loaded into session context600–1,800 chars with keep-coding-instructions: true
Meta MuseSettings → Personalization → Assistant Identity → Soul.mdEditable Markdown file (alongside Identity.md and Memory.md)500–1,500 chars inside How to work with me
Google GeminiSettings → Saved info, Gems, or ~/.gemini/GEMINI.mdShort individual memories in Saved info; full Markdown in Gems and GEMINI.md1–2 sentences per Saved info item; 600–1,500 chars in Gems
xAI Grok & Grok BotAccount response settings or Grok Bot DescriptionCompact text box in Bot Description; full system prompt in API500–1,200 chars
Cursor & GitHub Copilot.cursor/rules/*.mdc & .github/copilot-instructions.mdLocal repository Markdown files600–1,800 chars

Why shorter tunings beat 10,000-word prompt walls.

Even when an app accepts large Markdown files, pasting thousands of words into global instructions hurts reply quality for three reasons:

  1. Instruction dilution: Every extra rule competes for attention with your live task prompt.
  2. Over-literal compliance: Newer reasoning models (like GPT-6 Astra and Claude Opus 5.5) follow system and AGENTS.md rules much more literally than older models did. All-caps“NEVER/ALWAYS” walls often cause agents to stop early or force a rigid format onto the wrong task.
  3. Shared monorepo byte caps: In OpenAI Codex, the 32 KiB project_doc_max_bytes budget is shared across ~/.codex/AGENTS.md, the repo root AGENTS.md, and nested folder AGENTS.md files. Keeping your personal file under 1 KiB leaves 97% of the budget for repo build and test commands.

A universal 580-character tuning block that fits every platform.

This 580-character block fits comfortably inside ChatGPT’s 1,500-character box and takes less than 2% of Codex’s 32 KiB budget:

## Communication preferences - Lead with the direct answer, conclusion, or recommendation in the first sentence. - Match length to complexity; keep routine replies under 150 words. - Use plain prose by default. Add bullet lists or tables only when comparing three or more items. - Skip throat-clearing openers, flattery, and "let me know if you need anything else" closers. - Push back directly when an assumption in my prompt is mistaken, and state why. - Separate verified facts from inferences and flag material uncertainty in one line.

Want a version matched 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 a ready-to-paste compact block.

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.

Sources.

Keep going.