Codex CLI 프롬프트 기록 검색: Ctrl+R로 이전 입력을 처음 찾는 법
TL;DR
Codex에서 예전에 입력한 프롬프트를 다시 찾으려면 TUI 입력창에서
Ctrl+R
을 누릅니다. 공식 문서는 검색 결과를
Enter
로 사용하고
Esc
로 취소한다고 설명합니다. 첫 시험에서는 비민감 기록이 맞는지만 확인하고
Esc
로 닫은 뒤, 과거 지시의 재실행은 별도로 판단하세요.
핵심 3줄 요약
Ctrl+R
은 Codex TUI의 prompt history를 검색하는 interactive shortcut입니다.codex-cli 0.144.6
은
reverse-i-search
와
enter accept · esc cancel
안내를 표시했습니다.이 글에서 다룰 내용
-
Ctrl+R을 눌러야 하는 정확한 위치 - 검색용 비민감 기록을 준비하는 방법
- 일치 항목을 실행하지 않고 확인하는 5단계
- 기록이 없을 때 설정 문서에서 확인할 경계
Codex의
Ctrl+R
은 무엇인가
Ctrl+R
은 Codex 대화형 TUI에서 이전 프롬프트 기록을 검색하는 키보드 바로가기입니다. 같은 키라도 운영체제 셸이 아닌 Codex 입력창이 열린 상태에서 눌러야 합니다.
OpenAI 공식 Codex 명령 문서는 동작을 간단히 정리합니다.
Ctrl+R
로 prompt history를 검색합니다. 일치 항목은
Enter
로 사용하고 검색을 멈추려면
Esc
를 누릅니다.
위·아래 방향키로 draft history를 되살리는 기능은 별도입니다. 공식 문서도 Up/Down과
Ctrl+R
을 다른 interactive shortcut으로 구분합니다.
언제 쓰면 좋은가
전에 작성한 테스트 조건, 수정 범위, 출력 형식을 다시 확인할 때 유용합니다. 긴 지시를 기억에 의존해 새로 쓰기보다 당시 입력을 찾아 현재 작업과 맞는지 대조할 수 있습니다.
다만 prompt history는 승인된 작업 지침서가 아닙니다. 예전 프롬프트에는 사라진 파일명, 바뀐 브랜치, 더는 유효하지 않은 명령, 외부로 보여서는 안 되는 값이 포함될 수 있습니다. 검색과 재실행을 한 동작처럼 다루지 마세요.
Ctrl+R
로 이전 입력을 찾는 5단계
1. 비민감 테스트 기록을 준비합니다
이미 공개해도 되는 짧은 프롬프트가 기록에 있다면 그 문장을 사용합니다. 없다면 운영 저장소가 아닌 임시 폴더에서 아래 테스트 프롬프트를 한 번 제출하고 응답이 끝날 때까지 기다립니다.
목표: Ctrl+R 프롬프트 기록 검색을 확인할 비민감 테스트 문장을 남깁니다.
허용 입력: 이 프롬프트에 적힌 HISTORY CHECK 20260808 문구만 사용합니다.
제외 입력: 파일, Git 상태, 환경 변수, 네트워크, 고객 정보, 비밀값은 읽거나 언급하지 않습니다.
출력 형식: HISTORY CHECK 20260808 한 줄만 출력합니다.
완료 기준: 사람이 응답 완료를 확인합니다. 이후 Ctrl+R 검색에서 같은 문장을 찾습니다.
추정 금지: 이 프롬프트 밖의 시스템 상태나 프로젝트 정보를 추정하지 않습니다.
승인 지점: 검색 결과는 먼저 Esc로 취소합니다. Enter로 재사용하는 행동은 사람이 원문을 다시 확인한 뒤 별도로 결정합니다.
이 글의 로컬 검증은 테스트 문장을 과거 기록으로 분리하려고 Codex를 정상 종료한 뒤 같은 격리 환경에서 다시 열었습니다. 공식 문서는 재실행을 보편적인 필수 조건으로 명시하지 않습니다.
2. Codex 입력창에서
Ctrl+R
을 누릅니다
Codex TUI의 입력창이 활성화됐는지 먼저 확인합니다. 그 안에서
Ctrl+R
을 누릅니다. 현재 검증 환경에서는 화면 아래에
reverse-i-search:
가 나타났습니다.
셸 프롬프트에서 누르면 Codex 입력 기록을 확인한 것이 아닙니다. 이 글의 완료 기준은 Codex 화면 안에서 검색 UI가 열리는 것입니다.
3. 구별하기 쉬운 문구를 입력합니다
이어서 테스트 프롬프트의
HISTORY CHECK 20260808
을 입력합니다. 일반적인 단어보다 다른 기록과 겹치지 않는 비민감 문구가 확인하기 쉽습니다.
현재 설치본에서는 일치한 사용자 프롬프트와 함께
enter accept · esc cancel
안내가 나타났습니다. 이는
codex-cli 0.144.6
의 WSL 검증 결과이며 모든 운영체제, 터미널, 버전의 화면을 보장하지 않습니다.
4. 일치 항목의 원문을 검토합니다
마지막으로 화면에 나온 문장이 자신이 남긴 테스트 프롬프트인지 확인합니다. 고객명, 내부 경로, 실제 명령이 섞였다면 사용하지 않습니다.
검색어만 같고 문장이 다른 경우에도 바로
Enter
를 누르지 마세요. 공식 문서가 확인해 주는 것은 일치 항목을 사용할 수 있다는 점이지, 과거 지시가 지금도 맞다는 점이 아닙니다.
5. 첫 시험은
Esc
로 취소합니다
원하는 기록을 찾았으면
Esc
를 눌러 검색을 닫습니다. 파일 수정, 명령 실행, 외부 전송이 없고 테스트 문장을 다시 제출하지 않았다면 첫 실행이 끝난 것입니다.
실무에서 과거 프롬프트를 다시 쓰려면 내용을 현재 경로와 조건에 맞춰 검토한 뒤
Enter
사용 여부를 결정하세요. 첫 시험과 실제 재사용을 분리하면 오래된 지시를 실수로 실행할 가능성을 낮출 수 있습니다.
결과를 읽고 완료를 판단하는 법
통과 기준은 세 가지입니다. Codex TUI 안에서 검색 UI가 열리고 검색어와 맞는 비민감 프롬프트가 표시돼야 합니다.
Esc
로 취소한 뒤에는 새 작업이 시작되지 않아야 합니다.
no match
가 보이면 검색어와 일치한 기록을 찾지 못한 상태입니다. 곧바로 설정을 바꾸지 말고 실제로 남긴 비민감 문구인지, 같은 Codex 환경을 열었는지부터 확인합니다.
실전 활용 팁
업무 프롬프트에는 검색용 표식을 하나 두면 찾기 쉽습니다. 예를 들어 공개 가능한 테스트 이름이나 작업 번호처럼 현재 팀이 이미 쓰는 비민감 식별자를 문장에 넣습니다. 검색을 위해 새 고객명이나 내부 식별자를 만들 필요는 없습니다.
재사용 전에는 경로, 실행 범위, 외부 전송 여부를 다시 봅니다. 기록 검색은 입력을 찾는 기능입니다. 그 지시의 최신성이나 안전성을 승인하는 기능은 아닙니다.
주의할 점
-
Ctrl+R은 Codex TUI의 prompt history 검색입니다. 셸에서 같은 키를 누른 결과를 Codex 기능 확인으로 보지 않습니다. - 공식 문서는 운영체제, 터미널, 플랜, 지역, 언어, 최소 버전을 별도로 확정하지 않습니다. 현재 설치 표면에서 검색 UI를 먼저 확인합니다.
-
history.persistence는 세션 transcript를history.jsonl에 저장할지 제어하는 별도 설정입니다.history.max_bytes가 지정되면 오래된 항목이 제거될 수 있습니다. -
Ctrl+R이 저장되지 않았거나 제거된 기록을 복구한다고 단정하지 않습니다. 첫 실행에서 설정 변경까지 자동으로 이어가지 않습니다. - 과거 프롬프트에 인증정보, 개인정보, 운영 명령이 보이면 재사용하지 말고 조직의 기록·폐기 정책에 따라 처리합니다.
자주 묻는 질문
Ctrl+R
을 눌렀는데 아무 변화가 없으면 어떻게 하나요?
현재 화면이 Codex TUI 입력창인지 먼저 확인합니다. 그래도 검색 UI가 열리지 않으면 임의의 키 설정, 업데이트, 재설치를 제안하지 말고 현재 설치 버전과 공식 문서를 대조하세요. 제공 경계가 확인되지 않으면 첫 실행을 중단합니다.
검색 결과에서
Enter
를 누르면 어떻게 되나요?
공식 문서는
Enter
로 일치 항목을 사용한다고 설명하며 현재 설치본의 검색 UI도
enter accept
를 표시했습니다. 과거 지시의 재사용은 새 작업을 시작할 수 있습니다. 첫 시험에서는
Esc
로 취소하고 실제 사용은 원문을 검토한 뒤 결정하세요.
위·아래 방향키와
Ctrl+R
은 같은 기능인가요?
아닙니다. 공식 문서에서 Up/Down은 draft history 복원,
Ctrl+R
은 prompt history 검색으로 구분됩니다. 이전 입력을 키워드로 찾으려는 목적이라면
Ctrl+R
을 사용합니다.
기록이 오래되면 계속 검색할 수 있나요?
공식 설정 문서는
history.max_bytes
가 지정되면 오래된 항목을 떨어뜨릴 수 있다고 설명합니다. 또한
history.persistence
는 transcript 저장 여부를 제어합니다. 현재 기록의 보존 기간이나 복구 가능성을 이 문서만으로 단정할 수는 없습니다.
출처
- OpenAI Codex Developer Commands 공식 문서 —
Ctrl+R검색,Enter사용,Esc취소와 Up/Down draft history를 확인했습니다. - OpenAI Codex Config Reference 공식 문서 —
history.persistence,history.max_bytes,history.jsonl경계를 확인했습니다.
마무리
Codex에서 이전 프롬프트를 찾을 때는 입력창에서
Ctrl+R
→ 비민감 문구 검색 → 원문 확인 → 첫 시험은
Esc
순서로 시작하세요. 기록을 빨리 찾는 것과 다시 실행해도 되는지는 별개의 판단입니다. 검색은 Codex가 맡아도 재사용 승인은 사람이 맡아야 합니다.
