코덱스 까만창 에러,
유형별로 직접 고치기

한 줄 요약

까만창 에러는 종류가 여섯 가지뿐이고, 어느 종류인지는 에러 메시지의 "마지막 구체적인 한 줄"이 알려줍니다.

앱이 보여주는 "Codex CLI 실행환경, 로그인 상태, 모델 설정을 확인해 주세요"는 모든 실패에 똑같이 붙는 공통 안내문이에요. 이 문장만 보고 "로그인 문제구나" 하고 재로그인부터 하면 열에 아홉은 헛수고입니다. 그 문장 아래나 위에 있는 구체적인 영어·숫자 한 줄이 진짜 원인이에요.

0. 에러가 나면 제일 먼저 — 3분 (유형 상관없이 공통)

• 자동 작업을 멈춥니다. 앱의 자동 실행(60분 주기 등)이 켜져 있으면 끕니다. 같은 실패를 계속 반복하면 사용량만 소모돼요.
• 마지막 구체적인 문구를 메모합니다. "실패했습니다"가 아니라 그 아래 영어·숫자 줄입니다. 폰으로 화면을 찍어도 됩니다. (단, 글 본문·이메일·내 PC 사용자 이름이 찍히면 가리고 보내세요)
• 이미 발행됐는지 블로그를 확인합니다. "발행" 단계에서 실패한 것처럼 보여도 글이 올라가 있을 수 있어요. 확인 없이 다시 발행 버튼을 누르면 같은 글이 두 번 올라갑니다.

비유로 말하면, 앱은 사장님이고 코덱스(까만창)는 조사·집필을 맡은 직원이에요. 직원이 일을 못 하는 이유는 "출근을 못 함(실행 파일)", "사원증이 없음(인증)", "그 업무 권한이 없음(모델)", "오늘 할당량을 다 씀(사용량)", "보고서를 안 냄(결과 파일)", "보고서 내용이 부실함(글 품질)" 여섯 가지 중 하나예요. 사원증 문제인데 출근길을 고치면 소용없죠. 그래서 유형부터 가려야 합니다.

1. 내 에러는 어느 유형? — 문구로 찾기

화면이나 로그에 보이는 말을 아래에서 찾으세요. 왼쪽 문구가 보이면 오른쪽 장으로 바로 가면 됩니다.

가장 흔한 것은 3-C 모델 미지원이에요. 보존된 실패 기록 16건 중 13건이 이거였어요. 실행 파일 없음은 1건, 혼잡 1건, DLL 1건이었습니다. (이 비율은 수집된 기록 기준이고, 모든 수강생 PC가 똑같다는 뜻은 아닙니다)

2. 공통 도구 — PowerShell로 3가지 확인하기 (5분)

유형 A·B·F·G에서 공통으로 쓰는 확인법이에요. 한 번 익혀 두면 됩니다.

2-1. PowerShell 열기

• Windows 시작 메뉴에서 PowerShell을 검색해 일반 사용자로 엽니다. (관리자 권한 아님)
• 아래 명령은 한 줄씩 붙여넣고 Enter. 코드 상자의 테두리나 설명은 입력하지 않습니다.

2-2. 윈도우가 아는 코덱스 위치 보기

Get-Command codex -All | Select-Object CommandType, Source

• 실행했더니 경로가 한 줄 이상 나온다 → 그 경로를 메모합니다.
• "찾을 수 없다"고 나온다 → 코덱스가 아예 없다는 뜻은 아닙니다. 윈도우의 검색 목록(PATH)에만 안 올라간 경우가 흔해요. 다음 단계로 갑니다.

주의: 여기서 찾은 코덱스와 앱이 실제로 쓰는 코덱스는 다를 수 있어요. 데스크톱 앱과 따로 설치한 CLI의 버전이 다를 수 있습니다. 앱 에러에 표시된 경로가 있으면 그게 기준입니다.

2-3. "그 파일"이 켜지는지 확인

실제경로 자리에 앱이 쓰는 codex.exe의 전체 경로를 넣습니다. 맨 앞 &와 따옴표는 그대로 둡니다.

& 'C:\실제경로\codex.exe' --version

• 버전 번호가 나온다 → 파일을 켜는 단계는 통과. 다음 명령으로.
• 에러가 난다 → 로그인보다 실행 파일 문제가 먼저입니다. 3-A 또는 3-B로.

2-4. 로그인 상태 확인

& 'C:\실제경로\codex.exe' login status

• 로그인돼 있다고 나온다 → 인증은 통과. 그래도 특정 모델을 쓸 수 있다는 보장은 아니에요(3-C).
• 로그인 안 됐다고 나온다 → 3-F로.

경로를 모르면 강사에게 물어보세요. 다른 설치본에서 버전이 잘 나왔다고 앱 문제가 풀린 건 아닙니다.

3. 유형별 핸즈온

각 유형은 증상 → 쉬운 뜻 → 내가 할 것 → 됐는지 확인 → 하지 말 것 → 강사에게 보낼 것 순서예요.

3-A. "Codex 실행 파일이 없습니다"

증상: 실행 파일이 없습니다 / 찾을 수 없습니다 / ENOENT

쉬운 뜻: 앱이 적어 둔 주소에 가 봤더니 코덱스 파일이 없어요. 데스크톱 앱 설치 위치가 바뀌었거나, 예전 경로가 설정에 그대로 남아 있을 때 생깁니다. 지금 소스는 %LOCALAPPDATA%\OpenAI\Codex\bin을 찾지만, 실제 설치 사례는 %LOCALAPPDATA%\Programs\OpenAI\Codex\bin\codex.exe였어요. 두 주소가 다르죠.

내가 할 것:

• 자동 작업 중지. 앱 상단에 표시된 runtime 위치를 메모하고 앱을 완전히 종료.
• 2장 방법으로 실제 codex.exe 위치를 찾고 --version이 나오는지 확인. (위 두 주소는 후보일 뿐, 내 PC에 꼭 있다고 가정하지 않기)
• 4장 절차대로 user-settings.json을 백업.
• 설정 파일의 codexCmdPath 값만 확인된 전체 경로로 변경. 편집이 어려우면 강사와 함께.
• 앱을 다시 열어 바뀐 경로를 쓰는지 확인.

3-B. "종료 코드 3221225794" / "0xC0000142"

증상: 3221225794, 0xC0000142, -1073741502 중 하나. 셋은 같은 값을 다르게 표시한 것입니다.

쉬운 뜻: 윈도우가 프로그램에 필요한 부품 파일(DLL)을 초기화하지 못했어요. 어떤 부품인지, 설치 손상인지, 백신 영향인지는 아직 모릅니다. 옆에 모델 이름이 찍혀 있어도 모델 문제가 아니에요.

내가 할 것:

• 2-3 방법으로 앱과 같은 윈도우 사용자로 같은 codex.exe --version 실행.
• 여기서도 같은 코드가 나오면 "AI 요청 전의 실행환경 문제"로 범위 확정.
• 작업 저장 후 PC 재시작, 같은 파일 다시 확인. (재시작은 첫 시도일 뿐 보장은 아님)
• 반복되면 시작 메뉴 → 이벤트 뷰어 → Windows 로그 → 응용 프로그램에서 그 시각 근처의 Application Error 또는 Windows Error Reporting 찾기. 없을 수도 있어요.
• 거기 적힌 오류 응용 프로그램 이름 / 오류 모듈 이름 / 예외 코드 세 가지를 메모.

3-C. "이 모델은 ChatGPT 계정에서 지원되지 않습니다" ← 가장 흔함

증상: model is not supported … ChatGPT account

쉬운 뜻: 로그인은 돼 있어요. 그런데 앱이 고른 AI 모델을 내 계정으로는 쓸 수 없다는 응답이에요. 사원증은 있는데 그 업무 권한이 없는 상태. 과거 기록엔 gpt-6-sol, gpt-6.1-sol, gpt-6-luna가 거절된 적이 있는데, 그건 그 시점·그 계정 이야기이고 지금 모든 계정이 그렇다는 뜻은 아닙니다.

내가 할 것:

• 에러에 적힌 모델 이름을 메모.
• 앱 상단 Codex Model에서 다른 모델을 직접 골라 설정 저장. 내 계정이 쓸 수 있고 앱 목록에도 있는 모델이어야 해요.
• Codex 기본값은 "앱이 검증한 안전한 모델"이 아닙니다. 앱이 모델 지정을 생략하고 CLI 숨은 설정을 따르는 선택이라, 그 숨은 설정이 미지원 모델이면 계속 실패해요. 기본값으로 돌아가는 건 해결이 아닙니다.
• 어떤 모델이 되는지 모르겠으면 강사와 함께 같은 CLI를 대화형으로 열어 /model 목록 확인. 그 목록이 내 계정에서 쓸 수 있는 모델이에요(앱 목록과는 다름).
• 계정 목록과 앱 목록에 겹치는 모델이 없으면 설정 파일에 임의 이름을 넣지 말고 강사에게 앱 호환성 확인 요청.

3-D. "Selected model is at capacity" — 창구 혼잡

증상: Selected model is at capacity

쉬운 뜻: 서버가 "그 모델은 지금 줄이 너무 길다"고 답한 거예요. 파일 없음도, 모델 미지원도, 내 사용량 소진도 아닙니다.

내가 할 것:

• 자동 반복 실행 중지.
• 잠시 후 다시 시도. 정해진 복구 시각은 알 수 없어요.
• 계속되면 앱에서 내 계정이 쓸 수 있는 다른 모델로 바꿔서 시도.
• 재시도 전에 이전 글이 이미 발행됐는지 확인(0장).

3-E. "사용량 한도에 도달했습니다"

증상: usage limit / usage_limit_reached / 한도

쉬운 뜻: 오늘(또는 이번 주) 쓸 수 있는 양을 다 썼다는 신호예요. 할당량 문제라서 앱 재설치나 네이버 재로그인으로는 절대 초기화되지 않습니다.

내가 할 것:

• 자동 실행 중지.
• 에러에 적힌 제한 종류와 초기화 안내(언제 풀리는지) 확인.
• 회사 계정이라 "구성원·워크스페이스 한도"라고 나오면 관리자에게 확인.
• 초기화 시각이 지나거나 제한이 풀린 뒤 다시 시도.

주의 두 가지:

• 429라는 숫자만 있으면 "요청 빈도 제한" 같은 다른 제한일 수 있어요. 상세 응답을 같이 보세요.
• 앱의 주간 잔량이 -로 보이는 건 조회 실패일 수 있어요. 잔량 0의 증거가 아닙니다.

3-F. 진짜 로그인(인증) 오류

먼저 구분: 공통 안내문에 "로그인"이 들어 있다는 이유만으로 재로그인하지 않습니다. 2-3 버전 확인이 정상이고, 2-4 login status에서 로그인 안 됨이 확인됐을 때만 진행해요.

내가 할 것:

• 아래 명령 실행 (실제경로는 2장과 같은 파일)

& 'C:\실제경로\codex.exe' login

• 브라우저가 열리면 내가 쓸 계정으로 로그인하고, PowerShell에 완료 안내가 뜨는지 확인.
• login status를 다시 실행해 로그인됨 확인.
• 브라우저 로그인이 안 되는 환경이면 login --device-auth 방식이 있어요. 단, 내 계정·조직에서 장치 코드 로그인이 허용돼야 합니다.

3-G. "종료 코드 1" 또는 연결·서버 오류

증상: 종료 코드 1, 또는 DNS·TLS·연결 끊김·서버 응답 오류

쉬운 뜻: 1은 "정상 종료 못 했다"는 가장 일반적인 결과예요. 기록에서 모델 미지원도, 혼잡도 전부 코드 1로 끝났어요. 숫자만으로는 원인을 고를 수 없습니다. 그 위의 마지막 구체적인 줄을 봐야 해요.

내가 할 것:

• 마지막 출력에서 문구를 찾아 분기: 모델 미지원 → 3-C / 혼잡 → 3-D / 사용량 → 3-E / 인증 → 3-F.
• DNS·TLS·연결 끊김·서버 응답 오류가 명시돼 있으면 PC 인터넷과 회사 네트워크 제한 확인. 웹페이지가 열린다고 코덱스 연결이 정상이란 뜻은 아니에요.
• 회사망의 인증서·프록시 문제는 오류 종류를 강사·IT 담당에게 전달.

3-H. "research-title-result.json이 생성되지 않았습니다" / JSON 오류

증상과 뜻: JSON은 AI 직원이 앱에 내는 보고서 양식이에요. 양식이 다섯 단계(조사·제목 → 작성 지침 → 본문 → 검수 → 이미지)마다 다음 단계로 넘어갑니다.

코덱스가 종료 코드 0(정상)으로 끝나도 보고서가 없거나 양식이 틀릴 수 있어요.

내가 할 것:

• 바로 앞에 실행 파일·모델·한도 오류가 있었는지 먼저 확인. 앞 단계가 실패해서 보고서가 없는 경우가 대부분이라, 그걸 먼저 풉니다.
• 앱 이력에서 최종 상태(성공 / 부분 성공 / 실패) 확인. 기록상 JSON 오류 10건 중 5건은 최종 성공, 2건은 부분 성공이었어요. 중간 경고만 보고 실패로 단정하지 않기.
• 앱은 결과 읽기 실패 때 한 번 자동 재실행해요. 그래도 실패하면 반복 중지.

3-I. "제한 시간 안에 끝나지 않음" / "출력이 없어 중단"

쉬운 뜻: 기본값은 코덱스 한 번 실행에 전체 60분, 연속 무출력 15분이에요(설정에 따라 다를 수 있음). "무출력"은 앱이 진행 신호를 못 받았다는 뜻이지 AI가 멈췄다는 증거는 아닙니다. 이 경우 앱은 코덱스를 종료하고 실패 처리해요.

내가 할 것:

• 마지막 진행 단계와 오류에 찍힌 분 수 메모.
• PC 절전 모드, 인터넷 끊김, 작업량(글 길이·이미지 수) 확인.
• 반복되면 강사에게 진단 요청.

3-J. 옵션 미지원 / image_generation 없음 / xhigh 미지원

쉬운 뜻: 앱이 요구하는 기능과 내 PC의 코덱스 CLI 버전이 안 맞아요. npm 래퍼·node.exe를 못 찾는다는 문구도 같은 계열입니다.

내가 할 것:

• 앱이 쓰는 파일·버전을 먼저 확인(2장).
• 기존 설치 방식의 공식 업데이트 경로로 호환 버전 준비. 새 CLI를 따로 깔아도 앱이 예전 파일을 계속 고르면 해결 안 돼요.
• xhigh는 모델 이름이 아니라 추론 강도예요. 지원 안 된다는 문구가 명시될 때만 앱이 high로 한 번 재실행합니다. 모델·로그인 오류와는 무관.

3-K. 이미지가 없거나 사용량 표시가 안 나옴

쉬운 뜻: 세 가지를 구분해야 해요. ① 이미지 생성 기능 자체가 없음(3-J) ② 이미지 결과 파일 누락 ③ 이 글과 이미지의 연결 검증 실패. 앱은 다른 글의 이미지를 추측해서 끼워 넣지 않도록 검증합니다. 이미지 일부 실패는 경고와 함께 본문만 진행될 수 있어요. 이미지 실패가 글 전체 실패는 아닙니다.

내가 할 것:

• 이력의 최종 상태와 미리보기를 같이 확인.
• 주간 잔량 -, 사용량 조회 시간 초과는 표시용 조회 문제일 수 있음. 그 값으로 실행 실패나 사용량 소진을 판단하지 않기.
• 강사에게 "본문 생성 여부 / 이미지 유무 / 사용량 표시 상태" 세 가지를 나눠서 알려주기.

3-L. 근거 부족 / Main Review 미통과 / 기타 차단

쉬운 뜻: 이건 고장이 아니라 앱이 글의 신뢰성을 지키려고 일부러 멈춘 것이에요. 출처가 약하거나 검수를 못 넘긴 거죠.

내가 할 것:

• 주제 범위를 좁히거나, 직접 관련된 공식·기관 출처를 보강해서 다시 시도.
• 작업 폴더 접근 거부·디스크 공간 오류는 파일 시스템 문제로 따로 확인.
• JOB_CANCELLED는 내가 중지 버튼을 누른 결과일 수 있어요.
• 입력 자료에 비밀번호·토큰 비슷한 게 있어서 차단되면 그 부분을 자료에서 지우기.
• 앱 이용권 만료, 네이버 세션 만료는 각각 이용권·네이버 로그인 문제로 따로.

4. 설정 파일에서 코덱스 경로 바꾸기 (3-A 확인된 경우에만)

이 절차는 3-A에서 "실행 파일 경로 문제"가 확인된 경우에만 씁니다. 탐색기 주소창에 %APPDATA% 같은 환경변수를 넣으면 그 폴더로 이동해요.

• 앱 상단 runtime 경로를 메모하고 앱 종료. 설치형 기본 후보는 %APPDATA%\blogauto-naver-tistory\runtime인데, 화면에 표시된 실제 경로가 우선.
• 그 폴더의 user-settings.json을 복사해 같은 폴더에 user-settings.before-codex-path.json 같은 이름으로 백업. 백업을 Dropbox 공유 폴더에 두지 않기.
• 원본 user-settings.json을 메모장으로 열고 Ctrl+F로 codexCmdPath 찾기.
• 그 항목의 값만 2장에서 검증한 경로로 교체. 아래는 형식 예시이고 사용자 이름·설치 위치는 내 PC 것으로 바꿔야 해요. 경로 구분을 /로 쓰면 역슬래시 실수를 줄일 수 있어요.

"codexCmdPath": "C:/Users/사용자이름/AppData/Local/Programs/OpenAI/Codex/bin/codex.exe"

• 주변 중괄호·쉼표·다른 설정은 그대로. 이 한 줄로 파일 전체를 덮어쓰지 않기. 역슬래시를 쓸 거면 C:\\Users\\...처럼 두 개씩.
• 저장 후 앱 재실행. 설정 읽기 오류나 이상한 설정 변화가 보이면 앱 종료 → 백업 파일을 원래 이름으로 복원 → 강사에게.

codexCmdPath 항목이 아예 없거나 runtime 폴더를 못 찾겠으면 파일을 새로 만들지 마세요. 설치본과 개발본을 같이 쓰는 분은 각각 다른 설정 파일을 읽을 수 있어요.

5. 다 고쳤는지 확인하는 4단계

순서대로 통과해야 "해결"이에요. 앞 단계 통과가 뒤 단계를 보장하지 않습니다.

4단계 할 때 꼭 이렇게:

• 앱에서 수동 방식 선택.
• 생성 후 Naver 발행까지 진행 체크 해제 후 설정 저장. 티스토리 후속 발행도 해제 확인.
• 자동 방식은 발행 체크가 강제로 켜져 있어서 테스트용으로 쓰면 안 돼요. 실제로 올라갑니다.
• 생성 자체는 코덱스 사용량을 쓴다는 점 기억.

6. 강사에게 물어볼 때 — 이 양식으로

이걸 채워서 보내면 "재설치해 보세요" 같은 막연한 답 대신 바로 원인으로 갑니다. 화면 캡처는 글 본문·이메일·PC 사용자 이름을 가린 뒤 필요한 부분만.

앱 버전:
사용 형태: 설치형 / portable / 개발판
실패 단계: 조사 / 작성 / 검수 / 이미지 / 사용량 조회 / 발행
화면의 구체적인 오류 문구와 종료 코드:
앱에서 선택한 모델:
동일 Codex 파일의 버전 확인(2-3): 성공 / 실패 / 아직 안 해봄
동일 Codex 파일의 로그인 상태(2-4): 성공 / 실패 / 아직 안 해봄
이번에 바꾼 것과 결과:
이미 게시됐는지: 게시됨 / 미게시 / 불확실

단톡방·공유 폴더에 올리면 안 되는 것: auth.json, 전체 user-settings.json, 쿠키·브라우저 프로필, 진단 내보내기 원본, 글 본문·계정 자료.

부록 A. 용어 한 줄 사전

• 코덱스 CLI(까만창): 앱이 글 조사·집필을 시키는 별도 프로그램. 키보드 명령으로 쓰는 프로그램이라 까만 창으로 보여요.
• PATH: 윈도우가 프로그램을 찾아보는 폴더 목록. 여기 없어도 프로그램은 있을 수 있어요.
• runtime 폴더: 앱이 설정·이력을 저장하는 폴더. 앱 상단에 표시돼요.
• codexCmdPath: 설정 파일에서 "코덱스가 어디 있는지" 적어 둔 항목.
• JSON: AI와 앱이 주고받는 보고서 양식.
• 모델: 글을 쓰는 AI의 종류. 계정마다 쓸 수 있는 모델이 달라요.
• 추론 강도(high/xhigh): 모델이 얼마나 깊게 생각할지. 모델 이름이 아니에요.
• 종료 코드: 프로그램이 끝나며 남기는 숫자. 0은 정상, 1은 "뭔가 실패"이고 이유는 다른 줄에 있어요.

부록 B. 세 가지 로그인은 서로 다른 것

코덱스 실행 파일 오류(3-A)를 네이버 비밀번호를 바꿔서 풀 수는 없어요. 어느 로그인인지부터 보세요.

부록 C. 이 문서가 보장하지 않는 것 (솔직하게)

• 이 문서는 2026-09-06 ~ 10-03 사이에 수집된 오류 기록 28건과 앱 소스를 대조해 쓴 확인 절차예요. 모든 수강생 PC에서 복구가 완료됐다는 뜻은 아닙니다.
• DLL 오류(3-B)의 구체적인 원인 모듈, 서버 쪽 실패 44건의 원인별 수, 각자 계정의 현재 모델 지원 여부는 아직 확인되지 않았어요.
• 앱 자체의 개선(새 설치 위치 자동 탐색, 오류 분류 세분화, 반복 실패 억제 등)은 예정 상태라, 이 문서가 생겼다고 지금 설치된 앱의 동작이 바뀌진 않습니다.

챗사피엔스 · 바이브코딩 특별반 · 2026-10-04