Codex CLI 오류, Windows에서 자주 막히는 4가지

Codex CLI 오류가 설치보다 환경에서 더 많이 터지는 이유

Codex CLI 오류는 요즘 설치 자체보다 Windows 환경에서 더 자주 터집니다. 지금 Codex CLI는 macOS, Windows, Linux를 다 지원하고, Windows에서는 PowerShell 네이티브 sandbox와 WSL2를 둘 다 쓸 수 있거든요. 문제는 선택지가 늘어난 만큼 막히는 지점도 갈렸다는 점입니다. 한 터미널에서 깔고 다른 터미널에서 실행하거나, ChatGPT 로그인과 API key를 섞어 쓰면 금방 꼬입니다.

매달 구독료나 API 비용을 내는 입장에선 여기서 20분씩 날리는 게 제일 아깝더라구요. 아래 4가지만 보면 Codex CLI 오류는 대부분 정리됩니다.

1. 'codex' is not recognized as an internal or external command

이건 설치가 안 됐거나 PATH가 아직 안 잡힌 경우입니다. 기본 설치 명령은 `npm i -g @openai/codex`이고, 최신 버전으로 올릴 때는 `npm i -g @openai/codex@latest`를 쓰면 됩니다. 설치 직후 기존 PowerShell 창을 계속 쓰면 Windows가 새 PATH를 못 읽는 경우가 꽤 많습니다.

2. Incorrect API key provided: sk-... You can find your API key at https://platform.openai.com/api-keys

이건 Codex CLI 오류 중에서 제일 허무한 쪽입니다. 보통 예전 키를 환경 변수에 남겨둔 채 새 키를 붙여 넣었거나, 서로 다른 API key를 섞어서 씁니다. OpenAI 안내도 키가 맞는지, 두 개를 섞어 쓰지 않았는지부터 보라고 적어놨습니다.

3. codex not found

이 문구는 WSL 안에서 많이 나옵니다. Windows PowerShell에 설치한 Codex가 WSL Ubuntu 안으로 자동 복사되지는 않기 때문입니다. WSL에서 쓸 거면 WSL 안에 Node를 깔고, 그 안에서 다시 `npm i -g @openai/codex`를 해야 합니다. 그리고 WSL1은 Codex 0.115부터 더 이상 지원되지 않습니다.

4. error 1385

이건 코드 문제가 아니라 Windows 정책 문제입니다. Codex가 네이티브 `elevated` sandbox를 쓰려는데, Windows가 sandbox 사용자 로그온 권한을 막을 때 뜹니다. 회사 노트북에서 특히 잘 보이더라구요.

어디부터 보면 제일 빠른가

Codex CLI 오류를 만났을 때 순서는 늘 같습니다. PowerShell인지 WSL인지부터 확인하고, 설치 위치를 본 뒤, 인증 방식을 하나로 맞추고, 마지막에 sandbox를 봅니다. 이 순서만 지켜도 괜히 API 문제로 오해하거나, 반대로 권한 문제를 설치 탓으로 돌리는 일이 줄어요.

지금 Codex CLI 오류를 검색해서 들어온 분이라면 제일 먼저 1번과 3번부터 보면 됩니다. Windows에 깔아놓고 WSL에서 찾는 경우, 이게 정말 많거든요.