자주 묻는 질문
Codex가 수정하지 않은 파일이 측면 패널에 표시됩니다
프로젝트가 Git 리포지터리 안에 있으면 검토 패널에 프로젝트의 Git 상태를 기준으로 변경 사항이 자동으로 표시됩니다. 여기에는 Codex가 수정하지 않은 내용도 포함됩니다.
검토 패널에서는 스테이징된 변경 사항과 아직 스테이징되지 않은 변경 사항을 전환해 볼 수 있고, 현재 브랜치를 main과 비교할 수도 있습니다.
Codex가 마지막 턴에서 변경한 내용만 보려면 변경 사항 비교 패널에서 마지막 턴 보기를 선택하세요.
사이드바에서 프로젝트 제거하기
사이드바에서 프로젝트를 제거하려면 프로젝트 이름 위에 마우스 포인터를 놓고 점 세 개 아이콘을 선택한 다음 제거를 선택하세요. 프로젝트를 다시 추가하려면 새 프로젝트 추가 버튼(채팅 옆)을 사용하거나 다음 단축키를 누르세요.
Cmd+O.
보관된 채팅 찾기
보관된 채팅은 설정에서 찾을 수 있습니다. 채팅 보관을 해제하면 사이드바의 원래 위치에 다시 표시됩니다.
다른 기기에서 Work 대화가 보이지 않습니다
- 각 기기에서 같은 ChatGPT 계정으로 로그인한 다음 같은 워크스페이스의 Work 기록에서 대화를 찾아보세요. Codex 기록은 별도로 관리됩니다.
- 워크스페이스 소유자에게 Work Cloud와 로컬 컴퓨터 액세스 허용 설정이 모두 켜져 있는지 워크스페이스 권한에서 확인해 달라고 요청하세요. 클라우드 정책에서
enforce_residency를 사용 설정하면 로컬 컴퓨터 액세스가 차단됩니다. - 로컬 컴퓨터 액세스를 사용하기 전에 만든 작업이라면 데스크톱 앱의 메시지 입력창에서 클라우드를 선택하고 새 Work 작업을 시작하세요.
동기화된 작업에서 컴퓨터의 파일이나 도구를 사용할 수 없습니다
파일이 있는 컴퓨터에서 ChatGPT 데스크톱 앱을 열고 같은 워크스페이스에 로그인하세요. 컴퓨터가 온라인 상태로 연결을 유지하도록 하세요. 컴퓨터가 오프라인일 때 턴을 시작했다면 해당 턴이 파일에 접근할 수 없는 클라우드 컨테이너에서 실행 중일 수 있습니다.
Work Cloud의 로컬 컴퓨터 액세스를 끈 후 턴이 중단되었습니다
Work 액세스 권한이 여전히 있으면 기존 클라우드 대화에서 새 메시지를 보내세요. 새 턴에서는 Work Cloud를 사용할 수 있지만 로컬 파일은 사용할 수 없습니다.
자동 정책 업데이트가 반영되지 않습니다
전역 설정은 정책 API에서 관리하세요. 로컬 또는 Codex Cloud 설정은 에이전트 보안 UI에서 관리하세요. 마이그레이션 후에도 기존 전역 설정용 API 워크플로우를 사용할 수 있습니다. 스크립트와 Terraform 연동을 테스트하고 정책 할당과 순서가 그대로인지 확인하세요.
사이드바에 일부 채팅만 표시됩니다
사이드바에서는 프로젝트 상태에 따라 채팅을 필터링할 수 있습니다. 찾는 채팅이 보이지 않으면 채팅 옆의 필터 아이콘을 선택한 다음 시간순을 선택하세요. 그래도 채팅이 보이지 않으면 설정을 열고 보관된 채팅을 확인하세요.
작업 트리에서 코드가 실행되지 않습니다
작업 트리는 별도 디렉터리에 생성되며 기본적으로 Git에 체크인된 파일을 상속합니다. 프로젝트의 종속성과 도구를 관리하는 방식에 따라 로컬 환경을 사용해 작업 트리에서 설정 스크립트를 실행하거나 .worktreeinclude를 사용해 Git이 무시하는 설정 파일을 복사해야 할 수 있습니다. 평소 사용하는 로컬 프로젝트에서 변경 사항을 체크아웃할 수도 있습니다. 자세한 내용은 작업 트리 문서를 참고하세요.
앱이 팀원이 공유한 로컬 환경을 인식하지 못합니다
로컬 환경 설정은 프로젝트 루트의 .codex 폴더 안에 있어야 합니다. 여러 프로젝트가 있는 모노레포에서 작업한다면 .codex 폴더가 있는 디렉터리에서 프로젝트를 열었는지 확인하세요.
Codex가 Apple Music 접근 권한을 요청합니다
작업에 따라 Codex가 파일 시스템을 탐색해야 할 수 있습니다. macOS에서 음악, 다운로드, 데스크탑 등의 디렉터리에 접근하려면 사용자의 추가 승인이 필요합니다. Codex가 홈 디렉터리를 읽어야 하는 경우 macOS에서 해당 폴더에 대한 접근을 승인하라는 메시지가 표시됩니다.
예약 작업으로 작업 트리가 많이 생성됩니다
예약 작업을 자주 실행하면 시간이 지날수록 작업 트리가 많이 쌓일 수 있습니다. 더 이상 필요하지 않은 예약 작업 실행 기록은 보관 처리하고, 작업 트리를 유지하려는 경우에만 해당 실행 기록을 고정하세요.
실행 대상을 잘못 선택했을 때 프롬프트 복구하기
실수로 잘못된 대상(로컬, 작업 트리, 클라우드)에서 채팅을 시작했다면 현재 실행을 취소하고 메시지 입력창에서 위쪽 화살표 키를 눌러 이전 프롬프트를 복구할 수 있습니다.
대신 승인 옵션이 없거나 비활성화되어 있습니다
자동 검토를 사용하려면 메시지 입력창 아래의 권한 메뉴에서 대신 승인을 선택하세요. 이 모드가 보이지 않거나 비활성화되어 있다면 다음을 확인하세요.
- 데스크톱 앱을 업데이트하고 자동 검토를 사용하려는 채팅에서 권한 메뉴를 확인하세요. 로컬 환경과 클라우드 환경에서 선택할 수 있는 옵션은 다를 수 있습니다.
- Codex를 로컬에서 실행한다면 실제 적용된 구성에
features.guardian_approval = false가 명시되어 있는지 확인하고, 설정된 권한 프로필, 승인 정책, 승인 검토자를 확인하세요. 구성 우선순위는 구성 기본 사항을 참고하세요. 로컬 구성은 관리형 클라우드 런타임에 적용되지 않습니다. - 관리형 워크스페이스에서 모드가 비활성화되어 있거나 보이지 않으면 관리자에게 허용된 권한 프로필, 샌드박스 모드, 승인 정책, 승인 검토자를 확인해 달라고 요청하세요. 조직 또는 기기 정책에 따라 선택지가 제한될 수 있으며, 로컬 설정으로 이 제한을 해제할 수 없습니다.
그래도 예상과 달리 이 모드를 사용할 수 없다면 앱 버전, 운영 체제, 실행 환경과 함께 옵션이 보이지 않는지 아니면 비활성화되어 있는지 피드백에 적어 주세요.
Codex CLI에서 작동하는 기능이 ChatGPT 데스크톱 앱에서는 작동하지 않습니다
ChatGPT 데스크톱 앱과 Codex CLI에 포함된 Codex 버전이 다를 수 있어 한쪽에 기능이 먼저 제공되기도 합니다.
시스템에 설치된 Codex CLI 버전을 확인하려면 다음 명령어를 실행하세요.
codex --versionChatGPT 데스크톱 앱에 포함된 Codex 버전을 확인하려면 호환성을 위해 유지되는 Codex.app 번들 경로를 사용하세요.
/Applications/Codex.app/Contents/Resources/codex --version피드백 및 로그
메시지 입력창에 /를 입력하면 팀에 피드백을 보낼 수 있습니다. 기존 채팅에서 피드백을 작성하면 해당 세션도 함께 공유할지 선택할 수 있습니다. 피드백을 제출하면 팀과 공유할 수 있는 세션 ID를 받게 됩니다.
문제를 신고하려면 다음 단계를 따르세요.
- Codex GitHub 리포지터리에서 기존 이슈를 찾아보세요.
- 새 GitHub 이슈를 등록하세요
다음 위치에서 추가 로그를 확인할 수 있습니다.
- 앱 로그(macOS):
~/Library/Logs/com.openai.codex/YYYY/MM/DD - 세션 대화 기록:
$CODEX_HOME/sessions(기본값:~/.codex/sessions) - 보관된 세션:
$CODEX_HOME/archived_sessions(기본값:~/.codex/archived_sessions)
로그를 공유하기 전에 민감한 정보가 포함되어 있지 않은지 확인하세요.
채팅이 멈췄을 때 복구하는 방법
채팅이 멈춘 것 같으면 다음 단계를 따르세요.
- Codex가 승인을 기다리고 있는지 확인하세요.
- 터미널을 열고
git status같은 기본 명령어를 실행하세요. - 요청 범위를 좁히고 한 가지 목적에 집중한 프롬프트로 새 채팅을 시작하세요.
실수로 작업 트리 생성을 취소해 프롬프트가 사라졌다면 메시지 입력창에서 위쪽 화살표 키를 눌러 복구하세요.
터미널 문제
터미널이 멈춘 것 같습니다
- 터미널 패널을 닫으세요.
- Ctrl+`를 눌러 다시 여세요.
pwd또는git status같은 기본 명령어를 다시 실행하세요.
명령어가 예상과 다르게 작동하면 먼저 터미널에서 현재 디렉터리와 브랜치를 확인하세요.
터미널이 계속 응답하지 않으면 진행 중인 채팅이 모두 완료될 때까지 기다렸다가 앱을 다시 시작하세요.
글꼴이 제대로 표시되지 않습니다
Codex는 검토 패널, 통합 터미널, 그 밖에 앱 안에 표시되는 모든 코드에 같은 글꼴을 사용합니다. 설정 패널의 코드 글꼴 항목에서 글꼴을 변경할 수 있습니다.
환경에서 네트워크 액세스를 허용하는데도 동작이 차단됩니다
개별 설정을 비교하기 전에 정책 우선순위를 확인하세요. 우선순위가 낮은 정책이 더 구체적이어도 우선순위가 높은 정책이 적용됩니다. 한 정책 안에서는 특정 운영 체제에 대한 환경 재정의 설정이 가장 우선합니다. 그다음은 모든 운영 체제에 공통인 환경 재정의 설정, 전역 설정 순입니다.
일부 네트워크 요구 사항에는 필드별 병합 규칙과 런타임 제한이 있습니다. 클라우드 런타임은 관리형 HTTP/SOCKS 리스너 포트와 루프백 이외의 주소에서 수신하는 프록시 리스너를 지원하지 않습니다. 소켓 규칙 지원 여부는 실행 경로에 따라 다릅니다. 로컬 실행 시에는 별도의 병합 규칙이 적용됩니다.
실제 적용된 정책을 비교하고, 허용하려는 동작과 차단하려는 동작을 각각 테스트하세요. 구체적인 사례는 관리형 구성을 참고하세요. 테스트 실패를 우회하려고 전역 기본 정책의 허용 범위를 넓히지 마세요.