터미널에서 바로 코드를 작성하고 수정할 수 있는 AI 도구에 관심 있는 개발자라면 Codex CLI를 한 번쯤 들어봤을 거예요. 명령줄 환경에서 자연어로 요청하면 코드를 읽고 수정하고 실행까지 해주는 도구인데, 처음 접하면 어떤 명령어부터 익혀야 할지 막막할 수 있어요. 기본적인 사용법을 정리해볼게요.
Codex CLI란 무엇인가
Codex CLI는 터미널에서 실행하는 AI 코딩 에이전트로, 프로젝트 디렉터리 안에서 자연어 지시를 내리면 파일을 읽고 수정하고 명령을 실행하는 방식으로 동작해요. 별도의 IDE 플러그인 없이도 터미널만 있으면 바로 사용할 수 있다는 게 특징이에요.
기존의 코드 자동완성 도구와 다른 점은 단순히 다음 줄을 예측하는 게 아니라, 여러 파일을 오가며 맥락을 파악하고 실제로 파일을 수정하거나 테스트를 실행하는 등 하나의 작업 흐름 전체를 처리할 수 있다는 점이에요.
설치 방법
Codex CLI는 npm을 통해 전역으로 설치하는 방식이 일반적이에요. Node.js가 설치된 환경에서 패키지 매니저를 통해 설치 명령을 실행하면 터미널에서 바로 codex 명령어를 사용할 수 있게 돼요.
설치 후에는 계정 인증 절차가 필요해요. 처음 실행하면 로그인 안내가 나오는데, API 키를 직접 입력하는 방식과 계정으로 로그인하는 방식 중 하나를 선택할 수 있어요. 인증이 완료되면 이후부터는 별도 로그인 없이 바로 사용할 수 있어요.
- Node.js 환경 준비: 패키지 설치를 위해 Node.js와 npm이 먼저 설치돼 있어야 해요.
- 전역 설치: npm을 통해 CLI 패키지를 전역으로 설치하면 어느 디렉터리에서든 명령어를 사용할 수 있어요.
- 계정 인증: 처음 실행 시 로그인 또는 API 키 입력으로 인증을 마쳐야 해요.
기본 명령어와 실행 방식
프로젝트 디렉터리로 이동한 뒤 codex라고만 입력하면 대화형 세션이 시작돼요. 이 세션 안에서 자연어로 “이 함수의 버그를 고쳐줘”처럼 요청하면 관련 파일을 찾아 분석하고 수정 제안을 보여줘요.
대화형 세션 대신 한 번의 명령으로 바로 실행하고 종료하는 방식도 지원해요. 이런 방식은 스크립트나 자동화 파이프라인에 Codex를 넣어서 사람의 개입 없이 특정 작업을 처리하도록 만들 때 유용해요.
승인 모드 설정
Codex CLI는 AI가 파일을 수정하거나 명령을 실행하기 전에 사용자 승인을 받을지 여부를 설정할 수 있어요. 승인 모드는 크게 매번 확인을 요구하는 모드, 읽기 전용 작업은 자동 허용하고 쓰기 작업만 확인받는 모드, 그리고 모든 작업을 자동으로 승인하는 모드로 나뉘어요.
처음 사용하는 경우에는 매번 확인받는 모드로 시작해서 AI가 어떤 방식으로 파일을 수정하는지 익힌 뒤, 점차 자동 승인 범위를 넓혀가는 방식을 추천해요. 특히 파일 삭제나 시스템 명령 실행처럼 되돌리기 어려운 작업은 항상 승인을 받도록 설정해두는 게 안전해요.
- 매번 확인 모드: 파일 수정이나 명령 실행 전에 매번 사용자 승인을 요구해요.
- 자동 실행 모드: 읽기 작업은 자동으로 처리하고 쓰기 작업만 확인을 받는 방식이에요.
- 전체 자동 모드: 격리된 환경에서 모든 작업을 자동으로 처리할 때 사용해요.
설정 파일 활용
Codex CLI는 홈 디렉터리에 위치한 설정 파일을 통해 기본 모델, 승인 모드, 프로젝트별 규칙 등을 미리 지정해둘 수 있어요. 매번 실행할 때마다 옵션을 입력하는 대신 설정 파일에 원하는 값을 저장해두면 일관된 방식으로 도구를 사용할 수 있어요.
또한 프로젝트 루트 디렉터리에 별도의 안내 파일을 두면, Codex가 해당 프로젝트의 코딩 컨벤션이나 주의사항을 자동으로 참고하게 만들 수 있어요. 팀 단위로 작업할 때는 이런 프로젝트별 설정 파일을 함께 공유하면 결과물의 일관성을 유지하는 데 도움이 돼요.
정리하면 Codex CLI는 npm 설치와 계정 인증만 마치면 바로 사용할 수 있고, 대화형 세션이나 단발성 명령 실행 중 상황에 맞는 방식을 선택할 수 있어요. 승인 모드를 상황에 맞게 조절하고 설정 파일을 활용하면 반복 작업을 훨씬 효율적으로 처리할 수 있어요.