한 줄 정의

codex -m gpt-5.4-mini는 Codex CLI에서 GPT-5.4 Mini 모델을 골라 새 코딩 세션을 시작하는 명령이야. 여기서 -m은 모델을 고르는 짧은 옵션이고, 설치나 인증을 새로 하는 명령은 아니야.

검색 로그나 자동 수집 결과에서 codex m gpt 5.4 mini처럼 공백으로 풀려 나와도 같은 뜻으로 보면 돼. 이 표기를 보면 먼저 두 가지를 갈라야 해. 하나는 “어떤 모델로 생각하게 할 것인가”이고, 다른 하나는 “그 모델이 내 저장소에서 어디까지 읽고 고칠 수 있나”야. gpt-5.4-mini를 고르는 일과 Auto, Read-only, Full Access 같은 권한 선택은 서로 다른 판단이야. 그래서 이 페이지는 모델 카드가 아니라 CLI 옵션을 읽는 항목이야.

실제로 무엇을 하나

이 명령은 OpenAI의 Codex 안에서 빠른 mini 모델을 쓰겠다는 선택이야. 공식 Codex 모델 문서는 gpt-5.4-mini를 반응이 중요한 코딩 작업과 하위 에이전트에 맞는 빠르고 효율적인 mini 모델로 설명해. 그래서 긴 설계보다 작게 쪼갠 확인 작업에 먼저 어울려.

예를 들어 테스트 실패 로그 하나를 읽고 원인 후보를 좁히거나, 한 파일 안의 타입 오류를 고치거나, 큰 작업에서 보조 에이전트에게 “관련 문서만 찾아와” 같은 일을 맡길 때 이 표기를 볼 수 있어. 반대로 저장소 구조를 새로 잡고, 여러 파일을 고치고, 테스트와 문서까지 한 번에 묶는 작업이면 GPT-5.5나 GPT-5.4를 먼저 비교하는 편이 맞아.

실행 중 모델을 바꾸는 길도 있어. Codex CLI 기능 문서는 열린 세션 안에서 /model로 모델을 바꿀 수 있다고 설명해. 반복 자동화에서는 codex exec에도 --model 또는 -m 흐름을 붙일 수 있어. 다만 그때도 수정 권한과 샌드박스는 별도 설정이야.

선택 대상 모델의 공개 API 카드도 같이 봐야 해. GPT-5.4 mini는 400,000토큰 컨텍스트 창과 128,000토큰 최대 출력을 가진다고 표시돼. 텍스트와 이미지를 입력으로 받고 텍스트를 출력하며, 텍스트 토큰 가격은 1M 토큰당 입력 $0.75, 캐시 입력 $0.075, 출력 $4.50이야.

왜 중요한가

이 표기가 중요한 이유는 하위 작업을 많이 나누는 agentic-coding 흐름에서 비용과 속도 감각을 바꾸기 때문이야. 하위 에이전트는 각자 모델과 도구 작업을 하므로, 모든 보조 작업을 가장 큰 모델로 돌리면 작은 확인에도 토큰이 많이 들어갈 수 있어.

그래서 이 옵션은 “큰 모델을 쓰지 말자”가 아니라 “실패 비용이 낮고 검증이 빠른 작업부터 가볍게 돌리자”에 가까워. 출력이 틀려도 테스트, diff, 리뷰로 바로 걸러낼 수 있는 작업이면 mini 후보가 생겨. 반대로 틀린 판단이 설계 전체를 틀게 만들거나 보안 권한을 넓히는 작업이면 작다는 이유만으로 맡기면 안 돼.

주의해서 볼 점

첫째, 이 명령 한 줄만으로 비용이 확정되지는 않아. API 모델 카드의 표준 숫자는 입력 $0.75, 캐시 입력 $0.075, 출력 $4.50 / 1M 토큰이지만, 실제 청구는 ChatGPT 플랜, 크레딧, API 인증 경로, 배치 처리, 지역 처리 조건에 따라 달라질 수 있어.

둘째, 작은 모델을 고른다고 보안 위험이 자동으로 작아지지는 않아. Codex CLI는 선택한 디렉터리의 코드를 읽고, 파일을 바꾸고, 명령을 실행할 수 있는 작업 표면이야. gpt-5.4-mini를 쓰더라도 비밀키가 섞인 저장소, 작업 디렉터리 밖 접근, Full Access가 필요한 자동화는 먼저 Read-only로 좁혀 보는 편이 나아.

셋째, 이 표기는 벤치마크 결론이 아니야. “mini가 빠르다”는 설명은 사용처를 정하는 신호일 뿐, 특정 팀의 저장소에서 상위 모델보다 낫다는 증거는 아니야. 실제 비교는 같은 이슈 20개, 같은 테스트 명령, 같은 리뷰 기준으로 되돌린 diff 비율을 재야 해.

같이 보면 좋은 항목

  • GPT-5.4 Mini: 이 명령이 실제로 고르는 모델 자체를 설명하는 직접 항목이야. command 표기보다 모델 용도와 한계를 먼저 볼 때 필요해.
  • Codex CLI: -m, /model, codex exec가 붙는 실행 표면이야. 모델보다 권한, 인증, 샌드박스가 먼저 문제일 때 같이 봐야 해.
  • Codex: CLI, IDE extension, cloud task까지 포함하는 더 넓은 제품군이야. codex -m ... 표기가 Codex 전체를 뜻하지 않는다는 점을 잡아 줘.
  • GPT-5.5: Codex 문서가 대부분의 작업에 먼저 권장하는 상위 모델이야. 긴 계획, 리서치, 복잡한 도구 사용이 섞이면 여기와 비교해야 해.
  • GPT-5.4: GPT-5.5가 계정에 없을 때의 기준 모델이야. mini로는 판단이 흔들리는 중간 규모 코딩 작업에서 비교점이 돼.