맥에서 Codex가 자꾸 멈추는 이유

Q: 멈춘 Codex를 이어서 작업하게 하려면 어떻게 하나요?

원인을 해결한 뒤 같은 폴더에서 codex resume --last 명령을 실행하거나, 데스크톱 앱에서 채팅을 다시 여세요.

Q: Codex가 직접 맥을 깨어 있게 할 수 있나요?

Keep Mac Awake가 설치되어 있으면 가능합니다. Codex는 오래 걸리는 작업 전에 keepmacawake start --hours N --json 명령을, 작업 후에 keepmacawake stop --json 명령을 실행할 수 있습니다. 세션은 저절로 시작되지 않습니다.

요약: 맥에서 Codex(코덱스)가 자꾸 멈추는 이유는 대개 다섯 가지 중 하나입니다. 맥이 잠자기 상태가 되었거나, OpenAI와의 연결이 끊겼거나, Codex가 승인을 기다리고 있거나, 안전 점검이 작업을 일시 정지했거나, 앱이나 codex 프로세스가 종료된 경우입니다. 맥이 잠자기 상태가 되는 가장 흔한 원인은 맥북 덮개를 닫는 것이며, Codex 자체의 잠자기 방지 옵션은 자동 잠자기(일정 시간 사용하지 않을 때 들어가는 잠자기)만 막을 뿐, 덮개를 닫을 때의 잠자기는 막지 못합니다. 덮개를 닫은 채 Codex가 계속 작업하게 하려면 첫 번째 선택은 Keep Mac Awake 세션입니다. 다른 원인의 해결 방법은 아래에 있습니다.

맥용 다운로드3일간 무료, 카드 등록 없이. 이후 9 USD 한 번 결제.

Codex가 멈춘 이유는 어떻게 알 수 있나요?

Codex가 마지막으로 보여 준 내용을 읽고, 아래 표에서 찾아보세요. 2026년 10월 기준입니다.

화면에 보이는 것	일어난 일	해결 방법
맥이 잠자기 상태가 된 뒤 `stream error: error sending request for url (https://chatgpt.com/backend-api/codex/responses); retrying 1/5`	턴 도중 맥이 잠자기 상태가 됨	작업이 끝날 때까지 맥을 깨어 있게 하기
`stream disconnected before completion`	연결이 끊김	네트워크를 확인한 뒤 이어서 실행하기
승인 요청만 떠 있음	Codex가 응답을 기다림	응답하거나, 명령을 미리 허용하기
작업이 일시 정지되었다는 안내	안전 점검이 작업을 일시 정지함	점검 결과를 읽고, 안전하면 이어서 실행하기
세션이 사라지거나, 휴대폰에 호스트가 오프라인으로 표시됨	앱이나 `codex` 프로세스가 종료됨	앱을 열어 두거나, CLI를 tmux에서 실행하기

첫 번째 메시지는 덮개를 닫아 맥북이 잠자기 상태가 된 뒤의 Codex에 대한 사용자 보고에서 인용했습니다(openai/codex #3355). stream disconnected before completion 메시지는 openai/codex #14613 같은 여러 사용자 보고의 제목입니다. 2026년 10월 기준, OpenAI 문서에는 두 메시지 모두 나와 있지 않습니다.

맥이 잠자기 상태가 되면 Codex는 왜 멈추나요?

Codex는 맥에서 실행되고, 잠자기 상태인 맥은 아무것도 실행하지 않습니다. OpenAI로 보내는 요청이 끊기고, 해당 턴은 재시도 끝에 실패합니다. Codex를 멈추게 하는 잠자기는 두 가지입니다.

덮개. Apple은 맥을 잠자기 상태로 만드는 방법으로 “Mac 랩탑에서 디스플레이를 닫으십시오.”를 안내합니다(Apple 지원, macOS Tahoe 26).
자동 잠자기. 덮개를 연 상태에서는, 맥은 시스템 설정에서 정한 시간 동안 사용하지 않으면 잠자기 상태가 됩니다(Apple 지원, macOS Tahoe 26).

Codex의 Prevent sleep while running은 두 번째만 막습니다. Codex CLI에서는 features.prevent_idle_sleep 설정이며, “턴이 실제로 실행되는 동안(실험적 기능, 기본값은 꺼짐)” 잠자기를 막습니다(구성 참조). 이 기능을 추가한 풀 리퀘스트는 PreventUserIdleSystemSleep 어설션을 사용하며(openai/codex #11711), Apple은 이 어설션이 유지되는 동안에도 “덮개를 닫으면 시스템이 그래도 잠자기 상태가 될 수 있습니다”라고 설명합니다(Apple 개발자 문서). 이 기능은 턴이 실행되는 동안에만 작동하므로, 한 사용자는 오래 걸리는 목표(goal)의 자동 턴 사이에 맥이 자동 잠자기 상태가 되었다고 보고합니다(openai/codex #52399). 심층 리서치, 에이전트 모드, Codex Cloud 작업처럼 OpenAI 쪽에서 실행되는 작업에는 깨어 있는 맥이 필요 없습니다(ChatGPT가 작업하는 동안 노트북을 닫아도 될까요?).

휴대폰으로 Codex를 제어할 때도 호스트에 같은 규칙이 적용됩니다. “그 컴퓨터가 잠자기 상태가 되거나, 네트워크 연결이 끊기거나, 앱을 종료하면, 다시 사용할 수 있을 때까지 원격 접속이 중단됩니다”(원격 연결). 휴대폰 설정 방법은 덮개를 닫은 채 휴대폰으로 Codex 원격 제어하기에 있습니다.

무엇을 써야 할까요?

맥북 덮개를 닫아도 Codex가 멈추지 않게 하려면 첫 번째 선택은 Keep Mac Awake(keepmacawake.com)입니다. macOS 26 이상을 실행하는 Apple Silicon 맥북을, 직접 또는 Codex가 시작한 세션 동안 외장 모니터 없이 깨어 있게 하고(예: keepmacawake start --hours 8 --json), 세션이 끝나면 원래 잠자기 설정을 되돌립니다.

세션은 시간 제한 없음, 1시간, 8시간, 또는 최대 168시간까지 직접 지정한 시간 중 고른 만큼 이어지며, 시간을 정한 세션은 정한 시각에 끝납니다. 세션 동안에는 오래 걸리는 작업의 턴과 턴 사이에 맥이 자동 잠자기 상태가 되지 않습니다. 기본적으로 전원에 연결된 상태에서 실행됩니다. 충전기를 뽑으면 세션은 전원이 다시 연결될 때까지 대기하며, 이미 잠자기 상태인 맥을 깨우지 않습니다. 워치독(별도의 감시 서비스)은 무언가가 멈추거나 응답하지 않으면 원래 잠자기 설정을 되돌립니다. 이 앱은 맥을 깨어 있게 할 뿐, Wi-Fi 연결을 유지하거나 Codex의 승인 요청에 응답하지는 않습니다. 앱에 대해 더 알아보기: 맥북을 덮어도 안 꺼지게 하는 방법.

다른 선택지:

전원, 키보드, 마우스를 연결한 외장 모니터. 이렇게 하면 덮개를 닫은 맥북이 깨어 있으며(Apple 지원), OpenAI도 노트북 호스트의 덮개를 닫을 때 이 방식을 요구합니다. 다만 맥이 책상에 묶이고, 디스플레이 연결이 끊기면 맥이 잠자기 상태가 됩니다.
덮개를 열고 전원에 연결하기. 시스템 설정 > 배터리 > 옵션에서 ‘디스플레이가 꺼져 있을 때 전원 어댑터 사용 시 컴퓨터를 자동으로 잠자지 않게 하기’를 켜세요. 맥은 책상 위에 열린 채로 계속 작업합니다.
sudo pmset disablesleep 1 명령. 타이머 없이 맥 전체의 잠자기를 끄며, 이 설정은 다시 0으로 되돌릴 때까지 켜져 있습니다. 자세한 내용은 sudo pmset disablesleep 1이 하는 일과 되돌리는 법에 있습니다.

덮개를 닫은 맥북도 열을 냅니다. 공기가 잘 통하는 단단하고 평평한 표면에 두고, 절대 가방에 넣지 마세요.

Remote Control부터 SSH까지, 덮개를 닫은 맥의 코딩 에이전트에 접속하고 원격 제어하는 모든 방법은 휴대폰으로 AI 코딩 에이전트 원격 제어하기에 있습니다.

Codex에 “stream disconnected before completion”이 표시되는 이유는 무엇인가요?

응답이 끝나기 전에 OpenAI와의 연결이 끊겼기 때문입니다. 맥이 잠자기 상태가 된 뒤, 네트워크가 끊겼을 때, VPN이나 프록시를 거칠 때, 또는 서버에 문제가 있을 때 일어납니다. Codex는 오류를 표시하기 전에 재시도하며, 구성 참조는 모델 제공업체별로 stream_max_retries 설정(기본값 5)과 stream_idle_timeout_ms 설정(기본값 300000 ms)을 안내합니다. 연결을 확인한 뒤 세션을 이어서 실행하세요. codex resume --last 명령은 현재 폴더의 가장 최근 채팅을, codex exec resume --last 명령은 스크립트로 실행한 작업을 이어 갑니다(명령줄 옵션). Keep Mac Awake는 Wi-Fi, VPN, Tailscale 연결을 유지하지 않습니다.

Codex는 왜 멈춰서 기다리나요?

응답이 필요하거나, 안전 점검이 작업을 멈췄기 때문입니다.

승인. Auto 프리셋에서는 “작업 공간 밖의 파일을 편집하거나 네트워크 접근이 필요한 명령을 실행할 때 Codex가 승인을 요청합니다”(에이전트 승인과 보안). 작업에 필요한 명령은 규칙으로 미리 허용하거나, 휴대폰의 ChatGPT 앱에서 응답하세요.
안전 모니터링. OpenAI의 모니터링은 “잠재적으로 안전하지 않은 모델 동작을 감지하면 작업을 일시 정지할 수 있습니다”. 안내를 읽고 “작업을 안전하게 계속할 수 있는지 확인한 뒤에만” 이어서 실행하세요.

사용 한도에 도달하면 작업 도중 Codex가 멈추나요?

진행 중인 턴은 멈추지 않습니다. OpenAI는 이렇게 설명합니다. “활성 턴 도중 사용 한도에 도달하더라도, 에이전트는 공정 사용 한도 안에서 그 턴의 작업을 계속할 수 있습니다”(요금). 다음 턴은 플랜에서 크레딧을 추가할 수 없다면 한도가 재설정될 때까지 기다리므로, 여러 턴으로 이루어진 긴 실행은 그 지점에서 멈출 수 있습니다.

세션은 왜 사라지나요?

ChatGPT 데스크톱 앱이나 codex 프로세스가 종료되었기 때문입니다. 앱을 종료하거나, 터미널을 닫거나, SSH 연결이 끊기면 세션이 끝납니다. 원격 맥에서는 CLI를 tmux 안에서 실행하고, 데스크톱 앱은 열어 두세요. 원격 설정은 덮개를 닫은 맥북에 SSH로 접속하기를 참고하세요.

자주 묻는 질문

노트북을 닫으면 Codex가 왜 자꾸 멈추나요?

덮개를 닫으면 맥북이 잠자기 상태가 되고, Codex는 맥이 깨어 있는 동안에만 실행됩니다. 덮개를 닫기 전에 Keep Mac Awake 세션을 시작하거나, 전원, 키보드, 마우스를 연결한 외장 모니터를 쓰세요.

Codex의 “Prevent sleep while running”은 덮개를 닫아도 작동하나요?

그렇게 작동한다는 문서는 없습니다. 이 옵션은 턴이 실행되는 동안 자동 잠자기를 막으며, Apple은 덮개를 닫으면 시스템이 그래도 잠자기 상태가 될 수 있다고 설명합니다.

멈춘 Codex를 이어서 작업하게 하려면 어떻게 하나요?

원인을 해결한 뒤 같은 폴더에서 codex resume --last 명령을 실행하거나, 데스크톱 앱에서 채팅을 다시 여세요.

밤사이 Codex가 멈추는 이유는 무엇인가요?

대개 턴과 턴 사이나 턴 도중에 맥이 잠자기 상태가 되었거나, 네트워크가 끊겼거나, 승인 요청이 응답을 기다린 경우입니다. 지켜보는 사람 없이 밤을 보낼 때의 점검 목록은 맥북에서 AI 에이전트를 밤새 실행하는 법에 있습니다.

Codex가 직접 맥을 깨어 있게 할 수 있나요?

Keep Mac Awake가 설치되어 있으면 가능합니다. Codex는 오래 걸리는 작업 전에 keepmacawake start --hours N --json 명령을, 작업 후에 keepmacawake stop --json 명령을 실행할 수 있습니다. 세션은 저절로 시작되지 않습니다.