【Codex】CLI 설정 및 조작 방법 정리
요약
본 글은 OpenAI의 AI 코딩 에이전트인 Codex를 CLI 환경에서 설정하고 사용하는 방법을 안내합니다. 사용자는 `npm install -g @openai/codex` 명령어로 설치한 후, 로그인 절차와 기본적인 명령어 실행 및 조작법을 익힐 수 있습니다. 또한, `.codex/config.toml` 파일을 통해 모델 선택, 추론 강도, 승인 정책 등 다양한 고급 설정을 커스터마이징할 수 있으며, 보안을 위해 옵트아웃 설정까지 완료하는 것이 중요합니다.
핵심 포인트
- Codex CLI는 `npm install -g @openai/codex` 명령어로 설치하며, 사용 전 ChatGPT Plus 플랜 등을 통해 로그인이 필요합니다.
- 기본적으로 디렉터리 이동 후 `codex` 명령어를 실행하여 자연어 요청을 할 수 있으며, 세션 토큰 소비량 확인 기능이 제공됩니다.
- 비대화형 자동화 모드는 Git 관리 디렉터리 내에서 `codex exec {요청 내용}` 형식으로 구현할 수 있습니다.
- .codex/config.toml` 파일을 통해 사용 모델, 추론 강도, 다중 에이전트 대응 등 광범위한 고급 설정을 커스터마이징 할 수 있습니다.
- 기밀 정보 보호를 위해 옵트아웃(Opt-out) 설정은 반드시 수행해야 합니다.
평소 아이디어 구상용으로 OpenAI의 ChatGPT (Plus 플랜)를, AI 코딩 에이전트용으로 Anthropic의 Claude Code를 사용해 왔으나, OpenAI의 AI 코딩 에이전트인 Codex가 최근 평이 좋다는 소문을 들어서 이번에는 설정 절차를 정리해 보았습니다.
조금이라도 참고가 된다면 좋겠습니다.
먼저 Codex CLI 설치를 진행합니다.
터미널에서 다음 명령어를 실행합니다.
npm install -g @openai/codex
설치가 완료되면 다음 명령어를 실행합니다.
codex
다음과 같이 표시되므로, Sign in with ChatGPT (Plus 플랜 사용)를 선택합니다.
※ 이미 유료 플랜에 가입하신 분은 먼저 이 사인인(Sign in) 방법으로 시도해 보시는 것을 권장합니다.
브라우저가 실행되므로 화면의 지시에 따라 로그인을 완료합니다.
터미널로 돌아와 화면의 지시에 따라 진행합니다.
무사히 사용할 수 있는 상태가 되었습니다!
조작 대상 디렉터리로 이동하여 codex 명령어를 실행합니다.
주의사항을 읽은 후 승인합니다.
기동이 완료되었습니다!
기본적으로 모델이나 디렉터리 경로가 표시되는 점은 고맙게 느껴집니다.
자연어로 Codex에 요청을 합니다.
Codex를 종료하고 싶을 때는 Ctrl + C를 실행합니다.
기본적으로 세션의 토큰 소비량이 표시되는 것도 Claude Code에는 없는 기능입니다.
터미널에서 다음과 같이 codex 명령어의 인자(Argument)로 프롬프트(요청)를 지정하여 실행하는 것도 가능합니다.
또한, git 관리 디렉터리 내에서 codex exec {요청 내용} 형식으로 실행하면 비대화형(Non-interactive) 자동화 모드가 됩니다.
Codex의 설정은 .codex/config.toml 파일에 기술합니다.
샘플 설정이 준비되어 있으므로 참고해 보시기 바랍니다.
(Copy Page도 마련되어 있으므로, 그대로 AI에게 던져서 질문해 보는 것도 추천합니다)
・사용 모델
・review 전용 모델
・추론 강도
・출력의 중복성(Redundancy)
・승인 정책
・조작 권한
・다중 에이전트(Agent) 대응
・고속 모드
・웹 검색
・MCP 서버 접속 설정
・Hooks
등등, 이 외에도 많은 설정 항목이 있으니 조사하여 커스터마이징해 보세요.
기밀 정보 보호를 위해 옵트아웃(Opt-out) 설정을 잊지 말고 수행합니다.
(ChatGPT 쪽에서 수행하면 동일한 계정의 Codex 이용 시에도 적용됩니다)
옵트아웃 절차에 관해서는 이 기사가 이미지와 함께 알기 쉽게 설명되어 있어 추천합니다.
AI 자동 생성 콘텐츠
본 콘텐츠는 Qiita AI의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기