문제 해결

자주 묻는 질문

Codex가 편집하지 않은 파일이 사이드 패널에 표시됨

프로젝트가 Git 저장소 안에 있으면 검토 패널에 프로젝트의 Git 상태를 기준으로 변경 사항이 자동 표시되며, 여기에는 Codex가 적용하지 않은 변경 사항도 포함됩니다.

검토 창에서 스테이징된 변경 사항과 아직 스테이징되지 않은 변경 사항 간에 전환하고, 브랜치를 main과 비교할 수 있습니다.

마지막 Codex 작업에서 발생한 변경 사항만 보려면 diff 창을 마지막 작업 보기로 전환하세요.

검토 창 사용 방법 자세히 알아보기.

사이드바에서 프로젝트 제거

사이드바에서 프로젝트를 제거하려면 프로젝트 이름 위에 마우스 포인터를 올리고 점 세 개를 클릭한 다음 "제거"를 선택하세요. 복원하려면 채팅 옆의 새 프로젝트 추가 버튼을 사용하거나 다음 단축키로 프로젝트를 다시 추가하세요.

Cmd+O.

보관된 채팅 찾기

보관된 채팅은 설정에서 찾을 수 있습니다. 채팅의 보관을 해제하면 사이드바의 원래 위치에 다시 표시됩니다.

일부 채팅만 사이드바에 표시됨

사이드바에서 프로젝트 상태에 따라 채팅을 필터링할 수 있습니다. 채팅이 보이지 않으면 채팅 옆의 필터 아이콘을 선택한 다음 시간순을 선택하세요. 그래도 채팅이 보이지 않으면 설정을 열고 보관된 채팅을 확인하세요.

worktree에서 코드가 실행되지 않음

worktree는 다른 디렉터리에 생성되며 기본적으로 Git에 체크인된 파일을 상속합니다. 프로젝트의 종속성과 도구를 관리하는 방식에 따라 로컬 환경을 사용하여 worktree에서 설정 스크립트를 실행하거나 .worktreeinclude을 사용하여 무시된 설정 파일을 복사해야 할 수 있습니다. 또는 일반 로컬 프로젝트에서 변경 사항을 체크아웃할 수 있습니다. 자세한 내용은 worktree 문서를 참조하세요.

앱이 팀원이 공유한 로컬 환경을 인식하지 못함

로컬 환경 구성은 프로젝트 루트의 .codex 폴더 안에 있어야 합니다. 프로젝트가 여러 개인 모노레포에서 작업하는 경우 .codex 폴더가 있는 디렉터리에서 프로젝트를 열었는지 확인하세요.

Codex가 Apple Music 접근 권한을 요청함

작업에 따라 Codex가 파일 시스템을 탐색해야 할 수 있습니다. Music, Downloads 또는 Desktop을 비롯한 macOS의 일부 디렉터리에 접근하려면 사용자의 추가 승인이 필요합니다. Codex가 홈 디렉터리를 읽어야 하는 경우 macOS에서 해당 폴더에 대한 접근 승인을 요청합니다.

예약된 작업이 많은 worktree를 생성함

예약된 작업을 자주 실행하면 시간이 지남에 따라 많은 worktree가 생성될 수 있습니다. 더 이상 필요하지 않은 예약 실행은 보관하고, 해당 worktree를 유지하려는 경우가 아니면 실행을 고정하지 마세요.

잘못된 대상을 선택한 후 프롬프트 복구

실수로 잘못된 대상(로컬, Worktree 또는 클라우드)으로 채팅을 시작했다면 현재 실행을 취소한 다음 작성기에서 위쪽 화살표 키를 눌러 이전 프롬프트를 복구할 수 있습니다.

Codex CLI에서는 기능이 작동하지만 ChatGPT 데스크톱 앱에서는 작동하지 않음

ChatGPT 데스크톱 앱과 Codex CLI에는 서로 다른 Codex 버전이 포함될 수 있으므로 한쪽에 기능이 먼저 제공될 수 있습니다. 실험적 기능도 Codex CLI에 먼저 도입될 수 있습니다.

시스템에 설치된 Codex CLI의 버전을 확인하려면 다음을 실행하세요.

codex --version

ChatGPT 데스크톱 앱에 번들로 제공된 Codex 버전을 확인하려면 유지된 Codex.app 호환성 번들 경로를 사용하세요.

/Applications/Codex.app/Contents/Resources/codex --version

피드백 및 로그

팀에 피드백을 제공하려면 메시지 작성기에 /를 입력하세요. 기존 채팅에서 피드백을 실행하면 피드백과 함께 기존 세션을 공유하도록 선택할 수 있습니다. 피드백을 제출하면 팀과 공유할 수 있는 세션 ID를 받게 됩니다.

문제를 신고하려면 다음 단계를 따르세요.

1. Codex GitHub 저장소에서 기존 이슈를 찾습니다.
2. 새 GitHub 이슈를 엽니다.

다음 위치에서 더 많은 로그를 확인할 수 있습니다.

• 앱 로그(macOS): ~/Library/Logs/com.openai.codex/YYYY/MM/DD
• 세션 기록: $CODEX_HOME/sessions (기본값: ~/.codex/sessions)
• 보관된 세션: $CODEX_HOME/archived_sessions (기본값: ~/.codex/archived_sessions)

로그를 공유하는 경우 먼저 검토하여 민감한 정보가 포함되어 있지 않은지 확인하세요.

멈춤 상태 및 복구 방법

채팅이 멈춘 것처럼 보이는 경우 다음을 수행하세요.

1. Codex가 승인을 기다리고 있는지 확인합니다.
2. 터미널을 열고 git status 같은 기본 명령을 실행합니다.
3. 더 작고 구체적인 프롬프트로 새 채팅을 시작합니다.

실수로 worktree 생성을 취소하여 프롬프트를 잃어버린 경우 작성기에서 위쪽 화살표 키를 눌러 복구하세요.

터미널 문제

터미널이 멈춘 것처럼 보임

1. 터미널 패널을 닫습니다.
2. Ctrl+`을 눌러 다시 엽니다.
3. pwd 또는 git status 같은 기본 명령을 다시 실행합니다.

명령이 예상과 다르게 동작하면 먼저 터미널에서 현재 디렉터리와 브랜치를 확인하세요.

계속 멈춰 있다면 활성 채팅이 완료될 때까지 기다린 후 앱을 다시 시작하세요.

글꼴이 올바르게 렌더링되지 않음

Codex는 검토 창, 통합 터미널 및 앱 내부에 표시되는 기타 모든 코드에 동일한 글꼴을 사용합니다. 설정 창의 코드 글꼴에서 글꼴을 구성할 수 있습니다.