문제 해결

자주 묻는 질문

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

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

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

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

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

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

사이드바에서 프로젝트를 제거하려면 프로젝트 이름 위에 포인터를 놓고 점 세 개 메뉴를 선택한 다음 제거 를 선택하세요. 복원하려면 채팅 옆의 새 프로젝트 추가 버튼으로 프로젝트를 다시 추가하거나 다음 단축키를 사용하세요:

Cmd+O.

보관된 채팅 찾기

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

Work 대화가 다른 기기에 표시되지 않음

• 각 기기에서 ChatGPT로 동일한 계정과 워크스페이스에 로그인했는지 확인하세요.
• 워크스페이스 소유자에게 Work Cloud와 로컬 컴퓨터 액세스 허용 이 활성화되어 있는지 확인해 달라고 요청하세요. 클라우드 정책 중 하나라도 enforce_residency이 활성화되어 있으면 Work와 dots 모두에서 로컬 컴퓨터 액세스 허용 이 비활성화됩니다. 이 보호 조치는 워크스페이스의 데이터 보관 위치를 설정하지 않으며, 이 조치만으로 Work Cloud나 dots가 비활성화되지는 않습니다.
• 작업이 생성된 시점을 확인하세요. 동기화는 동기화를 활성화한 후 새로 생성된 작업에 적용됩니다. 프로젝트에 포함된 작업을 비롯한 기존 작업은 마이그레이션되지 않으며, 로컬에서만 실행되거나 로컬 파일 없이 클라우드에서 실행되는 기존 동작을 유지합니다.

기업의 경우 출시 시점에는 앱 내 로컬/클라우드 전환 설정과 기본값이 변경되지 않습니다. 특정 전환 설정이나 기본 모드만으로는 대화의 동기화 가능 여부를 확인할 수 없습니다. Work 대화를 찾을 때는 Codex 기록과 구분해서 확인하세요. 설정 방법은 Work Cloud 및 dots의 로컬 컴퓨터 액세스를, 자주 묻는 질문은 Work 관리자 FAQ를 참조하세요.

동기화된 작업에서 컴퓨터의 파일이나 도구를 사용할 수 없음

컴퓨터를 온라인 상태로 유지하고 연결을 유지하세요. 새 턴이 시작될 때 컴퓨터를 사용할 수 없으면, 조건을 충족하는 동기화된 작업은 컴퓨터의 파일이나 도구에 액세스하지 않고 클라우드 컨테이너에서 계속 진행될 수 있습니다. 실행 중인 턴이 컴퓨터에서 클라우드로 자동 이동하지는 않습니다.

Work Cloud의 로컬 컴퓨터 액세스를 끈 후 턴이 중단됨

Work Cloud의 로컬 컴퓨터 액세스를 끄면 실행 중인 턴이 중단됩니다. 여전히 Work 액세스 권한이 있다면 새 메시지를 보내 다른 턴을 시작하세요. 기존 클라우드 대화에서는 해당 턴이 로컬 파일에 액세스하지 않고 자동으로 Work Cloud를 사용합니다.

자동화된 정책 업데이트가 누락됨

Global 설정은 정책 API로 관리하세요. Local 또는 Codex Cloud 설정은 Agent Security UI로 관리하세요. 기존 Global API 워크플로는 마이그레이션 후에도 계속 사용할 수 있습니다. 스크립트와 Terraform 연동을 테스트하고 정책 할당과 순서가 변경되지 않았는지 확인하세요.

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

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

작업 트리에서 코드가 실행되지 않음

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

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

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

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

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

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

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

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

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

대신 승인 옵션이 없거나 비활성화되어 있는 경우

자동 검토를 사용하려면 메시지 입력창 아래의 권한 설정에서 대신 승인 을 선택하세요. 이 모드가 표시되지 않거나 비활성화되어 있다면 다음을 확인하세요:

1. 데스크톱 앱을 업데이트하고 자동 검토를 사용하려는 채팅에서 권한 메뉴를 확인하세요. 선택할 수 있는 옵션은 로컬 환경과 클라우드 환경에 따라 다를 수 있습니다.
2. Codex를 로컬에서 실행하는 경우, 실제 적용된 구성에 features.guardian_approval = false 설정이 명시되어 있는지 확인하고 구성된 권한 프로필, 승인 정책, 승인 검토자를 검토하세요. 구성 우선순위는 구성 기본 사항을 참조하세요. 로컬 구성은 관리형 클라우드 런타임을 제어하지 않습니다.
3. 관리형 워크스페이스에서 모드가 비활성화되어 있거나 표시되지 않으면 관리자에게 허용된 권한 프로필, 샌드박스 모드, 승인 정책, 승인 검토자를 확인해 달라고 요청하세요. 조직 또는 기기 정책에 따라 이러한 선택이 제한될 수 있으며, 로컬 설정으로 이를 재정의할 수는 없습니다.

이후에도 예상과 달리 모드를 사용할 수 없다면 앱 버전, 운영 체제, 실행 환경, 해당 옵션이 표시되지 않는지 또는 비활성화되어 있는지를 피드백에 포함하세요.

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

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

시스템에 설치된 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. 더 작고 구체적인 프롬프트로 새 채팅을 시작합니다.

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

터미널 문제

터미널이 멈춘 것처럼 보임

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

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

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

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

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

환경에서 네트워크 액세스를 허용하지만 작업이 차단됨

개별 설정을 비교하기 전에 정책 우선순위를 확인하세요. 우선순위가 낮은 정책이 더 구체적이더라도 우선순위가 높은 정책이 우선 적용됩니다. 하나의 정책 내에서는 OS별 환경 재정의가 모든 OS에 대한 환경 재정의보다 우선하며, 그다음으로 Global이 적용됩니다.

일부 네트워크 요구 사항에는 필드별 병합 규칙과 런타임 제한이 있습니다. 클라우드 런타임은 관리형 HTTP/SOCKS 리스너 포트와 루프백이 아닌 프록시 리스너를 지원하지 않으며, 소켓 규칙 지원 여부는 실행 경로에 따라 달라집니다. 로컬 실행의 병합 동작은 별도로 적용됩니다.

실제로 적용되는 정책을 비교하고 허용하거나 차단하려는 작업을 테스트하세요. 구체적인 사례는 관리형 구성을 참조하세요. 테스트 실패를 우회하기 위해 전역 기준 정책의 허용 범위를 넓히지 마세요.