한 줄 정의

GPT-5.4 Mini (지피티 5.4 미니), 즉 gpt-5.4-mini는 OpenAI가 Codex에서 제공하는 빠른 경량 코딩 모델이야. 공식 Codex 모델 문서는 이 모델을 반응이 중요한 코딩 작업과 하위 에이전트에 맞는 mini 모델로 설명해.

이름만 보면 GPT-5.4의 작은 변형처럼 보이지만, 실무에서는 “긴 계획을 맡길 모델인가, 작은 보조 작업을 많이 돌릴 모델인가”로 나눠 보는 게 더 중요해. Codex CLI에서는 codex -m gpt-5.4-mini로 새 세션을 시작할 수 있어.

이 모델로 무엇을 할 수 있나

잘 맞는 장면은 작고 빠른 코딩 루프야. 결과를 빨리 확인할 수 있는 작업부터 후보가 돼.

  • 작은 테스트 실패 원인 찾기: 로그와 실패 메시지가 좁고, 수정 후보를 바로 확인할 수 있을 때.
  • 짧은 파일 수정: 한두 파일 안에서 이름 변경, 타입 정리, 작은 조건문 수정처럼 범위가 닫혀 있을 때.
  • 릴리스 노트 초안: 이미 정리된 diff나 커밋 목록을 바탕으로 사람이 다시 다듬을 초안을 만들 때.
  • 좁은 diff 검토: 큰 리뷰가 아니라 특정 함수, 테스트, 설정 변경만 빠르게 훑을 때.
  • 보조 에이전트 실행: 큰 작업에서 문서 확인, 테스트 실패 요약, 작은 리팩터링 후보 찾기처럼 독립된 일을 나눌 때.

대화형 CLI에서는 /model로 모델을 바꿀 수 있고, 새 세션은 codex -m gpt-5.4-mini처럼 시작해. 반복 자동화는 codex exec에서 --model 또는 -m으로 모델을 지정하는 흐름을 쓸 수 있어. 다만 codex exec 자체는 기본적으로 읽기 중심 샌드박스에서 시작하므로, 파일 수정까지 맡길지는 모델이 아니라 권한 설정으로 따로 정해야 해.

왜 중요한가

gpt-5.4-mini를 알아두면 Codex 모델 선택을 너무 크게 시작하지 않을 수 있어. 공식 문서는 대부분의 Codex 작업에 GPT-5.5를 먼저 권장하고, 아직 계정에 없으면 GPT-5.4를 계속 쓰라고 안내해. 그 아래에서 mini는 가벼운 코딩 작업이나 하위 에이전트처럼 빠른 반복이 필요한 자리로 내려오는 선택지야.

여기서 비용 판단도 같이 갈려. 하위 에이전트는 각자 모델과 도구 작업을 하기 때문에 단일 실행보다 토큰을 더 쓸 수 있어. 그래서 큰 문제 하나를 여러 보조 작업으로 나누는 팀이라면 모든 보조 작업에 상위 모델을 쓰기보다, 실패 비용이 낮은 작은 작업부터 gpt-5.4-mini를 시험해볼 만해.

주의해서 볼 점

mini라는 이름이 “무조건 싸고 충분하다”는 뜻은 아니야. 인용한 Codex 문서에는 gpt-5.4-mini의 1M 토큰당 가격, 컨텍스트 길이, 파라미터 수가 직접 나오지 않아. 가격표와 모델 선택기는 계정, ChatGPT 플랜, API 인증 경로에 따라 따로 확인해야 해.

또 하나는 권한이야. 작은 모델을 고른다고 파일 수정이나 셸 실행 위험이 자동으로 작아지지는 않아. Codex의 승인 모드는 Auto, Read-only, Full Access로 나뉘고, 자동화에서는 샌드박스 설정이 따로 붙어. 가벼운 작업이라도 비밀키가 있는 저장소나 작업 디렉터리 밖 접근이 필요한 환경이면 Read-only로 먼저 보는 편이 맞아.

같이 보면 좋은 모델

  • GPT-5.5: Codex 문서가 대부분의 작업에 먼저 권장하는 상위 모델이야. 복잡한 계획, 컴퓨터 사용, 리서치, 긴 코드 수정이 섞이면 여기부터 봐.
  • GPT-5.4: GPT-5.5가 계정에 없을 때의 기준 모델이야. mini보다 긴 흐름과 여러 도구 사용을 맡길 때 비교 대상이 돼.
  • GPT-5.3 Codex: 코딩 에이전트 전용 성격이 강한 이전 권장 모델이야. 기존 Codex 설정이나 과거 벤치마크를 읽을 때 같이 보면 이름 혼동이 줄어.
  • Codex CLI: gpt-5.4-mini가 실제로 선택되는 실행 표면이야. 모델 자체보다 설치, 인증, 승인 모드, codex exec 흐름이 더 먼저 문제일 때가 많아.