Codex CLI 치트시트

Codex가 TUI에서 사용자에게 입력을 요청할 때 응답이 일정 시간 없으면 카운트다운이 돌아 프롬프트가 자동으로 해결된다.
자리를 비운 채 긴 작업을 돌릴 때 한 번의 확인 요청 때문에 전체 turn이 정지하던 흐름이 사라진다.
사용자가 해당 입력창에 키를 누르거나 편집하는 등 상호작용하면 카운트다운이 즉시 멈춰, 응답을 천천히 작성하는 도중에 자동 해결이 끼어들지 않는다.
(0.141.0~)

활용

• 자리를 비운 채로 긴 코드 작업 실행 — 도중에 짧은 확인 프롬프트가 떠도 카운트다운이 흘러 자동으로 진행되고 전체 흐름이 멈추지 않는다
• 직접 답하려는 의도를 카운트다운에 알릴 때 — TUI 입력창에 타이핑 또는 편집을 시작하면 카운트다운이 즉시 일시정지되고, 응답을 다 적을 때까지 자동 해결이 미뤄진다
• 카운트다운 표시로 자동 해결까지 남은 시간을 한눈에 확인해, turn이 자동으로 이어지기 전에 개입할 시간을 가늠

주의

자동 해결은 TUI의 사용자 입력 요청(request_user_input)에만 적용된다.
샌드박스·승인 정책의 on-request 단계처럼 명시적 확인 가드는 그대로 사람의 응답을 기다린다.

/import는 기존 Claude Code 설치에서 setup·project configuration·최근 채팅을 선별 임포트한다.
항목 단위로 골라 가져오기 때문에 전환·병행 사용 시 필요한 것만 옮기고 기존 Codex 설정은 보존할 수 있다.
(0.140.0~)

활용

• Claude Code에서 Codex로 옮길 때 초기 셋업 자동 이전:
  /import
• 최근 진행하던 채팅을 Codex 세션 목록에 추가해 codex resume으로 그대로 이어받기
• 프로젝트 단위 설정만 가져오기 — 글로벌 설정은 두고 워크스페이스 컨텍스트만 옮길 때

주의

codex resume --import <EXPORT_FILE> (0.128.0~)이 외부 에이전트 일반 임포트 경로라면, /import는 Claude Code에 특화된 선별 임포트 UX다.

/usage는 계정 토큰 사용량을 daily·weekly·cumulative 세 가지 뷰로 TUI 안에서 바로 보여준다.
별도 대시보드나 ChatGPT 콘솔을 띄우지 않고도 현재 세션이 한도에 얼마나 가까운지, 이번 주 누적이 어떻게 흘러왔는지 한 화면에서 확인할 수 있다.
(0.140.0~)

활용

• 현재 세션에서 토큰 활동 패널 열기:
  /usage
• 한도 임박 시 빠르게 일·주·누적 잔여를 비교해 다음 turn을 보낼지 판단
• 장시간 큰 컨텍스트로 작업할 때 주기적으로 호출해 burn rate 추적

이전까지 세션은 archive(codex archive)로만 정리할 수 있어 실제 데이터는 디스크에 남았다.
0.140.0부터는 codex delete(CLI), /delete(TUI), 그리고 app-server thread/delete RPC로 세션을 영구 삭제할 수 있고, 삭제 시 연결된 subagent까지 함께 정리된다.
잘못 누른 한 번으로 작업 기록이 사라지지 않도록 모든 경로에 확인 가드가 들어간다.
(0.140.0~)

활용

• 특정 세션 영구 삭제 (CLI):

  codex delete <SESSION_ID>

  복사
• TUI에서 현재 세션 영구 삭제:
  /delete
• app-server 클라이언트(IDE 익스텐션 등)에서 프로그래밍 방식 삭제:

  {"method": "thread/delete", "params": {"threadId": "..."}}

  복사

주의

영구 삭제는 되돌릴 수 없다 — 단순히 목록에서 숨기려는 경우엔 codex archive를 쓰는 편이 안전하다.
삭제된 세션에 묶여 있던 subagent 메타데이터도 같이 제거되므로, 외부 도구에서 해당 thread ID를 참조하고 있었다면 더 이상 조회되지 않는다.