Codex remote-control이 socket parent 권한 오류로 멈출 때

Linux에서 codex remote-control이 시작 직후 socket parent must be owned by the user or root 오류로 끝나면, 재설치나 인증보다 현재 umask를 먼저 확인하세요. umask 0002라면 전역 설정을 바꾸지 않고 해당 명령에만 077을 적용해 한 번 대조할 수 있습니다.

여러 사용자가 접근 가능한 소켓 폴더와 한 사용자만 접근하는 보호 폴더를 비교한 개념도

먼저 오류 단계와 umask를 확인합니다

터미널에서 아래 두 명령을 실행합니다.

codex --version
umask

공개 보고에서 문제가 확인된 조합은 Linux의 Codex CLI 0.156.1과 umask 0002였다. 오류는 로그인이나 원격 연결 뒤가 아니라, remote-control용 app-server가 제어 소켓을 준비하는 단계에서 발생했다. 공개 이슈 #47844는 같은 환경의 실패와 077 성공을 함께 기록했다.

오류에 다음 문구가 있는지도 확인합니다.

socket parent must be owned by the user or root and prevent other users from replacing socket entries

이 문구가 없다면 같은 해결책을 복사하지 마세요. 인증 실패, 네트워크 연결 실패, 명령 미지원은 다른 문제입니다.

특히 macOS의 원격 SSH 연결에서 chmod --가 실패하는 사례와 Windows의 소켓 ACL 오류는 겉으로 비슷해도 이 글의 Linux umask 0002 조건과 다릅니다. OS와 정확한 마지막 오류 문구가 다르면 아래 077 대조를 보편 해결책으로 적용하지 않습니다.

전역 설정 대신 한 명령에만 077을 적용합니다

진행 중인 Codex 작업을 먼저 마친 뒤 다음처럼 서브셸에서 실행합니다.

(
  umask 077
  codex remote-control
)

괄호 안에서 바꾼 umask는 그 서브셸에만 적용됩니다. 원래 셸의 기본값을 영구 변경하지 않습니다. 공개 Linux 재현에서는 umask 0002일 때 실패했고 이 방식에서는 remote-control이 시작됐습니다.

실행이 성공하면 터미널에 이 기기가 원격 제어에 사용 가능하다는 안내와 종료 방법이 나타나는지 확인합니다. 원격 제어가 필요 없거나 어떤 계정과 연결되는지 모른다면 시작하지 말고 중단하세요.

왜 0002와 077의 결과가 다른가요?

umask는 새 파일과 디렉터리에서 제거할 권한을 정합니다. 이번 Mac의 비민감 임시 폴더에서 같은 디렉터리 생성을 대조했을 때 결과는 다음과 같았습니다.

실행 조건 생성된 디렉터리 모드
umask 0002 775 (drwxrwxr-x)
umask 0077 700 (drwx------)

775에는 그룹 쓰기 권한이 있고 700은 현재 사용자만 접근할 수 있습니다. 공개 Linux 보고의 Codex 0.156.1은 제어 소켓 부모가 group/other writable이면 안전하지 않다고 거절했습니다.

다만 이 Mac 대조는 umask의 일반적인 권한 차이만 확인한 것입니다. Linux에서 발생한 Codex 오류 자체를 macOS에서 재현했다는 뜻은 아닙니다.

하지 말아야 할 조치

  • 소켓 오류를 없애려고 폴더에 chmod 777을 적용하지 않습니다.
  • 시스템 전체의 기본 umask를 바로 바꾸지 않습니다.
  • 원인을 확인하지 않은 채 다른 사용자가 소유한 소켓이나 폴더를 삭제하지 않습니다.
  • remote-control이 만드는 기기 연결을 이해하지 못한 상태에서 장시간 켜 두지 않습니다.

077 대조에서도 같은 오류가 나면 명령 전체와 버전, OS, umask 결과를 보존하세요. 이 경우는 공개 보고와 조건이 다르거나 다른 부모 경로가 선택된 것일 수 있습니다.

원격 주소가 invalid remote address로 거절된다면 소켓 부모 권한 문제가 아닙니다. wss 주소 경로를 연결 전에 구분하는 순서로 분리하세요. 수정 전후를 비교할 때는 같은 입력과 검사 명령을 고정하는 방법처럼 OS·버전·오류 문구를 고정하고 umask만 바꿉니다.

자주 묻는 질문

umask 077을 영구 설정해야 하나요?

아닙니다. 먼저 괄호로 감싼 한 번의 실행에서만 대조하세요. 영구 변경은 다른 프로그램이 만드는 파일 권한에도 영향을 줄 수 있습니다.

macOS에서도 같은 오류가 나나요?

이번 조사에서는 macOS의 Codex CLI 0.156.1에서 명령 도움말과 umask별 디렉터리 모드만 확인했습니다. Linux remote-control 오류는 직접 재현하지 않았으므로 같은 버그라고 단정할 수 없습니다.

공식 문서에 이 오류 해결법이 있나요?

2026년 9월 25일 확인한 OpenAI 공식 문서에서는 이 특정 umask 0002 오류를 설명하는 절을 찾지 못했습니다. 따라서 오류와 workaround 성공은 공개 Linux 재현의 범위로 표시하고, 공식 Remote 소개는 기능 범위 확인에만 사용합니다.

정리

  • 정확한 오류 문구, Codex 버전, umask를 먼저 확인합니다.
  • 공개 Linux CLI 0.156.1 사례는 0002에서 실패하고 서브셸 077에서 성공했습니다.
  • 전역 umask나 폴더 권한을 넓히지 말고 한 명령에만 좁혀 대조합니다.
  • 현재 Mac에서는 권한 모드 차이만 확인했으며 Linux 제품 오류는 미재현입니다.

확인 환경: 공개 보고는 Linux·Codex CLI 0.156.1, 로컬 대조는 macOS arm64·Codex CLI 0.156.1입니다. 정확 검색량과 현재 버전의 모든 Linux 배포판 동작은 미확인입니다.

검증 기준

  • 마지막 업데이트일: 2026-09-25
  • 확인 환경: 공개 Linux·Codex CLI 0.156.1 재현, macOS arm64·Codex CLI 0.156.1 권한 모드 정상 대조
  • 미확인: Linux 제품 오류의 독립 직접 재현, 후속 버전 수정 여부, 정확 월간 검색량
  • 주요 근거: 공개 재현 이슈 #47844, OpenAI Codex Remote 공식 소개

직접 만든 실습 자료와 새 도구 소식

AI 도구로 만든 실습 자료, 달라진 기능과 강의 소식을 준비하고 있습니다. 발송을 시작하면 안내해 드려요. 먼저 확인 메일에서 본인 이메일을 확인해 주세요.

신청하기 전에 첫 소식 미리보기에서 내용과 자료를 확인해 보세요.

질문이나 의견을 남겨주세요

이름을 입력하지 않아도 돼요. ‘깜짝 놀란 올빼미’ 같은 별명이 자동으로 붙어요.