Codex CLI 테마 설정: /theme으로 구문 강조 색상을 처음 바꾸는 법
TL;DR
Codex CLI의 구문 강조 색상을 바꾸려면 운영체제 셸이 아니라 Codex TUI 입력창에서
/theme
을 선택합니다. picker에서 위·아래로 이동하면 예제 코드의 색상이 바로 바뀌며, 마음에 드는 theme에서 Enter를 누르면 선택이
config.toml
의
tui.theme
에 저장됩니다. 첫 시험은 비민감한 빈 폴더에서 completion, 미리보기, 저장값만 확인하면 됩니다.
핵심 3줄 요약
핵심 1
/theme
은 Codex TUI 안에서 syntax-highlighting theme을 고르는 slash command입니다.
핵심 2
공식 순서는 picker에서 theme을 미리 본 뒤 사람이 확정하는 두 단계입니다.
핵심 3
완료 여부는 색상 취향이 아니라 picker가 열렸는지와
tui.theme
저장값이 기대와 같은지로 판단합니다.
이 글에서 다룰 내용
-
/theme을 입력할 정확한 위치 -
Select Syntax Themepicker에서 미리보는 순서 - 첫 설정에서 확인할 색상 기준과 저장값
- 지원 조건을 추정하지 않고 현재 설치 화면을 읽는 법
먼저 답: /theme은 무엇인가
/theme
은 Codex TUI가 표시하는 구문 강조 색상 theme을 picker에서 고르는 명령입니다. OpenAI 공식 문서는
/theme
을 입력하고 theme을 미리 본 뒤 확정하라고 안내합니다. 확정하면 Codex가 syntax highlighting을 바꾸고 선택을
config.toml
의
tui.theme
에 저장합니다.
이 기능은 코드나 답변 내용을 수정하는 명령이 아닙니다. 테마를 바꿨다고 코드 품질, diff 정확성, 명령 안전성이 달라졌다고 판단해서는 안 됩니다. 터미널 애플리케이션의 배경색·글꼴 설정도 별도 범위로 둡니다.
공식
/theme
섹션은 운영체제, 터미널, 플랜, 지역, 언어, 최소 버전, 고정 theme 목록을 명시하지 않습니다. 문서에 나온 theme 이름을 외우기보다 현재 Codex 입력창에서
/theme
completion이 보이는지 먼저 확인하세요.
시작 전 확인할 것
첫 시험은 비민감한 빈 폴더에서 진행합니다. 실제 저장소나 고객 자료를 열 필요가 없습니다. 현재 theme 이름을 메모하고, 변경할 후보 하나와 확인 담당자를 정합니다.
이번 격리 검증에서는
codex-cli 0.144.6
을 사용했습니다. Enter를 누르기 전
/theme choose a syntax highlighting theme
completion이 보였고, picker의 현재 theme은
catppuccin-mocha
였습니다. 이는 해당 설치본에서 관찰한 값이며 모든 환경의 기본값이나 지원 목록을 뜻하지 않습니다.
시작 작업이 남아 있을 때는 명령이 보이더라도
'/theme' is disabled while a task is in progress.
가 나타날 수 있었습니다. 이 문구가 보이면 Enter를 연속으로 누르지 마세요. 시작 작업이 끝난 뒤 completion을 다시 확인합니다. 이 역시 로컬 관찰입니다. 일반적인 업데이트·재시작 문제로 확대해서는 안 됩니다.
실행 순서: /theme으로 구문 강조 색상 바꾸기
1. Codex TUI 입력창에서 /theme을 찾습니다
Codex 대화형 화면의 composer를 활성화합니다. Bash, PowerShell, zsh 같은 운영체제 shell에
/theme
을 입력하지 않습니다.
/theme
을 문자 그대로 입력한 뒤 Enter를 누르기 전에 completion row를 봅니다. 현재 검증 화면에서는
/theme choose a syntax highlighting theme
이 나타났습니다. 설명 행이 없거나
no matches
가 보이면 입력을 지우고 이번 시험을 중단합니다. 인식되지 않은 slash token을 일반 prompt로 제출하지 않습니다.
2. Select Syntax Theme picker가 열렸는지 확인합니다
completion을 확인한 뒤 Enter를 한 번 누릅니다. 현재 설치 화면에서는
Select Syntax Theme
제목과
Move up/down to live preview themes
안내가 나타났습니다.
picker 대신 진행 중 작업 때문에 비활성화됐다는 문구가 보이면 작업 상태를 먼저 확인합니다. 같은 명령을 반복 제출하지 않습니다. 작업이 끝난 뒤
/theme
completion부터 다시 확인합니다.
3. 위·아래로 이동하며 예제 코드를 미리 봅니다
picker에서 위·아래로 이동하면 선택 줄과 예제 코드의 색상이 함께 바뀝니다. 이번 검증 화면에는 함수, 문자열, 삭제 줄, 추가 줄이 포함된 짧은 예제가 보였습니다.
첫 비교에서는 세 가지만 봅니다. 일반 텍스트와 코드가 구분되는지, 추가 줄과 삭제 줄을 기호와 함께 알아볼 수 있는지, 긴 작업에서 눈에 부담이 적은지 확인합니다. 특정 theme이 모든 사용자에게 더 좋다고 단정하지 않습니다.
4. 사람이 선택을 확인한 뒤 Enter로 확정합니다
이번 격리 시험에서는 현재
catppuccin-mocha
에서 한 칸 위의
catppuccin-macchiato
로 이동했습니다. picker는
Press enter to confirm or esc to go back
이라고 안내했습니다.
변경할 theme 이름과 미리보기를 사람이 확인한 뒤 Enter로 확정합니다. 취소하려면 현재 화면의 Esc 안내를 따릅니다. 공식 문서는 picker에서 미리 본 뒤 확정하는 순서만 제시하므로, 첫 시험에서 설정 파일을 직접 편집하지 않습니다.
5. tui.theme 저장값을 읽고 완료를 판단합니다
OpenAI 공식 문서에 따르면 확정한 선택은
config.toml
의
tui.theme
에 저장됩니다. 격리 검증에서는 다음 값이 만들어졌습니다.
[tui]
theme = "catppuccin-macchiato"
이 예시는 설치 표면을 확인하기 위한 로컬 관찰입니다. 사용자의 기존 설정을 덮어쓸 템플릿이 아닙니다. picker에서 고른 이름과 저장된 값이 같은지만 읽고, 다른 설정은 수정하지 않습니다.
완료 판정 체크리스트
다음 세 조건을 모두 만족하면 첫 설정을 마칩니다.
- Enter 전
/themecompletion 설명을 확인했습니다. -
Select Syntax Themepicker에서 선택 줄과 예제 코드가 함께 바뀌는 것을 확인했습니다. - 확정 뒤
tui.theme값이 사람이 고른 theme과 일치했습니다.
이번 격리 시험에서는 프로젝트 파일 생성과
/theme
에 의한 모델 turn이 없었습니다. 색상이 마음에 드는지는 별도 사용자 판단입니다. 저장값이 다르면 완료로 기록하지 않습니다.
복사해서 쓰는 비민감 테마 선택 프롬프트
목표: 현재 Codex syntax theme 후보 중 읽기 편한 한 개를 고르기
허용 입력: 현재 picker에 실제로 보이는 theme 이름, 예제 코드의 보이는 차이, 사용자가 밝힌 밝은·어두운 배경 선호만 사용
제외 입력: 고객명, 실명, 이메일, 계정 식별자, 인증정보, 비밀값, 내부 경로, picker에 없는 theme 이름은 사용하지 않기
출력 형식: 후보 2개, 각 후보의 보이는 장점 한 문장, 최종 확인 항목 3개
완료 기준: 사람이 picker 미리보기를 확인하고 한 개를 승인한 뒤 tui.theme 저장값이 같은지 읽기
추측 금지: 플랜, 운영체제, 최소 버전, 고정 theme 목록, 코드 품질 개선 효과를 만들지 않기
승인 지점: 사람이 후보와 미리보기를 확인하기 전에는 Enter로 확정하거나 config.toml을 직접 편집하지 않기
아래 문구는
/theme
picker에 붙여 넣는 명령이 아닙니다. picker를 열기 전에 어떤 기준으로 후보를 볼지 정리할 때만 사용합니다.
프롬프트가 추천한 이름이 현재 picker에 없으면 사용하지 않습니다. 실제 선택과 확정은 사람이 Codex 화면에서 진행합니다.
실전 인사이트: 테마는 검증 결과가 아니라 읽기 환경입니다
좋은 theme의 기준은 이름이나 인기보다 현재 화면에서 필요한 차이를 빨리 읽을 수 있는지입니다. 코드 예제의 색이 선명해도 실제 diff가 정확하다는 뜻은 아닙니다. 추가·삭제 기호, 파일 경로, 테스트 결과를 따로 확인해야 합니다.
theme을 처음부터 많이 비교하면 판단 기준이 흐려집니다. 현재 theme과 후보 하나를 같은 예제로 비교한 뒤 작업 중 불편이 실제로 줄었는지 사람이 판단하세요. 이번 글은 색상 선택과 저장 확인에서 끝내며 터미널 배경·폰트 변경이나 theme 동기화는 다루지 않습니다.
주의할 점
-
/theme은 운영체제 shell 명령이 아니라 Codex TUI의 slash command입니다. - 공식 문서가 확정하지 않은 운영체제, 터미널, 플랜, 지역, 언어, 최소 버전을 추정하지 않습니다.
- 로컬에서 보인
catppuccin-mocha와catppuccin-macchiato를 모든 설치의 기본값이나 필수 선택으로 일반화하지 않습니다. - 명령이 작업 중 비활성화됐다는 문구를 업데이트·재시작·설치 오류의 증거로 단정하지 않습니다.
- 첫 시험에서는 picker가 저장한
tui.theme을 읽기만 하고config.toml을 직접 덮어쓰지 않습니다. - theme 선택은 코드 품질, diff 정확성, 권한 안전성, 작업 완료를 보증하지 않습니다.
자주 묻는 질문
/theme을 Bash나 PowerShell에서 실행해도 되나요?
아닙니다. Codex 대화형 TUI의 composer에서 선택하는 slash command입니다. Enter를 누르기 전에 completion 설명을 확인하세요.
어떤 syntax theme이 가장 좋은가요?
공식 문서는 한 theme을 권장하지 않습니다. 현재 picker의 미리보기에서 일반 텍스트와 코드, 추가 줄과 삭제 줄을 읽기 편한지 보고 사람이 고릅니다.
선택한 theme은 어디에 저장되나요?
OpenAI 공식 문서는 선택이
config.toml
의
tui.theme
에 저장된다고 설명합니다. 첫 설정에서는 파일을 직접 편집하지 말고 picker가 저장한 값과 선택한 이름이 같은지만 읽습니다.
/theme이 보이지 않으면 업데이트하거나 재시작해야 하나요?
이 공식 섹션만으로는 그렇게 단정할 수 없습니다. 현재 입력창에서 completion이 보이는지 확인하고, 작업 중 비활성화 문구가 있다면 작업이 끝난 뒤 한 번 다시 확인합니다. 운영체제·최소 버전·제공 조건은 현재 공식 섹션에서 확인되지 않았습니다.
출처
- OpenAI Codex Developer Commands 공식 문서 —
/theme입력, picker 미리보기, 확정, syntax highlighting 변경,tui.theme저장 순서를 확인했습니다.
마무리
Codex CLI 테마의 첫 설정은
/theme
completion 확인 →
Select Syntax Theme
picker 열기 → 위·아래 미리보기 → 사람의 확정 →
tui.theme
저장 확인으로 끝낼 수 있습니다. 색상을 바꿨더라도 코드가 더 정확해졌다고 추정하지 마세요. 읽기 환경과 작업 검증은 따로 봐야 합니다.
