코덱스는 '명령어를 찾을 수 없습니다'라는 메시지를 보는데, 이는 보통 계정 문제가 아니라 현재 셸에서 찾을 수 있는 위치에 CLI가 설치되어 있지 않다는 뜻입니다. 사용 환경을 확인하세요: macOS, Linux, Windows PowerShell, WSL은 서로 다른 PATH를 가지고 있습니다.
설치가 성공했는지 확인해
npm로 설치한다면, 먼저 'npm list -g --depth=0'을 실행해서 '@openai/codex'가 있는지 확인해 보세요. OpenAI 도움말에서 제공하는 기본 설치 방법은 Codex CLI를 전역적으로 설치하는 것이므로, 설치가 완료된 직후에 바로 'codex'를 실행할 수 있을 것입니다.
목록에 패키지가 있는데도 명령어를 찾을 수 없다면, npm 글로벌 bin 경로를 계속 확인하세요: 'npm bin -g' 또는 'npm config get prefix'. 그 다음 이 디렉터리가 'PATH'에 있는지 확인해 보세요.
WSL과 Windows가 가장 섞기 쉽습니다
특히 윈도우에서 흔한데, Codex가 PowerShell에 설치되어 있지만 WSL에서 실행되고 있습니다; 또는 WSL에 설치하되 Windows 터미널에서 찾아보세요. Node, npm, PATH는 양쪽에서 다릅니다.
해결책은 간단합니다: 어떤 터미널에서든 Codex를 사용하고, 어느 터미널에 설치하세요. WSL 프로젝트는 Windows npm을 혼용하지 않고 WSL 내에서 설치하고 실행하는 것이 권장됩니다.
그리고 쉘 캐시도 확인해 봐
ZSH, BASH, 때로는 명령 경로를 캐시하기도 합니다. 설치 후 터미널을 재시작하거나 '해시 -r'을 실행하세요. '.zshrc'나 '.bashrc'만 변경했다면 설정도 다시 불러와야 합니다.
회사 컴퓨터가 글로벌 npm 설치를 제한한다면, 임시로 npx를 사용하거나 관리자에게 Node 글로벌 디렉터리를 승인해 달라고 요청할 수 있습니다. 권한 문제를 'sudo npm install -g'로 하드 변경하지 마세요. 그러면 이후 업데이트와 파일 권한이 남을 수 있습니다.
가장 빠른 문제 해결 순서
먼저 설치되었는지 확인하고, 글로벌 빈 경로를 보고, PATH를 확인한 다음, 잘못된 터미널 환경을 실행하고 있는지 확인하세요. 이것만 정상이고, 계정 로그인이나 네트워크 문제를 확인하세요.
