Codex CLI 터미널 제목 설정: /title로 프로젝트 탭을 처음 구분하는 법
TL;DR
Codex CLI 창을 여러 개 열어 두면 어느 탭이 어느 프로젝트인지 헷갈릴 수 있습니다. 대화형 TUI의
/title
을 열고
project-name
과
app-name
같은 항목을 고르면 터미널 창이나 탭 제목이 즉시 바뀝니다. 선택값은
config.toml
의
tui.terminal_title
에 저장됩니다. 처음에는 비민감 빈 폴더와 격리된
CODEX_HOME
에서 picker를 확인한 뒤 실제 환경에 적용하세요.
핵심 3줄 요약
핵심 1
/title
은 터미널 창·탭 제목에 표시할 항목을 고르는 Codex CLI 슬래시 명령입니다.
핵심 2
picker에서 항목을 토글하고 순서를 조정한 뒤 확정하면 제목이 즉시 바뀌고 설정이 저장됩니다.
핵심 3
첫 시험은 빈 폴더에서 진행하며 picker에 없는 항목이나 지원 조건을 추정하지 않습니다.
이 글에서 다룰 내용
-
/title을 어디에서 찾고 실행하는지 - 프로젝트 탭을 구분할 때 어떤 항목부터 고를지
-
tui.terminal_title에 선택값이 저장됐는지 확인하는 방법 -
/statusline,/theme,/rename과 혼동하지 않는 기준 - 실제 사용자 설정을 직접 편집하기 전에 지켜야 할 안전 경계
Codex CLI
/title
은 무엇인가
/title
은 Codex CLI의 터미널 창 또는 탭 제목에 표시할 항목을 대화형 picker에서 고르는 기능입니다. 셸에서 실행하는 별도 하위 명령이 아니라 Codex TUI composer에 입력하는 슬래시 명령입니다.
공식 문서는 picker에서 항목을 토글하고 순서를 바꾼 뒤 확정하도록 안내합니다. 그러면 터미널 제목이 즉시 바뀌고
config.toml
의
tui.terminal_title
에 선택값이 저장됩니다.
공식 목록에는 app name, project, spinner, status, thread, git branch, model, task progress가 포함됩니다. 설치된
codex-cli 0.144.6
의 격리 시험에서는
activity
,
project-name
,
app-name
,
current-dir
,
run-state
,
thread-title
,
git-branch
,
context-remaining
이 picker에 보였습니다. 이 관찰은 해당 버전과 시험 환경의 결과입니다. 다른 계정이나 버전의 목록을 보장하지 않습니다.
언제 이 기능이 잘 맞는가
프로젝트별로 Codex CLI 탭을 여러 개 열어 둘 때 유용합니다.
project-name
을 제목에 넣으면 긴 경로를 다시 읽지 않아도 현재 탭의 작업 대상을 구분하기 쉽습니다.
앱 이름도 함께 보고 싶다면
app-name
을 추가할 수 있습니다. 다만 제목은 작업 위치를 알아보는 표지일 뿐입니다. 현재 Git 상태, 권한, diff, 테스트 통과 여부까지 증명하지는 않습니다.
터미널 하단에서 모델이나 컨텍스트 상태를 계속 보고 싶은 목적이라면
/statusline
이 더 적합합니다. 구문 강조 색상은
/theme
, 저장된 채팅 이름은
/rename
의 범위입니다.
시작 전에 확인할 경계
첫 시험은 고객 자료, 비밀값, 운영 저장소가 없는 빈 폴더에서 진행합니다. 격리된
CODEX_HOME
을 쓰면 실제 사용자
config.toml
을 건드리지 않고 저장 결과를 확인할 수 있습니다.
공식
/title
절차에는 요금제, 운영체제, 터미널 종류, 지역, 언어, 최소 버전 조건이 따로 적혀 있지 않습니다. 이 조건을 임의로 채우지 말고 현재 계정의 composer에서
/title
completion이 나타나는지 먼저 확인합니다.
/title
을 입력했는데 명령 설명이나 completion row가 보이지 않으면 Enter를 누르지 않습니다. 인식되지 않은 문자열이 일반 프롬프트로 제출될 수 있기 때문입니다. 업데이트, 재설치, 재시작을 해결책으로 추정하지 말고 현재 문서와 설치 화면의 차이를 기록하세요.
/title
로 프로젝트 탭을 구분하는 순서
1단계: 비민감 빈 폴더에서 Codex CLI를 엽니다
실제 저장소가 아닌 빈 시험 폴더를 준비합니다. 설정 저장까지 검증하려면 별도
CODEX_HOME
을 사용하고 인증은 기존 Codex 인증을 읽기 전용으로 연결합니다. 시험 폴더에는 프로젝트 파일을 만들지 않습니다.
2단계: composer에서
/title
을 Enter 없이 입력합니다
Codex TUI가 유휴 상태인지 확인한 뒤 composer에
/title
을 입력합니다. 설치된
codex-cli 0.144.6
에서는
configure which items appear in the terminal title
이라는 completion 설명이 보였습니다.
이 설명이 보일 때만 다음 단계로 넘어갑니다. 셸 프롬프트에 입력하거나 completion이 없는 상태에서 Enter를 누르는 방식은 이 절차가 아닙니다.
3단계:
Configure Terminal Title
picker를 엽니다
completion을 선택해 picker를 엽니다. 공식 실행 흐름은 항목 토글, 순서 조정, 확정입니다. 설치 시험의 picker에는 Space로 토글하고 왼쪽·오른쪽 화살표로 순서를 옮긴 뒤 Enter로 확정한다는 안내가 표시됐습니다.
4단계:
project-name
을 유지하고
app-name
을 추가합니다
프로젝트 탭 구분이 목적이라면
project-name
을 우선합니다. 설치 시험에서는
activity
와
project-name
이 이미 선택돼 있었습니다. 검색 칸에
app-name
을 입력한 뒤 Space로 한 항목만 추가했습니다.
picker의 현재 선택을 먼저 읽으세요. 이미 선택된 항목에서 Space를 누르면 추가가 아니라 해제가 됩니다. 불필요한 항목을 한꺼번에 켜지 말고 목적에 필요한 최소 구성만 남깁니다.
5단계: Enter로 확정하고 제목 변화를 확인합니다
선택과 순서를 사람이 확인한 뒤 Enter로 확정합니다. 공식 문서에 따르면 터미널 창 또는 탭 제목은 즉시 업데이트됩니다.
제목이 바뀌었다는 사실은 설정 반영의 화면 증거입니다. 프로젝트 이름 자체가 올바른지, 다른 탭과 실제로 구분되는지도 사람이 직접 확인합니다.
6단계:
tui.terminal_title
저장값을 읽기 전용으로 확인합니다
격리 시험에서는 다음 값이 저장됐습니다.
[tui]
terminal_title = ["activity", "project-name", "app-name"]
이 값은
codex-cli 0.144.6
의 격리 관찰입니다. 공식 문서가 보장하는 핵심은 선택값이
tui.terminal_title
에 저장된다는 점입니다. 항목 이름과 기본 선택은 현재 picker를 기준으로 확인하세요.
격리 probe에서는 모델 turn이 시작되지 않았고 프로젝트 파일도 0개였습니다. 설정 확인을 마친 뒤 시험용
CODEX_HOME
과 빈 폴더를 삭제했습니다.
그대로 복사해 쓸 설정 검토 프롬프트
목표: Codex CLI 터미널 제목 설정이 승인한 항목과 순서대로 반영됐는지 검토합니다.
허용 입력: /title picker에서 사람이 확인한 선택 항목, 격리 config.toml의 tui.terminal_title 값, 비민감 시험 탭 제목만 사용합니다.
제외 입력: 실제 자격증명, 고객명, 운영 저장소 경로, 세션 ID, 소스 코드, 네트워크 전송은 제외합니다.
출력 형식: 선택 항목 | 저장 항목 | 화면 표시 | 판정 | 확인 필요를 한 행씩 적습니다.
완료 기준: picker 선택과 저장 배열의 항목·순서가 일치하고 시험 탭을 구분할 수 있으면 완료로 표시합니다.
추정 금지: picker에 없는 항목, 지원 운영체제·터미널·플랜, 동기화나 정확성 보장을 만들지 않습니다.
승인 지점: 사람이 항목과 순서를 확인하기 전에는 실제 사용자 설정을 직접 편집하거나 다른 환경에 배포하지 않습니다.
아래 문장은
/title
뒤에 붙여 실행하는 인수가 아닙니다. 설정 전후를 대조할 때 별도 검토 메모나 안전한 채팅에 붙여 넣는 프롬프트입니다.
실전 활용 팁
처음부터 많은 항목을 넣기보다
project-name
처럼 탭을 구분하는 데 직접 필요한 값부터 시작합니다. 정보가 많아질수록 제목이 길어져 오히려 탭 간 차이를 보기 어려울 수 있습니다.
검토 기록에는 picker 선택, 저장 배열, 화면 제목을 따로 적습니다. 세 값이 같아야 설정 반영과 표시 결과를 함께 확인할 수 있습니다. 제목만 보고 프로젝트 권한이나 Git 상태까지 맞다고 판단하지 않습니다.
주의할 점
-
/title은 Codex TUI composer에서 실행합니다. 일반 셸 명령이 아닙니다. - completion이 보이지 않으면 Enter를 누르지 않습니다. 현재 설치 표면과 공식 문서의 차이를 먼저 기록합니다.
- picker에 보이는 항목은 현재 화면을 기준으로 선택합니다. 격리 시험의 목록을 다른 버전의 고정 목록처럼 쓰지 않습니다.
- 터미널 제목은 식별 보조 장치입니다. diff, 테스트, 권한 검토, 사람이 내리는 최종 판단을 대신하지 않습니다.
- 첫 시험의 완료 지점은 제목 반영과 저장값 대조입니다. 실제 사용자 파일 직접 편집, 조직 배포, 동기화는 별도 승인 뒤에 진행합니다.
자주 묻는 질문
/title
은 셸에서 실행하는 명령인가요?
아닙니다. Codex CLI 대화형 TUI의 composer에 입력하는 슬래시 명령입니다. Enter 전에
/title
completion과 설명이 보이는지 확인하세요.
project-name
과
app-name
은 둘 다 필요한가요?
필수 조합으로 문서화된 것은 아닙니다.
프로젝트 탭 구분이 목적이면
project-name
부터 선택합니다. 앱 이름도 필요할 때
app-name
을 추가하세요. 현재 picker의 선택 상태를 먼저 읽으세요.
설정은 어디에 저장되나요?
공식 문서에 따르면 선택값은
config.toml
의
tui.terminal_title
에 저장됩니다. 격리 시험에서 해당 배열을 읽기 전용으로 확인한 뒤 실제 환경 적용 여부를 사람이 결정하세요.
/statusline
과 무엇이 다른가요?
/title
은 터미널 창·탭 제목을 구성합니다.
/statusline
은 Codex TUI 하단 footer 항목을 구성합니다. 표시 위치와 기대 결과가 다릅니다.
출처
공식 문서는 2026년 8월 28일에 HTTP 200으로 다시 확인했습니다.
/title
진입, picker 토글·재정렬, 즉시 반영,
tui.terminal_title
저장, 공식 항목 목록을 확인했습니다. 설치 화면 관찰은 같은 날
codex-cli 0.144.6
의 비민감 격리 환경에서 수행했습니다.
마무리
Codex CLI 탭이 늘어날수록 먼저 구분해야 할 것은 모델보다 작업 위치일 수 있습니다.
/title
picker에서는
project-name
중심의 최소 구성을 고릅니다. 제목 변화와
tui.terminal_title
저장값을 대조하면 첫 설정을 안전하게 끝낼 수 있습니다.
화면에 보이지 않는 제공 조건은 추정하지 마세요. 현재 composer의 completion과 picker를 확인하고 실제 사용자 설정 변경은 사람이 승인한 뒤 진행합니다.
