Codex CLI가 몰래 상주|종료 방법과 자동 업데이트 주의사항
機械翻訳 / Machine-translated

機械翻訳 / Machine-translated
@aifriends
AI Friends(https://aifriends.jp)のクロスポスト公式アカウント。AIツールの紹介・使い方・できることを、中学生でもわかるやさしい日本語で届けます。
닫았을 터미널에서 AI 프로그램이 아직 실행 중이라면 꺼림칙하겠죠. OpenAI의 코딩 도구 「Codex CLI」에서 바로 그런 상황이 보고되고 있습니다. 이 글에서는 무슨 일이 일어나고 있는지와 종료 방법을 정리합니다.
터미널에서 동작하는 AI 코딩 도우미인 Codex CLI의 새 버전에서, 백그라운드 상주 프로그램이 기본으로 실행되도록 바뀌었습니다.
상주 프로그램은 「데몬(daemon)」이라고 불립니다. 화면에는 나타나지 않고 뒤에서 계속 실행되는 프로그램입니다.
이 주제는 GIGAZINE이 2026년 10월 15일에 보도했습니다. 개발자들 사이에서 논의가 확산되고 있습니다.
발단은 GitHub에 올라온 제안이었습니다. 내용은 기본값을 오프(off)로 하고, 사용하고 싶은 사람만 온(on)으로 설정하는 형태로 바꿔달라는 것이었습니다.
대상은 버전 0.157.0 이후입니다. 2026년 9월 25일에 공개되었습니다.
이전 버전인 0.156.0에서는 이 기능이 원하는 사람만 사용하는 옵션이었다고, 해설 블로그의 Daniel Vaughan 씨 글은 전하고 있습니다. 0.157.0에서 기본 동작이 되었습니다.
설정 이름은 daemon_auto_start입니다. 대화형 세션을 열면, 조건이 맞을 경우 백그라운드 서버가 자동으로 시작됩니다.
GitHub의 issue #48195를 작성한 사용자는 다음과 같이 보고하고 있습니다.
홈 폴더의 ~/.codex 아래에 약 374MB의 플랫폼 패키지가 저장됩니다.
그 복사본으로부터 codex app-server --managed-daemon이라는 프로세스가 실행됩니다. 터미널을 닫아도 종료되지 않습니다.
또한, 업데이트를 확인하는 별도의 프로세스가 실행됩니다. 시작 5분 후에 한 번, 그 이후에는 1시간마다 실행됩니다. 새 버전이 있으면 받아서 백그라운드 서버를 재시작합니다.
즉, npm 등으로 설치한 CLI 본체와는 별도로, 또 하나의 Codex가 스스로 업데이트를 계속하는 형태입니다. 따라서 양쪽의 버전이 어긋나는 경우가 생깁니다.
우선, 업데이트 재시작으로 작업 중인 대화가 중단되는 경우가 있습니다.
관련 issue #40969(2026년 8월 26일)에서는, 원격 조작용 호스트에서 업데이트가 실행되면 종료 신호를 보내고 60초 대기하며, 그래도 끝나지 않으면 강제 종료한다는 보고가 있습니다.
다음으로, 환경 변수가 고정됩니다. 예를 들어 어느 날 세션에서 설정한 프록시가 다음 날 세션에도 남아 있게 됩니다.
그리고 daemon stop으로 종료해도 업데이트 확인 프로세스가 남는 버그도 보고되고 있습니다.
상상해 보세요. 회사 VPN을 전환했는데, Codex만 이전 프록시에 연결하려다 실패하는 상황입니다. 원인이 백그라운드 프로세스임을 알아차리기까지 상당히 먼 길을 돌아가게 됩니다.
이 문제는 해외 IT 뉴스 게시판인 Hacker News에서 292개의 댓글과 599포인트를 모은 것으로 알려져 있습니다.
댓글에서는 불만의 목소리가 두드러졌습니다.
반면 다른 댓글에서는 「Claude Code에서도 오래된 버전이나 백그라운드 프로세스가 남는다」고 지적했습니다. Codex만의 문제가 아닐 수 있다는 시각입니다.
OpenAI의 공식 설명은 기사 작성 시점에서 확인되지 않았습니다. issue 내 대화에서도 메인테이너의 답변은 찾을 수 없었습니다.
공식 설정 레퍼런스에 daemon_auto_start가 기재되어 있지 않다는 지적도 있습니다. 0.157.0의 릴리스 노트도 한 문장으로만 언급했다고 합니다.
한편, GIGAZINE에 따르면 커밋 로그에는 「기본적으로 자동 시작하지 않도록」 하는 변경이 발견되어, 대응이 진행 중일 가능성이 있습니다. 다만, 수정이 공개된 것은 확인되지 않았습니다.
공식적인 비활성화 방법은 찾을 수 없습니다. 다만, 설정 플래그로 종료할 수 있다는 보고가 여러 건 있습니다.
가장 간단한 방법은 설정 파일 ~/.codex/config.toml에 다음 두 줄을 추가하는 것입니다.
[features]
daemon_auto_start = false
issue 작성자가 쓴 절차는 명령어로 순서대로 처리하는 방식입니다.
codex features disable daemon_auto_start
codex app-server daemon stop
pkill -f 'app-server daemon pid-update-loop'
rm -rf ~/.codex/packages/app-server-daemon
첫 번째 줄에서 기능을 끄고, 두 번째 줄에서 실행 중인 상주 프로그램을 종료합니다. 세 번째 줄은 종료되지 않고 남아 있는 업데이트 확인 프로세스를 끝냅니다. 네 번째 줄은 저장된 패키지를 삭제하는 명령어입니다.
이 절차는 DevelopersDigest도 소개하고 있습니다. 다만, 필자 본인은 재현하지 않았다고 밝히고 있습니다.
주의사항이 두 가지 있습니다. 설정 이름은 정보 출처에 따라 표기가 다릅니다. Vaughan 씨의 글에서는 다른 표기를 제시하고 있으므로, 사용 중인 버전에서 확인하세요.
또한, rm -rf는 삭제 위치를 잘못 지정하면 위험합니다. 실행 전에 경로를 반드시 확인하세요.
종료 후에는 Codex를 새로 시작해서 ps로 확인합니다. app-server 프로세스가 나오지 않으면 성공입니다.
AI 코딩 도구의 업데이트 방식은 크게 세 가지로 나눌 수 있습니다.
Hacker News 댓글에서 한 개발자는 「상주 방식이 아니라, 시작 시 확인하는 방식으로 했다」고 썼습니다. 백신 소프트웨어에 탐지되기 쉽다는 사정도 있다고 합니다.
상주 방식에도 장점은 있습니다. Vaughan 씨의 글에 따르면, 시작이 빨라지고, 터미널을 닫아도 작업을 계속할 수 있으며, 여러 탭에서 같은 서버를 공유할 수 있습니다.
즉, 편의성과 맞바꾸는 형태로 사용자가 보이지 않는 곳에서 동작한다는 점이 문제시되고 있습니다.
특히, nix나 Homebrew처럼 「버전을 고정하고 싶은」 운용을 하는 사람에게는 불편합니다. 백그라운드의 자기 업데이트가 고정된 버전을 우회하기 때문입니다.
한국 개발자에게도 남의 일이 아닙니다. 영향을 받기 쉬운 상황을 세 가지 들어보겠습니다.
첫 번째는, 사내 네트워크에서 일하는 엔지니어입니다. 프록시 설정을 날마다 전환하는 사람은 오래된 설정이 남는 불편에 빠지기 쉬워집니다.
두 번째는, 정보시스템 부서입니다. 허가하지 않은 프로그램이 상주하며 1시간마다 외부와 통신하면, 감사에서 설명을 요구받을 수 있습니다.
세 번째는, 회사 PC로 작업하는 프리랜서입니다. 디스크 여유 공간이 적은 노트북에서는 374MB 저장에 더해 오래된 버전이 쌓이면, 모르는 사이에 여유 공간이 줄어들게 됩니다.
대책은 간단합니다. 팀에서 사용하는 경우, 설정 파일 배포나 사내 절차서에 daemon_auto_start = false를 추가해 두면 안심할 수 있습니다.
OpenAI가 의도적으로 넣은 기본 기능으로 여겨집니다. 0.157.0의 릴리스 노트에도 백그라운드 서버의 자동 시작을 언급한 문장이 있다고 합니다. 다만, 설명 부족에 대한 불만이 크고, 「악성코드 같다」는 비판도 나왔습니다.
대상은 0.157.0 이후의 대화형 세션입니다. 명령을 한 번만 실행하는 codex exec는 영향을 받지 않는다고 알려져 있습니다.
보고에 따르면, 새 세션이 백그라운드 서버를 시작하지 않게 될 뿐입니다. issue 작성자는 이 설정으로 새 화면에서 상주 프로그램이 나타나지 않게 되었다고 썼습니다.
현시점에서 공식 발표는 확인되지 않았습니다. issue #48195는 기사 작성 시점에서 열린 상태입니다. 업데이트 정보는 GitHub의 릴리스 노트에서 확인하세요.
우선 터미널에서 ps를 실행해, 자신의 환경에 app-server가 남아 있지 않은지 확인해 보세요.
이 글은 AI Friends에서의 크로스포스트입니다.