Codex CLI 단축 명령어 정리: 자주 쓰는 명령과 옵션
Codex CLI 명령을 어디에 입력하는지부터 대화에 이름을 붙이고 다시 여는 순서, codex exec 자동 실행, 주요 옵션과 tmux 사용법, Claude Code와의 명령어 차이를 정리했습니다.
세 줄로 먼저 읽기
- 슬래시 명령은 Codex를 실행한 뒤 대화 입력칸에, codex로 시작하는 명령은 일반 터미널에 입력합니다.
- /rename으로 대화에 이름을 붙이고 /exit로 끝낸 뒤 일반 터미널에서 codex resume을 실행하면 그 대화를 목록에서 골라 다시 엽니다.
- codex exec는 대화형 화면 없이 작업을 한 번 실행하는 명령이며 실행할 때마다 AI 사용량이 들고 --sandbox read-only로 파일 쓰기를 막을 수 있습니다.
Codex CLI 단축 명령어는 어디에 입력하나요?
Codex CLI는 터미널에서 저장소의 코드를 읽고 수정하며 로컬 명령어를 실행하는 OpenAI의 코딩 에이전트입니다. 셸은 터미널에 입력한 명령을 처리하는 프로그램입니다. 명령을 넣는 곳은 두 군데이고, Codex를 실행한 뒤의 대화 입력칸과 Codex 밖의 일반 터미널을 구분하면 어디에 입력할지 바로 정해집니다. 이 글은 설치와 로그인을 마친 상태를 기준으로 하며, 기능 설명은 2026년 10월 4일 공식 문서 기준입니다.
명령마다 입력하는 곳
| 명령 |  Codex 대화 입력칸codex 실행 뒤 |  일반 터미널Codex 밖의 셸 |
|---|---|---|
| /init, /status, /permissions | 제공 | 제공하지 않음 |
| /model, /review | 제공 | 제공하지 않음 |
| /rename, /exit | 제공 | 제공하지 않음 |
| codex resume | 제공하지 않음 | 제공 |
| codex exec | 제공하지 않음 | 제공 |
| codex mcp, codex completion | 제공하지 않음 | 제공 |
위 화면은 codex exec를 설명하는 비대화형 실행 문서입니다. 검색으로 /review를 찾았다면 Codex를 실행한 뒤 입력하고, codex exec를 찾았다면 일반 셸에서 입력합니다.
대화에 이름을 붙이고 다시 여는 순서
터미널을 닫았다가 어제 하던 작업을 이어 가려면 대화에 이름을 붙여 두는 것이 편합니다. 예를 들어 로그인 오류를 고치던 대화라면 아래 순서로 저장하고 다시 엽니다.
대화 이름 붙이기부터 다시 열기까지
1. 프로젝트 폴더에서 실행macOS는 pwd, PowerShell은
Get-Location으로 폴더 확인 뒤 codex
2. /status대화 입력칸에서
현재 폴더와 모델 확인
3. /rename 이름대화 입력칸에서
/rename login-bug-fix처럼 입력
4. /exit대화를 끝내고
일반 터미널로 돌아옴
5. codex resume일반 터미널에서 입력
목록에서 이름을 고르면 이어짐
5번에서 고른 대화에 이전 요청과 답변이 보이고 작업 폴더가 같으면 제대로 열린 것입니다. Codex 공식 문서는 현재 저장소의 최근 대화를 다시 열거나 로컬 대화 목록에서 이전 작업을 찾을 때 codex resume을 쓰라고 안내합니다. 대화를 이어서 열어도 파일은 지금 상태 그대로이고, 대화 당시 상태로 돌아가지 않습니다.
목록에 대화가 보이지 않으면 다른 폴더에서 실행했을 가능성이 큽니다. 모든 폴더의 로컬 대화를 보려면 일반 터미널에서 codex resume --all을 입력합니다. 비슷한 이름이 여러 개라면 시간과 대화 내용을 함께 봅니다. 잘못 고른 대화에는 새 요청을 보내지 말고 /exit로 나와 다시 고릅니다. 폴더 만들기부터 필요하다면 맥 설치 안내나 윈도우 설치 안내를 먼저 봅니다.
Codex CLI 기본 명령어 정리
프로젝트 폴더에서 가장 기본이 되는 명령은 codex입니다. 일반 터미널에서 쓰는 명령은 이렇습니다.
| 명령어 | 기능 | 예시 |
|---|---|---|
codex | 대화형 Codex 세션 시작 | codex |
codex resume | 저장된 대화 다시 열기 | codex resume |
codex exec | 대화형 화면 없이 작업 실행 | 사용법만 보기: codex exec --help |
codex --image 파일 | 이미지나 화면을 프롬프트에 추가 | codex --image error.png |
codex --search | 실시간 웹 검색을 쓰는 세션 시작 | codex --search |
codex mcp | MCP 서버 연결 관리 | codex mcp list |
codex completion | 셸 자동 완성 코드 생성 | codex completion zsh |
codex --help | 도움말 보기 | codex --help |
OpenAI 공식 문서는 Codex CLI를 로컬 저장소를 탐색하고, 파일을 수정하고, 로컬 도구를 실행하는 터미널 작업 흐름으로 설명합니다. codex exec는 같은 문서에서 반복 가능한 작업과 파이프라인에 쓰는 명령으로 소개합니다. 표의 예시는 필요할 때 하나씩 쓰는 명령이고, 파일 이름이 붙은 명령은 그 파일이 현재 폴더에 있어야 실행됩니다.
Codex 세션 안에서 쓰는 슬래시 명령어
Codex 세션 안에서 /를 입력하면 명령어 목록이 열립니다. 상태 확인과 대화 재개에 쓰는 명령부터 익히고, 프로젝트 지침 생성과 권한 변경은 필요할 때 씁니다.
| 슬래시 명령어 | 기능 | 사용하는 순간 |
|---|---|---|
/init | AGENTS.md 등 규칙 파일 생성 안내 | 프로젝트에 새 지침이 필요할 때 |
/status | 현재 세션 설정 확인 | 모델, 폴더, 권한 상태를 볼 때 |
/permissions | 파일 수정과 명령 실행 권한 선택 | 작업 범위를 정할 때 |
/model | 모델과 추론 노력 수준 변경 | 작업 특성에 맞게 조정할 때 |
/review | 변경 사항 리뷰 시작 | 커밋이나 PR 전에 검토할 때 |
/rename 이름 | 현재 대화에 이름 붙이기 | 나중에 다시 열 대화일 때 |
/exit | 현재 대화 종료 | 터미널로 돌아갈 때 |
? | 현재 단축키 도움말 보기 | 빈 입력칸에서 키보드 조작을 볼 때 |
/init은 Codex가 프로젝트에서 지킬 작업 규칙을 AGENTS.md 같은 파일로 만드는 초기화 명령입니다. 코드 스타일, 테스트 명령, 폴더 구조처럼 매번 설명하던 내용을 이 파일에 남겨 둡니다. 이미 AGENTS.md가 있다면 먼저 읽고 백업한 뒤 제안된 변경을 검토합니다.
/permissions는 파일 수정이나 명령 실행을 맡기기 전에 열어 볼 명령입니다. Codex 공식 문서도 모델, 추론 노력, 권한과 실행 명령을 작업에 맞게 고를 수 있다고 설명합니다. 그래서 작업을 시작하기 전에 /status로 현재 권한과 작업 폴더를 보고, 필요하면 /permissions로 범위를 좁힙니다.
Codex CLI 자동 실행 명령어
codex exec는 대화형 화면 없이 AI 작업을 한 번 실행하는 명령입니다. 명령을 미리 보여 주는 기능이 아니어서, 실행하면 AI 사용량이 들고 허용된 도구를 실제로 씁니다. 자동 검사를 묶어 돌리는 CI 같은 개발 환경에서 주로 씁니다.
codex와 codex exec의 차이
| 항목 |  codex대화형 세션 |  codex exec비대화형 실행 |
|---|---|---|
| 중간에 요청을 이어서 주고받음 | 제공 | 제공하지 않음 |
| 한 번 실행하고 결과만 받음 | 제공하지 않음 | 제공 |
| 스크립트와 CI에 연결 | 제공하지 않음 | 제공 |
| 기본적으로 Git 저장소 안에서 실행 | – | 제공 |
| 실행할 때마다 AI 사용량 | 제공 | 제공 |
예를 들어 저장소의 README.md를 읽고 설치 방법을 요약하게 하려면 일반 터미널에서 이렇게 입력합니다.
codex exec --sandbox read-only "README.md만 읽고 설치 방법을 세 줄로 알려 줘. 파일은 수정하지 마."--sandbox read-only는 로컬 파일 쓰기를 막는 권한 옵션입니다. 이 옵션은 쓰기만 막으므로 다른 파일은 읽을 수 있습니다. 이 설정에서 결과를 report.md에 저장하라고 요청해도 파일은 만들어지지 않습니다. 기본 exec도 읽기 전용이지만, 사용자 설정과 추가로 연결한 도구의 권한은 따로 봅니다. 출력이 나오면 원본 파일과 대조합니다.
요청이 길면 prompt.txt 같은 파일에 UTF-8로 저장해 두고 내용을 넘깁니다. UTF-8은 한글을 포함한 글자를 파일에 저장하는 인코딩 방식입니다. macOS의 zsh나 bash에서는 이렇게 입력합니다.
cat prompt.txt | codex exec --sandbox read-only -PowerShell 7에서는 다음처럼 UTF-8 파일을 읽어 넘깁니다. Windows PowerShell 5.1은 외부 프로그램에 보낼 때 한글 인코딩이 달라질 수 있으므로, 5.1에서는 앞의 예처럼 짧은 요청을 직접 넣는 방법을 씁니다.
Get-Content -Raw -Encoding UTF8 .\prompt.txt | codex exec --sandbox read-only -끝의 -는 앞에서 넘긴 내용을 요청으로 읽으라는 표시입니다. 반복 실행할 때마다 AI 사용량이 들기 때문에, 자동화에 연결하기 전에 한 번 실행한 결과와 실패 메시지부터 봅니다.
Codex CLI 주요 옵션
자주 쓰는 옵션 네 가지가 하는 일과 실행 전에 볼 것을 나란히 놓으면 이렇습니다.
주요 옵션이 하는 일과 실행 전에 볼 것
| 명령 |  하는 일 | 실행 전에 볼 것 |
|---|---|---|
| codex --image error.png | 이미지를 요청에 함께 넣음 | 현재 폴더에 파일이 있는지 |
| codex --search | 실시간 웹 검색 기본은 캐시 검색 | 필요한 문서 범위를 요청에 적었는지 |
| codex mcp list | 연결된 MCP 서버 목록 보기 | 필요한 서버만 켜 두었는지 |
| codex completion zsh | zsh용 자동 완성 코드 출력 | 출력을 넣을 셸 설정 파일 위치 |
--image
에러 화면, 디자인 시안, 구조도처럼 이미지에 정보가 있을 때 --image를 씁니다.
codex --image error.pngerror.png는 현재 환경에서 Codex가 읽을 수 있는 위치에 있어야 합니다. 이미지를 넣은 뒤 화면의 오류와 관련 파일을 함께 설명하면, Codex가 그림과 저장소 내용을 이어서 작업합니다. 오류가 보이지 않는 다른 그림을 넣으면 필요한 답을 얻기 어렵습니다.
--search
현재 라이브러리 버전, 공식 문서, 외부 서비스 동작처럼 최신 정보가 필요한 작업에는 --search를 붙여 실시간 웹 검색을 씁니다. 이 옵션이 없으면 저장된 검색 자료를 쓰는 캐시 방식으로 검색합니다.
codex --search검색이 필요한 이유와 볼 공식 문서 범위를 요청에 함께 적어 둡니다. 웹에서 찾은 문서가 저장소에 설치된 버전과 다를 수 있으니, 실제 설치 버전과 테스트 결과로 맞춰 봅니다.
mcp
MCP는 외부 도구와 데이터를 Codex에 연결하는 표준입니다. codex mcp는 MCP 서버 연결을 설정하고, 지금 쓸 수 있는 도구를 보는 명령입니다.
codex mcp listMCP 서버를 연결하면 Codex가 외부 서비스의 데이터를 읽거나 그 서비스에서 작업을 실행할 수 있습니다. 연결할수록 Codex가 접근하는 범위가 넓어지므로 실제로 필요한 서버만 켜고 로그인 상태를 봅니다.
completion
셸 자동 완성은 긴 명령어와 옵션을 입력할 때 Tab 키로 나머지를 채워 줍니다.
codex completion zsh위 명령은 zsh용 자동 완성 코드를 화면에 출력합니다. zsh와 bash는 설정 파일 위치가 다르므로, 출력된 코드를 지금 쓰는 셸의 설정 파일에 맞게 넣습니다.
Codex CLI를 tmux에서 실행하기
tmux는 터미널 작업 화면을 유지하는 별도 프로그램입니다. macOS나 Linux에 설치해 쓰는 선택 도구이고, 일반 Windows PowerShell에는 없습니다. 컴퓨터를 끄거나 재부팅하면 tmux 화면도 사라집니다.
codex resume과 tmux attach는 둘 다 "다시 여는" 명령이지만 여는 대상이 다릅니다.
codex resume과 tmux attach의 차이
| 항목 | codex resume |  tmux attach |
|---|---|---|
| 다시 여는 것 | 저장된 Codex 대화와 작업 맥락 | 실행 중인 터미널 화면 |
| Codex를 /exit로 끝낸 뒤 | 제공 | 제공하지 않음 |
| Codex가 tmux 안에서 실행 중일 때 | – | 제공 |
| 파일을 대화 당시 상태로 되돌림 | 제공하지 않음 | 제공하지 않음 |
아래 명령은 한 줄씩 실행합니다. 첫 줄로 새 tmux 화면이 열리면 그 안에서 codex를 입력합니다.
# 프로젝트 폴더로 이동한 상태에서 새 세션을 만듭니다.
tmux new -s codex-work
# 열린 tmux 화면에서 실행합니다.
codex터미널을 잠시 닫아야 한다면 Ctrl+B를 누른 뒤 두 키에서 손을 떼고 d를 누릅니다. Ctrl+B는 tmux 명령을 시작하는 접두 키입니다. 나중에 다음 명령으로 Codex가 실행 중인 화면에 돌아옵니다.
tmux attach -t codex-workCodex와 Claude Code를 같은 프로젝트에서 번갈아 쓴다면 세션이나 창 이름을 나눠 두면 구분하기 쉽습니다.
tmux 세션: ai-work
윈도 0: claude
윈도 1: codex
윈도 2: tests같은 파일을 Claude Code와 Codex가 동시에 수정하면 변경 내용이 섞입니다. 한 도구의 수정이 끝나고 파일을 확인한 뒤 다음 도구에 리뷰를 맡기면 어느 상태를 검토했는지 분명해집니다.
Codex CLI와 Claude Code 명령어 비교
두 도구 모두 터미널에서 실행하고 세션 안에서 슬래시 명령을 쓰지만, 재개와 비대화형 실행 명령은 이름이 다릅니다.
같은 작업, 두 도구의 명령
| 작업 |  Codex CLI |  Claude Code |
|---|---|---|
| 세션 시작 | codex | claude |
| 프로젝트 초기화 | /init | /init |
| 상태 확인 | /status | /status |
| 권한 설정 | /permissions | /permissions 또는 /config |
| 모델 변경 | /model | /model |
| 코드 리뷰 | /review | /review |
| 이전 세션 재개 | codex resume | claude -c, claude -r /resume |
| 비대화형 실행 | codex exec | claude -p |
비대화형 실행과 권한 설정은 특히 도구마다 동작이 달라서 각 도구의 공식 문서를 따릅니다. Claude Code 쪽은 Claude Code 단축키와 슬래시 명령어 정리에 따로 정리했습니다.
자주 묻는 질문
Codex CLI에서 가장 먼저 외울 명령어는 무엇인가요?
codex, /status, /rename, /exit, codex resume 다섯 개입니다. 현재 상태를 보고, 대화에 이름을 붙여 끝낸 뒤 다시 여는 데 필요한 명령이라 이것부터 익히고 다른 명령을 더합니다.
codex exec와 codex는 무엇이 다른가요?
codex는 대화형 세션을 열어 작업 중간에 계속 요청을 주고받는 명령입니다. codex exec는 한 번의 작업을 실행하고 결과를 받는 방식이라 스크립트와 반복 작업에 맞습니다.
Codex CLI에서 이전 대화를 어떻게 찾나요?
일반 터미널에서 codex resume을 실행하면 저장된 대화를 골라 다시 엽니다. tmux 안에서 Codex를 실행해 둔 상태라면 tmux attach -t 세션이름으로 그 화면부터 엽니다.
Codex CLI는 Claude Code와 같은 명령어를 사용하나요?
/init, /status, /permissions, /model, /review처럼 이름이 같은 명령은 있지만 세부 동작과 설정은 도구마다 다릅니다. 두 도구를 함께 쓸 때는 각 도구의 공식 문서를 기준으로 삼습니다.
참고 자료
제대로 이해했는지 한 문제로 확인해 볼까요?
답을 고르면 바로 풀이가 나와요.
Codex를 종료한 뒤 이전 대화를 찾아 이어가려면 어디에 무엇을 입력하나요?
새 글과 AI 소식을 메일로 받아 보세요
AI가 바꾸는 일과 도구, 측정 실무 이야기를 매주 한 번 보내 드려요.
이 글이 도움이 되었나요?
코딩 에이전트가 무엇이고 도구마다 무엇이 다른지, 비개발자 눈높이로 고르는 기준까지
코스 전체 보기 →