Codex CLI 테마가 적용되지 않나요? 5단계로 해결하세요

/theme 명령어가 아무것도 반환하지 않거나, 색상이 변경되지 않거나, 팔레트가 잘못 표시되는 경우? Codex CLI 테마 관련 문제는 거의 항상 다음 다섯 가지 원인 중 하나입니다. 아래 순서대로 각 원인을 진단하고 해결하는 방법을 안내합니다.

1. 테마가 설치되지 않음(가장 흔한 원인)

/theme 명령어는 Codex CLI의 테마 디렉터리에 실제로 존재하는 테마만 목록으로 표시합니다. 설치 스크립트를 한 번도 실행하지 않았다면, 목록은 비어 있거나 기본 테마만 표시됩니다.

해결 방법: 먼저 팔레트를 설치하세요.

curl -fsSL https://raw.githubusercontent.com/vufly/bearded-theme-ports/master/scripts/install-codex.sh | sh

그 후 프롬프트를 다시 열고 /theme을 다시 실행하세요 — 새 팔레트가 정확한 이름으로 목록에 나타날 것입니다.

2. 시작 시 오래된 색상 캐시

일부 포팅 버전(port)은 Codex CLI 시작 시 색상을 캐시합니다. 테마를 적용한 후에는 다음 실행까지 팔레트가 잘못 표시될 수 있습니다.

해결 방법: 테마 적용 후 Codex CLI를 재시작하고, 동일한 이름으로 /theme을 다시 실행하세요. 올바른 팔레트가 표시된다면, 캐시가 원인이었습니다.

3. 테마 이름이 정확히 일치하지 않음

/theme은 테마 이름을 정확히 일치시켜 매칭합니다. 예: Tokyo Night는 tokyo-night나 TokyoNight와 동일하지 않습니다.

해결 방법: 인자 없이 /theme을 실행하여 목록에서 정확한 이름을 복사한 후, 그대로 적용하세요.

4. 잘못되었거나 불완전한 팔레트 파일

포팅 스크립트에서 복사한 팔레트 파일이 불완전할 수 있습니다 — 배경색, 전경색 또는 구문 강조 키가 누락된 경우입니다. 이 경우 대부분의 색상은 기본값으로 유지되며, 일부 항목만 변경된 것처럼 보입니다.

해결 방법: 완전한 테마를 다시 가져오기 위해 설치 스크립트를 재실행하거나, 관리 도구로 파일을 검증하세요:

# Codex Themes CLI는 적용 전에 팔레트를 자동으로 검증합니다:
codex-theme validate <name>
codex-theme apply <name>

5. 터미널과 CLI 간 설정 불일치

터미널은 올바르게 적용되었지만 Codex CLI는 그렇지 않거나(또는 그 반대의 경우), 두 환경이 서로 다른 설정을 읽고 있다는 뜻입니다. CLI 테마는 단지 색상 팔레트일 뿐이며, 터미널 프로필 자체는 변경하지 않습니다.

해결 방법: 동일한 팔레트를 터미널과 CLI 모두에 내보내세요. Codex Themes CLI는 동일한 색상을 터미널 프로필에도 기록할 수 있으므로, 한 번의 적용으로 두 환경을 동시에 동기화할 수 있습니다:

codex-theme export <name> --to-terminal

여전히 해결되지 않나요?

깨끗한 상태로 초기화하세요: 팔레트를 제거한 후, Codex CLI를 재시작하고, 다시 설치한 다음, 정확한 이름으로 적용하세요. 특정 스킨에서 문제가 발생한다면, 최신 팔레트 변형을 확인하려면 Mono & Terminal 카테고리를 살펴보거나, 전체 설치 절차를 확인하려면 CLI 테마 가이드를 참조하세요.