터미널에서 바로 코딩 작업을 도와주는 AI 도구를 찾다 보면 Codex CLI를 설치해보려는 분들이 많아요. 설치 자체는 간단한 편이지만, 처음 접하는 분들에게는 순서가 헷갈릴 수 있어요.
이번 글에서는 Codex CLI를 설치하기 전에 준비해야 할 것들, npm을 이용한 설치 방법, 로그인 및 인증 절차, 기본 사용법과 업데이트·삭제 방법까지 순서대로 정리해볼게요.
Codex CLI란 무엇인가
Codex CLI는 터미널 환경에서 자연어로 지시를 내리면 코드를 작성하거나 수정, 설명해주는 커맨드라인 도구예요. 별도의 에디터 확장 프로그램 없이도 터미널만 열면 바로 사용할 수 있다는 점이 특징이에요.
반복적인 코드 작업이나 파일 탐색, 리팩터링 같은 작업을 명령어 몇 줄로 처리할 수 있어서, 터미널 작업에 익숙한 개발자들 사이에서 실무 도구로 많이 활용되고 있어요.
설치 전 준비사항
Codex CLI를 설치하려면 먼저 Node.js와 npm이 컴퓨터에 설치돼 있어야 해요. 터미널에서 각각의 버전을 확인하는 명령어를 입력해 정상적으로 설치돼 있는지 미리 점검하는 게 좋아요.
Node.js가 설치돼 있지 않다면 공식 홈페이지에서 최신 LTS 버전을 내려받아 먼저 설치를 완료한 뒤 Codex 설치를 진행해야 해요. 운영체제는 macOS, 리눅스, 윈도우(WSL 환경 포함) 모두에서 대체로 동일한 방식으로 설치가 가능해요.
npm으로 설치하는 방법
Node.js 환경이 준비됐다면 터미널을 열고 npm 전역 설치 명령어를 입력해 Codex CLI 패키지를 설치할 수 있어요. 전역으로 설치하면 어느 디렉터리에서든 명령어를 바로 실행할 수 있다는 장점이 있어요.
- 전역 설치: npm 전역 설치 옵션을 사용해 패키지를 한 번만 설치해두면 터미널 어디서든 실행할 수 있어요.
- 설치 확인: 설치가 끝난 뒤 버전 확인 명령어를 실행해 정상적으로 인식되는지 점검해요.
- 권한 오류 대응: 운영체제에 따라 권한 문제가 발생할 수 있는데, 이런 경우 사용자 권한으로 npm 전역 경로를 재설정하는 방법을 활용하면 해결할 수 있어요.
로그인 및 인증 설정
설치가 끝나면 처음 실행할 때 로그인 절차를 거쳐야 실제 기능을 사용할 수 있어요. 터미널에서 로그인 명령어를 입력하면 브라우저 창이 열리면서 계정 인증 절차로 연결돼요.
브라우저에서 계정 인증을 완료하면 터미널로 다시 돌아와 인증이 정상적으로 처리됐다는 안내를 확인할 수 있어요. 이후부터는 별도 로그인 없이 터미널에서 바로 도구를 사용할 수 있는 상태가 돼요.
기본 사용법
로그인이 끝나면 원하는 프로젝트 디렉터리로 이동한 뒤 실행 명령어를 입력해 대화형 세션을 시작할 수 있어요. 이 상태에서 자연어로 원하는 작업을 지시하면 코드 작성이나 파일 수정 같은 작업을 도와줘요.
세션 안에서는 파일을 열람하거나 명령어를 실행하는 것도 가능해서, 별도로 다른 창을 오가지 않고도 터미널 하나에서 코드 작업 대부분을 처리할 수 있다는 장점이 있어요.
업데이트와 삭제 방법
새 버전이 나오면 npm 전역 업데이트 명령어를 통해 손쉽게 최신 버전으로 갱신할 수 있어요. 정기적으로 업데이트를 확인해두면 새로운 기능이나 버그 수정 사항을 놓치지 않고 활용할 수 있어요.
더 이상 사용하지 않을 경우에는 npm 전역 삭제 명령어로 패키지를 제거하면 깔끔하게 정리돼요. 설치와 삭제 모두 npm 명령어 한 줄로 처리되는 구조라 관리 부담이 크지 않은 편이에요.
Codex CLI는 Node.js 환경만 준비돼 있다면 설치부터 로그인, 실행까지 몇 분 안에 끝낼 수 있는 도구예요. 터미널 작업이 익숙한 개발자라면 한 번 설치해두고 반복 작업에 활용해보는 것을 추천해요.