codex 명령어 정리 — 슬래시 명령과 CLI 옵션
Codex 명령어는 두 종류입니다. 터미널에서 치는 codex exec·codex resume·codex login 같은 CLI 하위 명령과, Codex 대화창에서 /로 부르는 /model·/permissions·/status·/compact 같은 슬래시 명령입니다. 매일 쓰는 건 열 개 남짓이고, 전체 목록은 codex --help와 대화창의 / 팝업에서 확인하면 됩니다. 아래는 codex-cli 0.157.1에서 직접 실행해 확인한 내용입니다.
1. codex 명령어는 어디서 치나 — 두 종류 구분
처음 헷갈리는 지점이 이겁니다. 같은 "명령어"라도 치는 곳이 다릅니다.
| 종류 | 치는 곳 | 예시 | 목록 보는 법 |
|---|---|---|---|
| CLI 하위 명령·옵션 | 셸(터미널 프롬프트) | codex exec "...", codex -m 모델 |
codex --help, codex exec --help |
| 슬래시 명령 | codex를 띄운 뒤 입력창 |
/model, /status |
입력창에 /만 치면 팝업 |
셸에서 /model을 치거나, 대화창에서 codex exec를 치면 당연히 안 됩니다. 아직 설치 전이라면 codex cli 윈도우 설치 글부터 보세요.
2. codex cli 명령어 모음 — 터미널 하위 명령
codex --help의 Commands 목록 중 자주 쓰는 것만 추렸습니다. 아무 하위 명령 없이 codex만 치면 대화형 화면(TUI)이 뜹니다.
| 명령 | 하는 일 |
|---|---|
codex | 대화형 화면 시작. 뒤에 문장을 붙이면 첫 프롬프트로 들어간다 |
codex exec (codex e) | 사람 개입 없이 한 번 실행하고 끝낸다. 스크립트·CI용 |
codex resume | 이전 대화 이어 하기. 기본은 목록에서 고르고, --last면 가장 최근 것 |
codex fork | 이전 대화를 복제해 새 대화로 갈라 시작 |
codex review | 코드 리뷰를 비대화형으로 실행 |
codex login / codex logout | 로그인·로그아웃. codex login status로 상태 확인 |
codex mcp | MCP 서버 추가·목록·삭제 |
codex plugin | 플러그인 설치·목록·제거 |
codex features | 기능 스위치 목록(list)·켜기(enable)·끄기(disable) |
codex update | 최신 버전으로 업데이트 |
codex doctor | 설치·설정·인증·런타임 상태 진단 |
codex completion | 셸 자동완성 스크립트 생성 |
codex archive / unarchive / delete | 저장된 대화 숨기기·되살리기·영구 삭제 |
# 가장 최근 대화 이어 하기 (지금 폴더에서 연 대화 중)
codex resume --last
# 폴더 상관없이 가장 최근 대화
codex resume --last --all
# 한 번 실행하고 끝내기 + 마지막 답변만 파일로 저장
codex exec "README의 설치 절차를 요약해 줘" -o summary.txt
# 대화를 숨기기만 (기록은 남음) / 되살리기
codex archive <SESSION>
codex unarchive <SESSION>codex resume --last가 엉뚱한 대화를 못 찾는다면 이유가 있습니다. 공식 문서에 따르면 --last는 현재 작업 폴더의 대화만 대상으로 하고, --all을 붙여야 전체에서 찾습니다. MCP 등록은 codex mcp 설정 글에 따로 정리했습니다.
3. 자주 쓰는 codex 옵션 — 모델·샌드박스·승인
옵션은 codex와 codex exec에 거의 똑같이 붙습니다. 0.157.1 도움말 기준입니다.
| 옵션 | 뜻 |
|---|---|
-m, --model | 이번 실행에 쓸 모델 |
-s, --sandbox | read-only · workspace-write · danger-full-access 중 하나 |
-a, --ask-for-approval | on-request(모델이 필요할 때 묻는다) · never(묻지 않고 실패를 그대로 돌려준다) |
-C, --cd | 작업 폴더 지정 |
--add-dir | 쓰기를 허용할 폴더 추가 |
-i, --image | 첫 프롬프트에 이미지 첨부 |
--search | 실시간 웹 검색 켜기 |
-c key=value | 설정값을 이번 실행에만 덮어쓰기 |
-p, --profile | 프로필 설정 파일을 얹어서 실행 |
--strict-config | 설정 파일에 모르는 키가 있으면 에러로 멈춤 |
승인 옵션 값이 두 개뿐이라는 점을 눈여겨보세요. 옛 글에 나오는 다른 값들은 0.157.1 도움말에 없습니다. 샌드박스 세 모드의 차이는 codex 샌드박스 설정, -c·-p가 덮어쓰는 설정 파일 구조는 codex 설정 파일 글에 있습니다.
--dangerously-bypass-approvals-and-sandbox는 승인과 샌드박스를 모두 끕니다. 도움말에도 "EXTREMELY DANGEROUS"라고 적혀 있고, 공식 문서는 따로 격리된 VM 안에서만 쓰라고 권합니다. 쓰기 폴더가 더 필요하면 --add-dir이 먼저입니다.
4. codex 슬래시 명령어 정리 — 대화창에서 쓰는 것
codex를 띄운 뒤 입력창에 /를 치면 팝업이 뜨고, 글자를 더 치면 걸러집니다. 공식 문서의 목록은 40개가 넘는데, 용도별로 자주 쓰는 것만 묶었습니다.
| 용도 | 명령 | 하는 일 |
|---|---|---|
| 모델·권한 | /model | 모델과 추론 강도 고르기 |
/permissions | 묻지 않고 해도 되는 범위 바꾸기(Auto, Read Only 등) | |
/plan | 계획 모드로 전환. 뒤에 문장을 붙이면 그게 첫 요청 | |
| 상태 확인 | /status | 현재 모델·승인 정책·쓰기 가능 폴더·토큰 사용량 |
/usage | 계정 사용량(일·주·누적) | |
/diff | Git 변경 내용. 아직 추적 안 하는 새 파일까지 보여 준다 | |
/mcp | 연결된 MCP 도구 목록. /mcp verbose면 서버 상세 | |
| 대화 관리 | /new | 새 대화 시작(화면은 그대로) |
/clear | 화면을 지우고 새 대화 시작 | |
/compact | 지금까지 대화를 요약해 컨텍스트 확보 | |
/resume · /fork | 저장된 대화 이어 하기 · 지금 대화를 복제 | |
/side | 본 대화를 건드리지 않는 잠깐용 곁가지 대화 | |
/copy | 마지막으로 끝난 답변 복사(Ctrl+O와 같음) | |
| 프로젝트 | /init | 지금 폴더에 AGENTS.md 뼈대 생성 |
/review | 작업 트리의 변경을 리뷰 | |
/mention | 특정 파일을 대화에 첨부 | |
/skills · /memories | 스킬 골라 쓰기 · 메모리 사용·생성 켜고 끄기 | |
| 종료 | /quit · /exit | CLI 종료(둘은 같은 명령) |
몇 개는 따로 글이 있습니다. /usage와 한도는 codex 사용량 확인, /init이 만드는 파일은 agents.md 작성법, /memories는 codex 메모리 활성화 글을 보세요.
/fast와 /personality는 목록에 없을 수도 있습니다. 공식 문서에 따르면 지금 모델이 그 기능을 지원할 때만 보이는 명령입니다. 윈도우에서 네이티브로 돌릴 때만 나오는 /setup-default-sandbox, /sandbox-add-read-dir도 있습니다.
5. codex 단축키 — 입력창에서 바로 쓰는 것
| 키 | 하는 일 |
|---|---|
@ | 작업 폴더에서 파일을 찾아 경로를 프롬프트에 넣기 |
!로 시작 | 그 줄을 로컬 셸 명령으로 실행(지금의 승인·샌드박스 설정 적용) |
| Tab (작업 중) | 다음 턴 대기열에 추가 |
| Enter (작업 중) | 진행 중인 턴에 지시 끼워 넣기 |
| Esc 두 번 (입력창이 빈 상태) | 이전 메시지를 고쳐서 거기서부터 갈라 가기 |
| Ctrl+R | 프롬프트 기록 검색 |
| Ctrl+L | 화면만 지우기(대화는 유지) |
| Ctrl+C | 세션 종료 |
6. codex exec 안될때 — 실제로 뜨는 에러 2가지
codex exec를 처음 스크립트에 붙이면 흔히 두 군데서 막힙니다. 둘 다 직접 재현해 본 출력입니다.
① Git 저장소가 아닌 폴더에서 실행했을 때
> codex exec "say hi"
Reading additional input from stdin...
Not inside a trusted directory and --skip-git-repo-check was not specified.종료 코드는 1입니다. Git 저장소 안에서 돌리거나, 정말 저장소 밖에서 써야 하면 --skip-git-repo-check를 붙입니다.
② 로그인이 안 된 상태일 때
> codex exec --skip-git-repo-check "say hi"
OpenAI Codex v0.157.1
--------
approval: never
sandbox: read-only
...
ERROR: Reconnecting... 5/5
ERROR: unexpected status 401 Unauthorized: Missing bearer or basic authentication in header곧바로 실패하지 않고 다섯 번 재연결을 시도한 뒤 401로 끝나서, 스크립트에서는 멈춘 것처럼 보일 수 있습니다. 설정 파일이 없는 기본 상태에서 exec의 헤더가 approval: never, sandbox: read-only로 찍힌 것도 눈여겨볼 만합니다. 파일을 고치게 하려면 -s workspace-write를 줘야 합니다.
스크립트 앞단에서 로그인 여부를 먼저 거르는 게 깔끔합니다. codex login status는 로그인이 안 됐으면 Not logged in을 찍고 종료 코드 1을 돌려주고, 공식 문서 기준으로 자격증명이 있으면 0입니다.
# bash
codex login status > /dev/null || { echo "codex 로그인이 필요합니다"; exit 1; }
codex exec -s workspace-write "테스트가 깨지는 원인을 찾아 고쳐 줘"7. 문서와 명령어가 다를 때 — 버전부터 확인
Codex는 업데이트가 잦아서, 글이나 문서에 있는 명령이 내 설치본에 없을 때가 많습니다. 실제로 이 글을 쓰려고 확인했을 때도 PC에 깔려 있던 0.153.4의 도움말에는 공식 문서가 "제거됨"이라고 적은 mcp-server가 아직 있었고, 0.157.1로 올린 뒤에야 문서와 맞았습니다.
codex --version # 지금 버전
codex update # 최신으로 올리기
codex features list # 이 버전이 아는 기능 스위치와 단계(stable·experimental 등)반대로 설치본에 문서보다 많은 게 들어 있기도 합니다. 0.157.1 실행 파일 안의 명령 설명문에는 문서 표에 없는 항목(대화를 마크다운으로 내보내기, 새 워크트리에서 대화 시작, 음성 켜기 등)이 보였습니다. 또 /import는 문서엔 "Claude Code 또는 Cursor에서 가져오기"로 적혀 있지만, 설치본 설명문에는 Claude Code만 적혀 있습니다. 결국 기준은 내 입력창의 / 팝업과 codex --help입니다.
자주 묻는 질문 (FAQ)
Q. /clear와 /new는 뭐가 다른가요?
둘 다 새 대화를 시작합니다. 차이는 화면입니다. /clear는 터미널 화면까지 지우고, /new는 화면을 그대로 둡니다. 화면만 지우고 대화는 이어 가고 싶으면 Ctrl+L입니다. 공식 문서 기준으로 /clear와 Ctrl+L은 작업이 진행 중일 때는 막힙니다.
Q. /compact는 언제 쓰나요?
긴 작업을 한참 한 뒤에 씁니다. 앞선 대화를 요약으로 바꿔 컨텍스트 공간을 비웁니다. 요약이라 세부가 빠질 수 있으니, 꼭 남겨야 할 규칙은 AGENTS.md에 적어 두는 편이 안전합니다.
Q. 슬래시 명령 전체 목록은 어디서 보나요?
입력창에 /만 치면 지금 버전과 지금 모델에서 쓸 수 있는 명령이 뜹니다. 영문 공식 문서(Developer commands)에도 표가 있지만, 앞에서 본 것처럼 설치본과 조금씩 어긋날 수 있습니다.
Q. 대화 중에 작업 폴더를 바꿀 수 있나요?
시작할 때 codex -C 폴더로 정하는 게 확실합니다. 쓰기 권한만 더 필요하다면 --add-dir로 폴더를 추가합니다.
마무리
정리하면, 셸에서는 codex·codex exec·codex resume --last·codex login status, 대화창에서는 /model·/permissions·/status·/diff·/compact·/new 정도만 손에 익혀도 대부분의 작업이 됩니다. 나머지는 필요할 때 / 팝업에서 찾으면 됩니다.
명령이 안 먹는다면 먼저 codex --version으로 버전을 보세요. Codex는 몇 주 사이에도 명령이 추가되고 빠집니다. 이 글은 codex-cli 0.157.1 기준입니다.
📚 참고 출처 (2026년 9월 26일 확인 · codex-cli 0.157.1)
· Developer commands — Codex Docs
· Codex CLI — Codex Docs
COMMENTS