Codex CLI 세션 이름 변경: /rename으로 현재 작업에 이름을 처음 붙이는 법
TL;DR
Codex에서 현재 작업을 나중에 알아보기 쉽게 만들려면 TUI 입력창에서
/rename
을 선택합니다. 공식 문서는 이 명령이 저장된 세션에 알아보기 쉬운 이름을 붙인다고 설명합니다. 첫 시험은 비민감 이름을 입력하고
Session renamed
확인까지만 진행하세요.
핵심 3줄 요약
핵심 1
/rename
은 운영체제 셸이 아니라 Codex TUI 안에서 쓰는 slash command입니다.
핵심 2
현재 검증한
codex-cli 0.144.6
은
Name thread
와
Session renamed
를 표시했습니다.
핵심 3
세션 식별 이름만 바꾸며 프로젝트 폴더, Git 브랜치, 파일, transcript를 삭제하지 않습니다.
이 글에서 다룰 내용
-
/rename을 찾아야 하는 정확한 위치 - 첫 이름에 넣어도 되는 정보와 빼야 할 정보
- 이름 입력부터 확인 메시지까지의 5단계
-
/archive,/delete, 프로젝트 이름 변경과의 차이
Codex
/rename
은 무엇인가
한 문장 정의:
/rename
은 Codex 대화형 TUI를 떠나지 않고 현재 저장 세션에 알아보기 쉬운 이름을 붙이는 명령입니다.
공식 문서는 대상을
current chat
이라고 표현합니다. 현재 설치본의 명령 목록과 입력창에서는
current thread
,
Name thread
라는 표현이 보였습니다.
두 표현은 이번 글에서 같은 현재 세션을 가리킵니다. 다만 공식 문서에 없는 운영체제, 터미널, 플랜, 지역, 언어, 최소 버전 조건은 추정하지 않습니다. 현재 Codex 입력창에서 명령 설명이 실제로 나타나는지 먼저 확인해야 합니다.
/rename
은 폴더명, Git 브랜치명, 파일명을 바꾸지 않습니다. 같은 공식 명령 목록에서
/archive
는 현재 세션을 보관하고 종료합니다.
/delete
는 transcript와 하위 세션을 영구 삭제합니다. 이름 변경과 보관·삭제를 한 작업으로 묶지 마세요.
언제 쓰면 좋은가
같은 저장소에서 조사, 구현, 테스트 세션이 함께 쌓이면 이름만으로는 목적을 가려내기 어렵습니다.
/rename
으로 작업 대상과 상태를 붙여 두면 세션을 다시 고를 때 단서가 됩니다.
다만 세션 이름은 작업의 정확성이나 최신성을 보증하지 않습니다. 이름이 맞더라도 실제 디렉터리와 코드 상태는 달라질 수 있습니다. 첫 실행의 완료 범위는 이름 확인까지입니다. 세션 재개나 코드 작업은 별도 판단으로 남깁니다.
/rename
으로 현재 세션에 이름을 붙이는 5단계
1. 비민감 테스트 이름을 정합니다
첫 시험에는
login-flow-review
처럼 작업 대상과 상태만 드러내는 이름을 씁니다. 고객명, 실명, 이메일, 인증정보, 비밀값, 민감 경로는 제외합니다.
이 이름 형식이 Codex의 공식 규칙이라는 뜻은 아닙니다. 공개해도 되는 짧은 식별자를 만들기 위한 내부 운영 예시입니다.
2. Codex TUI 입력창에서
/rename
을 입력합니다
운영체제 셸이 아니라 Codex 대화형 화면의 입력창을 활성화합니다.
/rename
을 입력하되 처음에는
Enter
를 누르기 전에 명령 목록을 봅니다.
현재 검증 환경에서는
/rename rename the current thread
가 나타났습니다. 설명이 보이지 않으면 입력을 취소하고 현재 설치 버전과 공식 문서를 대조하세요. 확인되지 않은 slash token을 일반 프롬프트로 제출하지 않습니다.
3. 명령을 선택하고 이름 입력창을 확인합니다
명령 설명을 확인한 뒤
Enter
를 누릅니다. 현재
codex-cli 0.144.6
에서는
Name thread
,
Type a name and press Enter
,
Press enter to confirm or esc to go back
가 표시됐습니다.
이는 WSL의 격리된 로컬 검증 결과입니다. 모든 운영체제와 버전에서 문구와 화면 배치가 같다고 단정하지 않습니다. 이름 입력창이 열리지 않으면 첫 시험을 중단합니다.
4. 이름을 입력하고 사람이 승인합니다
준비한
login-flow-review
를 입력합니다. 확정하기 전에 고객명이나 내부 식별자가 섞이지 않았는지 사람이 다시 봅니다.
확정하지 않으려면 화면에 나온 취소 안내를 따릅니다. 현재 검증 화면은
Esc
로 돌아갈 수 있다고 안내했습니다. 이름을 제출할지는 사람이 결정합니다.
5. 확인 메시지를 읽고 멈춥니다
Enter
로 확정한 뒤
Session renamed to ...
가 나타나는지 봅니다. 현재 검증에서는 같은 메시지에
codex resume
에서 해당 이름을 선택하라는 안내도 함께 표시됐습니다.
첫 완료 경계: 기대한 이름과 확인 메시지의 이름이 같으면 멈춥니다.
codex resume
을 실행하지 않습니다. 세션 보관·삭제, 프로젝트 파일이나 Git 상태 변경도 포함하지 않습니다.
결과를 읽고 완료를 판단하는 법
통과 기준은 세 가지로 좁힐 수 있습니다. Codex TUI 안에서
/rename
명령 설명이 보여야 합니다. 이름 입력창이 열리고 확정 뒤
Session renamed
와 기대한 비민감 이름이 함께 표시돼야 합니다.
명령 설명 없이 slash token이 일반 입력처럼 보이면 제출하지 않습니다. 이름 입력창에서 취소했거나 확인 메시지가 없다면 변경 완료로 기록하지 않습니다.
codex resume
목록에서 이름을 다시 찾는 작업은 유용할 수 있지만 첫 설정의 필수 완료 조건은 아닙니다.
이름 후보를 정리하는 복사 프롬프트
아래 프롬프트는
/rename
입력창에 그대로 넣는 이름이 아닙니다. 작업 목적을 비민감 후보로 압축할 때만 선택적으로 사용합니다. 최종 이름은 사람이 검토합니다.
목표: 현재 Codex 작업을 구분할 비민감 세션 이름 후보 3개를 만듭니다.
허용 입력: 사람이 제공한 공개 가능한 작업 대상, 문제, 진행 상태만 사용합니다.
제외 입력: 고객명, 실명, 이메일, 계정 식별자, 인증정보, 비밀값, 내부 경로, 제공되지 않은 프로젝트 정보는 사용하지 않습니다.
출력 형식: 짧은 세션 이름 후보 3개를 한 줄에 하나씩 제시하고 설명은 붙이지 않습니다.
완료 기준: 사람이 후보 하나를 검토해
/rename
의 이름 입력창에 직접 넣고
Session renamed
에서 같은 이름을 확인합니다.
추정 금지: 입력에 없는 저장소, 브랜치, 파일, 고객, 기한, 작업 상태를 만들지 않습니다.
승인 지점: 사람이 후보를 선택하기 전에는 이름을 확정하지 않습니다. 세션 재개, 보관, 삭제, 파일 수정은 별도 승인으로 남깁니다.
실전 활용 팁
세션 이름은
대상-작업-상태
처럼 팀이 알아보는 비민감 순서로 맞추면 찾기 쉽습니다. 예를 들어
auth-flow-review
와
auth-flow-test
는 같은 대상을 다루더라도 현재 목적이 다르다는 점을 보여줍니다.
이름을 붙인 시점과 작업 내용이 크게 달라졌다면 같은 이름이 계속 정확한지 검토합니다.
/rename
은 다시 사용할 수 있습니다. 다만 이름 변경 이력과 동기화 범위는 공식 문서에서 확인되지 않았으므로 별도 기능처럼 추정하지 않습니다.
주의할 점
-
/rename은 Codex TUI 안에서 선택합니다. 셸 명령처럼 실행하지 않습니다. - 명령 설명이 보이기 전에
Enter를 누르지 않습니다. - 공식 문서가 확정하지 않은 제공 조건을 추정하지 않습니다.
- 세션 이름에 고객명, 개인정보, 인증정보, 비밀값, 민감 경로를 넣지 않습니다.
- 이름 변경은 프로젝트 폴더, Git 브랜치, 파일, 권한, 보관 상태를 바꾸지 않습니다.
-
/archive와/delete는 별도 명령입니다.
자주 묻는 질문
/rename
을 셸에서 실행해도 되나요?
아닙니다.
/rename
은 Codex 대화형 TUI 안의 slash command입니다. Codex 입력창에서 명령 설명을 확인한 뒤 선택하세요.
Name thread
와 공식 문서의
current chat
은 다른 기능인가요?
이번 공식 문서는
/rename
을 현재 chat의 이름 변경으로 설명합니다. 현재 설치본은 명령 설명과 입력창에서 thread를 사용했습니다. 이 글은 둘을 현재 저장 세션을 가리키는 문구 차이로 다루되, 다른 버전의 화면까지 같다고 일반화하지 않습니다.
이름을 바꾸면 프로젝트 폴더나 Git 브랜치도 바뀌나요?
아닙니다. 공식 문서는 저장 세션에 알아보기 쉬운 이름을 붙이는 기능으로 설명합니다. 폴더, 브랜치, 파일을 바꾸는 기능이라는 근거는 없습니다.
/rename
과
/archive
는 무엇이 다른가요?
/rename
은 현재 세션에 식별 이름을 붙입니다. 공식 명령 문서에서
/archive
는 현재 세션을 보관하고 Codex를 종료합니다. 처음 이름을 붙이는 과정에서는
/archive
나
/delete
를 실행하지 마세요.
출처
- OpenAI Codex Developer Commands 공식 문서 —
/rename의 정의와/archive,/delete경계를 확인했습니다.
마무리
Codex 세션에 처음 이름을 붙일 때는 입력창에서
/rename
설명 확인 →
Name thread
열기 → 비민감 이름 검토 →
Session renamed
확인 순서로 진행하세요. 이름 변경은 세션을 찾기 쉽게 만드는 표지입니다. 파일이나 Git 상태를 바꾸는 작업과 분리해야 안전합니다.
