Codex CLI 단축 명령어 정리: 자주 쓰는 명령과 옵션
Codex CLI에서 대화 이름을 붙이고 종료한 뒤 다시 여는 연습으로 시작합니다. 대화 안의 슬래시 명령과 터미널 명령, 자동 실행의 차이를 입력 위치와 결과 확인 기준으로 정리했습니다.
목차
세 줄로 먼저 읽기
이번 방문에서 한 편은 바로 볼 수 있습니다.
Codex CLI 단축 명령어는 어디에 입력하나요?
Codex CLI는 터미널에서 저장소의 코드를 읽고 수정하며 로컬 명령어를 실행하는 코딩 에이전트입니다. 셸은 터미널에 입력한 명령을 처리하는 프로그램입니다. Codex를 실행한 뒤의 대화 입력칸과 일반 터미널 입력칸을 구분하면 명령을 넣을 위치를 알 수 있습니다. 설치와 로그인을 마친 상태에서 진행하며, 기능 설명은 2026년 10월 4일 공식 문서 기준입니다.
Codex를 실행한 뒤 프롬프트에 입력하는 /init, /status, /permissions, /model, /review는 세션 안의 슬래시 명령어입니다. 반면 codex resume과 codex exec는 Codex가 실행되기 전 일반 터미널에서 CLI 명령어로 입력합니다.
위 화면은 codex exec를 설명하는 비대화형 실행 문서입니다. 검색 결과에서 /review를 찾았다면 Codex를 실행한 뒤 입력하고, codex exec를 찾았다면 일반 셸에서 입력해야 합니다.
먼저 대화에 이름을 붙이고 다시 열어 봅니다
중요한 자료가 없는 연습 폴더에서 터미널을 엽니다. macOS는 pwd, PowerShell은 Get-Location으로 현재 폴더를 확인한 뒤 codex를 입력합니다. 폴더 만들기부터 필요하다면 맥 설치 연습이나 윈도우 설치 연습을 참고합니다.
Codex 대화 입력칸에 /status를 넣어 현재 폴더와 모델을 봅니다. 이어서 다음 문장을 요청합니다.
연습용 독서 모임은 2026-10-12에 도서관 2층에서 열려.
날짜와 장소를 두 줄로 정리해 줘. 파일은 만들거나 수정하지 마.답변의 날짜와 장소가 입력과 같은지 확인합니다. 대화 입력칸에 /rename reading-practice를 넣어 이름을 붙인 다음 /exit를 입력해 종료합니다. 일반 터미널 입력칸으로 돌아왔다면 아래 명령을 실행합니다.
codex resume목록에서 reading-practice를 고릅니다. 이전 요청과 답변이 보이고 작업 폴더가 연습 폴더인지 확인합니다. 이어서 “날짜를 2026-10-19로 바꿔 두 줄로 다시 정리해 줘. 장소는 그대로 둬.”라고 입력하고 날짜만 바뀌었는지 봅니다. 이 요청은 파일 수정이 아닌 대화 연습이며 AI 사용량이 적용됩니다.
대화가 보이지 않으면 다른 폴더에서 실행했는지 먼저 확인합니다. 전체 로컬 대화를 찾으려면 일반 터미널에서 codex resume --all을 사용할 수 있습니다. 비슷한 이름이 여러 개라면 시간과 대화 내용을 함께 확인합니다. 잘못 고른 대화에는 새 요청을 보내지 말고 종료한 뒤 다시 선택합니다.
혼자 반복할 때는 장소를 도서관 3층으로 바꾸고 종료와 재개를 다시 해 봅니다. 날짜가 유지되고 이전 변경 내용을 이어서 볼 수 있으면 됩니다.
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가 있다면 먼저 읽고 백업한 뒤 제안된 변경을 확인합니다. 코드 스타일, 테스트 명령, 디렉터리 구조처럼 매번 설명할 내용을 프로젝트 지침 파일에 남길 수 있습니다.
/permissions는 작업 전에 확인할 가치가 큽니다. Codex 공식 문서도 모델, 추론 노력, 권한과 실행 명령을 작업에 맞게 선택할 수 있다고 설명합니다. 파일 수정이나 명령 실행을 맡길 때는 현재 권한과 작업 폴더를 먼저 확인하는 편이 안전합니다.
Codex 작업을 다시 시작하는 명령어
터미널을 닫았거나 다른 작업으로 이동한 뒤 이전 Codex 대화를 이어가려면 codex resume을 사용합니다.
# 최근 저장된 대화를 선택합니다.
codex resume대화형 화면이 열리면 최근 작업을 골라 다시 시작합니다. Codex 공식 문서는 현재 저장소의 최근 대화를 다시 열거나 로컬 대화 목록에서 이전 작업을 찾는 용도로 codex resume을 안내합니다.
세션 재개와 tmux 세션 재연결은 서로 다른 기능입니다. codex resume은 Codex의 대화와 작업 맥락을 다시 여는 명령이고, tmux attach -t 이름은 터미널 화면을 다시 여는 명령입니다. Codex 프로세스가 tmux 안에서 계속 실행 중이라면 tmux로 재연결할 수 있습니다. 종료한 대화를 이어가려면 저장된 대화를 재개합니다. 재개한 대화에 과거 내용이 보여도 현재 파일이 그때 상태로 복구되는 것은 아닙니다.
Codex CLI 자동 실행 명령어
codex exec는 대화형 화면 없이 AI 작업을 실행합니다. 명령을 미리 보는 기능이 아니며, 실행하면 사용량이 발생하고 허용된 도구를 사용할 수 있습니다. 자동 검사를 묶어 실행하는 CI 같은 개발 환경에서 주로 사용합니다.
처음에는 앞의 대화 연습만 마쳐도 됩니다. 자동 실행을 연습하려면 Git 저장소와 명령 실행 권한을 이해하고, 중요한 자료가 없는 연습용 Git 저장소를 준비합니다. 기본적으로 Git 저장소 안에서 실행해야 하므로 오류가 나면 먼저 현재 폴더를 확인합니다.
이미 준비된 연습용 Git 저장소에서, 편집기로 meeting.md에 “2026-10-12, 도서관 2층”을 저장한 경우의 예입니다.
codex exec --sandbox read-only "meeting.md만 읽고 날짜와 장소를 두 줄로 알려 줘. 파일은 수정하지 마."요청에서는 meeting.md를 대상으로 지정했고, 권한 옵션은 로컬 파일 쓰기를 제한합니다. read-only가 다른 파일을 전혀 읽지 못하게 한다는 뜻은 아닙니다. 출력의 날짜와 장소를 원본과 대조합니다. 기본 exec는 읽기 전용이지만 사용자 설정과 추가 연결의 권한도 확인해야 합니다. 결과를 report.md에 쓰라는 요청만 붙이면 읽기 전용 설정에서 그대로 저장될 것이라고 기대하지 않습니다.
긴 요청을 파일로 관리할 때는 신뢰할 수 있는 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은 외부 프로그램에 보낼 때 한글 인코딩이 달라질 수 있으므로 이 예시 대신 위의 짧은 요청을 직접 인자로 넣는 방법부터 사용합니다.
Get-Content -Raw -Encoding UTF8 .\prompt.txt | codex exec --sandbox read-only -끝의 -는 앞에서 전달한 내용을 요청으로 읽으라는 표시입니다. 반복 실행할 때마다 AI 사용량이 발생하므로 자동화를 연결하기 전에 한 번의 결과와 실패 메시지부터 확인합니다.
Codex CLI 주요 옵션
--image
에러 화면, 디자인 시안, 구조도처럼 이미지에 정보가 있을 때 --image를 사용합니다.
codex --image error.png현재 폴더에 error.png가 실제로 있는지 확인한 뒤 실행합니다. 오류가 보이지 않는 다른 그림을 넣으면 필요한 설명을 얻기 어렵습니다. 이미지를 추가한 뒤 화면에 보이는 오류와 관련 파일을 함께 설명하면, Codex가 시각 자료와 저장소 내용을 연결해 작업합니다. 이미지 경로는 현재 환경에서 Codex가 읽을 수 있는 파일이어야 합니다.
위 화면은 별도 점검 스크립트의 과거 출력 사례이며 Codex의 기본 기능이나 /review 결과 화면은 아닙니다. 85점은 그 스크립트의 자체 기준이고 실제 AI 인용을 보장하지 않습니다.
--search
현재 라이브러리 버전, 공식 문서, 외부 서비스 동작처럼 최신 정보가 필요한 작업에서는 --search를 붙여 실시간 웹 검색을 사용합니다. 이 옵션이 없을 때의 기본 검색은 저장된 검색 자료를 이용하는 캐시 방식입니다.
codex --search검색이 필요한 이유와 확인할 공식 문서 범위를 프롬프트에 함께 적는 편이 좋습니다. 검색 결과가 있다고 해서 저장소의 코드와 자동으로 일치하는 것은 아니므로, 실제 설치 버전과 테스트 결과를 따로 확인해야 합니다.
mcp
MCP는 외부 도구와 데이터를 Codex에 연결하는 표준입니다. codex mcp는 MCP 서버 연결을 설정하고 현재 세션에서 사용할 도구를 확인할 때 쓰는 명령입니다.
codex mcp listMCP 서버를 연결하면 Codex가 외부 서비스의 데이터를 읽거나 작업을 실행합니다. 연결 대상과 권한 범위가 넓어질 수 있으므로, 실제로 필요한 서버만 활성화하고 로그인 상태를 확인하는 편이 좋습니다.
completion
셸 자동 완성은 긴 명령어와 옵션을 입력할 때 도움을 줍니다.
codex completion zsh위 예는 zsh용 자동 완성 코드를 출력하며 자동으로 설정 파일에 설치하는 명령은 아닙니다. 셸은 터미널 명령을 처리하는 프로그램으로, PowerShell 사용자에게 zsh 설정을 적용하지 않습니다. zsh와 bash에서 설정 파일 위치가 다르므로 안내된 명령어를 현재 셸에 맞게 적용해야 합니다.
Codex CLI를 tmux에서 실행하기
tmux는 터미널 작업 화면을 유지하는 별도 프로그램입니다. 설치된 macOS나 Linux 환경에서 사용하는 선택 사항이며 일반 Windows PowerShell의 기본 기능은 아닙니다. 컴퓨터 종료나 재부팅 뒤 실행 중인 작업까지 유지해 주지는 않습니다. tmux는 화면을 관리하고 Codex는 작업 폴더의 파일을 다루므로, 두 도구의 명령어를 섞어 기억하지 않는 것이 핵심입니다.
아래 명령은 한 줄씩 실행합니다. 첫 줄로 새 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 화면이 살아 있다면 tmux attach -t 세션이름으로 먼저 화면을 확인합니다.
Codex CLI는 Claude Code와 같은 명령어를 사용하나요?
/init, /status, /permissions, /model, /review처럼 이름이 같은 명령은 있지만 세부 동작과 설정은 도구마다 다릅니다. 두 도구의 명령어를 섞어 입력하지 말고 각 공식 문서를 기준으로 확인해야 합니다.
참고 자료
제대로 이해했는지 한 문제로 확인해 볼까요?
답을 고르면 바로 풀이가 나와요.
Codex를 종료한 뒤 이전 대화를 찾아 이어가려면 어디에 무엇을 입력하나요?
이 글이 도움이 되었나요?
코딩 에이전트가 무엇이고 도구마다 무엇이 다른지, 비개발자 눈높이로 고르는 기준까지
코스 전체 보기 →
새 글과 AI 소식을 메일로 받아 보세요
AI가 바꾸는 일과 도구, 측정 실무 이야기를 매주 한 번 보내 드려요.