GPT-5.5-Codex in Production: What Actually Changes

Last updated: June 3, 2026

Official Sources#

I migrated three production coding agents from gpt-5-codex to gpt-5.5-codex over a single weekend. One was a multi-file refactor bot that runs against a 400k LOC monorepo. One was a PR triage agent that comments on every pull request before a human looks at it. The third was an internal CLI that scaffolds boilerplate from JIRA tickets.

What follows is the real diff: token cost, p95 latency, PR acceptance rate, and the four prompt scaffolds I kept versus the ones I had to throw away. If you are sitting on the fence about migrating, this is the writeup I wish I had on Friday night.

The Unification Thesis#

The headline is not the version bump. The headline is that OpenAI has merged its two parallel post-training stacks into one. For most of 2025, gpt-5-codex and gpt-5 were trained for different optimization targets. Codex variants were tuned for long-horizon, tool-using, file-editing workflows. The base GPT-5 line was tuned for reasoning, instruction following, and general chat.

For model-selection context, compare this with OpenAI Codex: Cloud AI Coding With GPT-5.3 and OpenAI vs Anthropic in 2026 - Models, Tools, and Developer Experience; the useful question is not only benchmark quality, but where the model fits in a real developer workflow.

gpt-5.5-codex is the first model that inherits both. The instruction-following work that landed in 5.5 base shows up in the Codex variant immediately, and the multi-file editing behavior that Codex pioneered now informs how the base model handles code. In practice this means fewer surprises when you mix prompt patterns from your chat stack with patterns from your agent stack.

For builders this matters because it lowers the cost of standardizing on one model across product surfaces. I now run the same model behind my CLI, my PR bot, and my customer-facing chat features. One eval suite, one cost line, one prompt library.

Migration Mechanics#

The model string change itself is trivial. The OpenAI Python SDK migration was three lines per agent.

from openai import OpenAI

client = OpenAI()

response = client.responses.create(
    model="gpt-5.5-codex",
    input=[
        {"role": "developer", "content": "You are a senior backend engineer reviewing pull requests for a Next.js monorepo. You always cite file paths and line numbers."},
        {"role": "user", "content": "Review the diff in pr_12894.patch and flag any issues with auth, database queries, or type safety."},
    ],
    tools=[{"type": "code_interpreter", "container": {"type": "auto"}}],
    reasoning={"effort": "medium"},
)

print(response.output_text)

Two things to watch when migrating. First, any code that pinned reasoning.effort to high for gpt-5-codex should drop to medium first and benchmark. The 5.5 model is more efficient at the same effort level, and several of my agents got better outputs at lower effort, not higher. Second, deprecated parameters from older Codex preview models such as max_completion_tokens should be replaced with max_output_tokens in the Responses API. The SDK will warn, not error, so it is easy to miss.

The system-prompt rewrites that paid off were small but consistent. I removed the explicit "think step by step" scaffolding that I had baked into gpt-5-codex prompts. In 5.5 it is redundant and occasionally produces verbose preambles that you then have to strip in post. I also tightened my output-format instructions, because the new model follows JSON schemas and structured-output requests with noticeably less drift.

If you keep prompts in version control, and you should, now is the time to tag the pre-migration prompt set. We use Promptlock to version prompts across model migrations exactly so the rollback is one command, not a git archaeology session. The diff between my gpt-5-codex and gpt-5.5-codex prompt branches is genuinely useful as a reference.

Benchmarks From My Own Agents#

These numbers are from production traffic over a 7 day window before and after migration. Same prompts where I did not change them, same tools, same eval set. Token counts are summed across input plus output.

A few honest caveats. The refactor bot saw the biggest gain because it benefits most from longer-horizon planning, which is where 5.5 made the cleanest jump. The PR triage agent was already cheap and fast, so the absolute delta is small. The boilerplate CLI is so structured that the model improvements are almost noise. The win there is consistency, not capability.

I track all of this from my status bar with Cost Tape, which broke the migration cost delta out per agent in real time. Watching the line chart drop on the refactor bot for three straight days was the moment I committed to rolling out fully.

What 5.5 Finally Gets Right#

Multi-file edits are the thing I want to talk about first, because this was the longest standing pain point with the 5-codex line. The previous model would correctly identify that a refactor required changes in five files, then make the edits inconsistently, sometimes naming a renamed function correctly in three places and using the old name in the other two. 5.5 holds the rename across the entire edit batch with much higher reliability. My refactor bot now lands cross-file renames on the first try in roughly four out of five attempts, up from about half.

Long-horizon tasks are the second improvement. Tasks that span more than 20 tool calls used to drift. The model would forget early constraints, contradict its own plan, or revisit the same file three times. 5.5 holds the plan better. I am no longer adding "remember the original requirement" reminders into my system prompts every five turns.

Instruction following on ambiguous tickets is the third. JIRA tickets are a hazard surface for any coding agent because they are written by humans who already share context with the reader. 5.5 asks fewer clarifying questions and makes better default assumptions when the ticket is underspecified. When my boilerplate CLI sees a ticket like "add the new endpoint for the marketing team", the model now correctly infers the file layout, the route convention, and the test pattern from the rest of the repo without me having to spell it out in the system prompt.

For a side-by-side terminal recording of the same multi-file refactor task running on gpt-5-codex and gpt-5.5-codex, the DevDigest YouTube hands-on video is worth ten minutes of your time. Watching the two agents run on a split screen tells you more than any benchmark table.

Where It Still Fumbles#

I want to be honest about the failure modes because the rollout-everything-on-Monday energy on Twitter does not match my experience.

Config drift is the first real bug class. When a repo has both a pnpm-workspace.yaml and a stale lerna.json, 5.5 will sometimes follow the lerna config and produce commands that no longer apply. The fix is the same as it was on the previous model: tell the agent which config file is canonical in the developer message, and verify before letting it run scripts.

Confidently wrong refactors are the second. The model is now better at multi-file edits, which paradoxically makes it more dangerous when it is wrong. A confident sweep across 12 files with a subtly incorrect type signature is harder to catch in review than a hesitant attempt at three files. The countermeasure is unchanged: run the test suite before accepting, and make your CI block on failures.

Cost cliffs on long contexts are the third. Pricing on 5.5-codex scales with input tokens as expected, but the model is more willing to read entire files end to end when it could have grepped. If you give it filesystem tools without rate limits, you will see your bill jump on agents that previously were cautious. I added a hard cap on file reads per task in my agent loop and the daily spend dropped back into expected territory.

Verdict and Prompt Patterns I Am Keeping#

Verdict: migrate. The latency win alone justifies the move for any user-facing agent. The cost delta is real if your traffic skews toward refactor-style work. The risk of confidently-wrong sweeps is manageable with discipline you should already have.

Four prompt scaffolds survived migration intact and I will keep using them across whatever ships next.

The first is the role-with-codebase-anchor pattern. State the role, name the codebase, and pin one or two architectural facts the model needs to behave correctly. This worked on gpt-5-codex and works equally well on 5.5.

The second is the cite-file-and-line discipline. Always require the model to cite the exact file path and line number when making claims about code. This kills hallucinated references on any model and is even cheaper to enforce on 5.5 because the model resists drifting from the requirement.

The third is the plan-then-execute split. Have the model emit a plan first, log it, then execute against the plan. The plan is invaluable for postmortems when an agent goes wrong, and 5.5 produces visibly better plans than its predecessor.

The fourth is the structured-output-or-fail rule. If a downstream consumer expects JSON, declare the schema and reject anything that does not match. The 5.5 model is forgiving enough that this rarely triggers, but the contract has saved me twice this month already.

If you are mid-migration, the playbook is straightforward. Tag your prompt set, swap the model string, drop reasoning effort one level, run your eval suite, watch your cost dashboard for 48 hours, and only then roll out broadly. The unified stack is real, the gains are real, and the only thing left is the discipline of measuring it on your own traffic instead of trusting any benchmark, including the table I wrote above.

Frequently Asked Questions#

What is the main difference between gpt-5-codex and gpt-5.5-codex?#

GPT-5.5-Codex merges OpenAI's two parallel post-training stacks - the code-focused Codex line and the reasoning-focused GPT-5 line. The result is a single model that handles long-horizon multi-file editing (from Codex) and strong instruction following (from GPT-5) without the prompt gymnastics you needed before to get both behaviors from the older model.

How much faster is gpt-5.5-codex compared to gpt-5-codex?#

In production benchmarks, p95 latency dropped 20-25% across different agent types. A refactor bot went from 18.4s to 14.1s, PR triage from 6.2s to 5.0s, and a boilerplate CLI from 9.8s to 7.6s. The exact improvement depends on your workload, but latency gains are consistent across most coding agent patterns.

Should I keep my reasoning.effort setting at "high" after migrating?#

No - drop to "medium" first and benchmark. GPT-5.5-Codex is more efficient at the same effort level than its predecessor. Several agents produce better outputs at lower effort, not higher. Start at medium, measure, and only increase if you see quality regressions on specific tasks.

What prompt changes are required for the migration?#

Remove explicit "think step by step" scaffolding - it is redundant in 5.5 and often produces verbose preambles. Tighten output-format instructions since the new model follows JSON schemas with less drift. Replace deprecated parameters like max_completion_tokens with max_output_tokens in the Responses API. The model string swap itself is three lines of code.

How does gpt-5.5-codex handle multi-file refactors differently?#

The previous model would identify changes needed across multiple files but execute inconsistently - renaming a function correctly in three places while using the old name elsewhere. GPT-5.5-Codex holds the rename across the entire edit batch with much higher reliability. Cross-file renames now land on the first try in roughly 80% of attempts, up from about 50%.

What are the main failure modes to watch for?#

Config drift when repos have conflicting config files (e.g., both pnpm-workspace.yaml and stale lerna.json) - tell the agent which config is canonical. Confidently wrong refactors across many files that are harder to catch in review - always run the test suite before accepting. Cost spikes on long contexts if the model reads entire files instead of grepping - add hard caps on file reads per task.

Is gpt-5.5-codex more expensive than gpt-5-codex?#

Token costs per request are similar, but total spend often drops because the model uses fewer tokens to achieve the same result. In production, token consumption dropped 10-20% across different agents while quality improved. Watch for cost cliffs on long contexts - the model is more willing to read entire files, which can spike bills if you do not set rate limits on filesystem tools.

How do I roll back if the migration causes problems?#

Version your prompts before migrating - tools like Promptlock let you tag the pre-migration prompt set so rollback is one command. Keep the old model string in a feature flag for 48 hours after rollout. Watch your cost dashboard and eval metrics during that window. If something breaks, the rollback path should be a config change, not a git archaeology session.