Codex CLI 치트시트

/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를 참조하고 있었다면 더 이상 조회되지 않는다.

/app은 TUI에 떠 있는 현재 스레드를 macOS·Windows의 Codex Desktop으로 그대로 이어 보낸다.
CLI에서 탐색·편집을 진행하던 중 풍부한 패널이나 다중 창이 필요한 작업으로 자연스럽게 옮기고 싶을 때, 새 스레드를 다시 띄우지 않고 같은 컨텍스트를 데스크톱에서 이어 받을 수 있다.
Windows에서 워크스페이스 진입 흐름도 데스크톱이 설치돼 있으면 수동 확인 단계 없이 바로 데스크톱으로 열린다.

활용

• 현재 TUI 세션을 데스크톱으로 옮기기:
  /app
• Windows에서 워크스페이스 진입 시 데스크톱 앱이 설치돼 있으면 별도 프롬프트 없이 자동 핸드오프 (0.138.0~)
• 같은 머신에서 TUI는 빠른 탐색·요약에, 데스크톱은 검토·시각화에 사용하는 흐름 분리

주의

/app은 Codex Desktop이 설치돼 있는 macOS·Windows에서만 동작한다.
Linux나 데스크톱 앱이 없는 환경에서는 핸드오프 대상이 없어 무시된다.
/apps(연결된 외부 앱 목록 조회)와는 이름만 비슷한 별개의 명령이다.