본문으로 건너뛰기
전체 글
튜토리얼2026/07/17

Codex 데스크톱 앱에서 사용자 지정 테마를 가져오는 방법

네이티브 Codex 테마를 가져오고, 가독성을 확인하고, 이전 모양으로 복원하는 버전 인지형 체크리스트.

정밀한 라임 테마 스와치가 옵시디언 프레임으로 이동하는 모습

빠른 답변

Codex 설정을 열고, Appearance로 이동한 뒤, 사용자 지정 테마 가져오기 컨트롤에서 완전한 codex-theme-v1: 공유 문자열을 붙여 넣고, 미리보기를 확인한 후 적용하세요. 컨트롤의 정확한 레이블은 앱 빌드에 따라 달라질 수 있습니다.

이 단계는 2026년 7월 17일에 macOS의 Codex App 26.707.72221로 검토되었습니다.

가져오기 전에

해당 항목이 외부 Skin 설치 프로그램이 아닌 네이티브 테마인지 확인하세요. 네이티브 테마 문자열은 순수한 모양 데이터입니다. 셸 명령을 실행하거나, 디버깅 포트를 활성화하거나, 실행 파일을 다운로드하라고 요구해서는 안 됩니다.

테마 페이지에서 출처, 검증 날짜, 테스트된 플랫폼, Codex 빌드를 확인하세요. 간단한 복귀 지점을 확보할 수 있도록 현재 사용 중인 기본 테마의 이름을 기록해 두세요.

가져오기와 확인

  1. 테마 카탈로그에서 공개된 테마 페이지를 엽니다.
  2. 테마 페이지에서 테마 복사를 사용해 공유 문자열을 복사합니다.
  3. Codex에서 설정 > Appearance를 엽니다.
  4. 가져오기 필드에 완전한 공유 문자열을 붙여 넣습니다.
  5. 접두사나 JSON 페이로드를 자르거나 수정하지 마세요.
  6. 적용하기 전에 라이트 또는 다크 변형을 확인하세요.

적용한 후에는 제목, 본문 텍스트, 흐린 레이블, 버튼, 선택 상태, diff 추가, diff 삭제, 스킬, 펜스 코드 블록을 살펴 보세요. 앱을 재시작해 테마가 유지되는지 확인하세요.

흔한 실패 원인

invalid-string 오류는 대개 접두사나 JSON이 변경되었음을 의미합니다. 변형 불일치는 공유 문자열과 현재 활성화된 라이트/다크 가져오기 대상이 다르다는 뜻입니다. 코드 테마 불일치는 참조된 하이라이팅 패밀리를 해당 앱 버전에서 사용할 수 없다는 뜻입니다. 클립보드 실패는 반환된 문자열을 직접 선택해 수동으로 복사하면 우회할 수 있습니다.

결과를 읽기 어렵다면 즉시 기본 Codex 테마를 선택하세요. 네이티브 모양 변경에는 외부 정리 스크립트가 필요하지 않습니다. 더 넓은 범위의 문제 해결은 테마 초기화 또는 제거 방법을 읽어 보세요.