gpt-5-5 는 OpenAI의 최신 에이전트·코딩 특화 모델이다. OpenAI는 GPT-5.5를 이전 모델의 드롭인(drop-in) 교체가 아닌 새로운 모델 패밀리로 접근할 것을 공식 권장한다.
핵심 원칙: 처음부터 다시
“gpt-5.2나 gpt-5.4에 최적화된 기존 프롬프트를 그대로 이식하지 말고, 새로운 베이스라인에서 시작하라.” — OpenAI 공식 가이드
이전 모델에서 검증된 프롬프트라도 GPT-5.5에서는 최적이 아닐 수 있다. 가장 작은 프롬프트(제품 계약을 유지하는 최소 요소)에서 시작해, 추론 강도·상세함 수준·도구 설명·출력 포맷을 실제 예시에 맞춰 튜닝한다.
마이그레이션 팁 4가지
1. 도구 호출 전 짧은 진행 상황 알림 추가
멀티스텝 태스크에서 도구를 호출하기 전, 사용자에게 짧은 진행 안내 메시지를 먼저 전송하도록 시스템 프롬프트에 명시한다.
멀티스텝 태스크에서 도구 호출 전에 요청을 확인하고 첫 번째 단계를
알리는 1~2문장 짜리 안내를 먼저 보내라.이 패턴은 OpenAI Codex 앱에서도 사용되며, 모델이 멈춘 것처럼 보이는 문제를 해결한다.
2. Codex에서 자동 마이그레이션
기존 프로젝트를 codex 에서 열고 아래 명령으로 자동 마이그레이션을 실행한다.
$openai-docs migrate this project to gpt-5.5OpenAI가 제공하는 openai-docs 스킬이 GPT-5.5 업그레이드 가이드를 참조해 코드를 업데이트한다.
3. 추론 강도와 상세함 수준 재조정
reasoning.effort와 text.verbosity 파라미터를 새로 튜닝한다. 이전 모델에서 잘 동작했던 설정이 GPT-5.5에서는 오버킬이거나 부족할 수 있다.
4. 각 파라미터를 독립적으로 최적화
프롬프트, 추론 강도, 상세함 수준, 도구 설명, 출력 포맷을 한 번에 바꾸지 말고 하나씩 대표 예시에 맞춰 검증한다.
관련 공식 리소스
- 프롬프트 가이드:
https://developers.openai.com/api/docs/guides/prompt-guidance?model=gpt-5.5 - 최신 모델 사용 가이드:
https://developers.openai.com/api/docs/guides/latest-model - Codex 업그레이드 스크립트:
https://github.com/openai/skills/blob/main/skills/.curated/openai-docs/references/upgrade-guide.md
참고 자료
- GPT-5.5 prompting guide — Simon Willison’s Weblog (2026-04-25)