API

Codex CLI 사용법 및 오늘의 경험(android)

Solo.dev 2025. 4. 20. 02:15

 

Codex CLI 사용법 및 오늘의 경험

1. Codex CLI 사용법

설치 (Windows/WSL2)

  1. WSL 설치:
    wsl --install
  2. nvm 및 Node.js (v22):
    curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
    source ~/.bashrc
    nvm install 22
    nvm use 22
  3. CMD에서 WSL(Ubuntu) 진입:
    wsl -d Ubuntu
  4. 프로젝트로 진입:
    cd /mnt/c/Users/jeyoung/DateP
  5. Codex CLI 설치:
    sudo npm install -g @openai/codex
  6. OpenAI API 키 설정:
    echo 'export OPENAI_API_KEY="your-api-key"' >> ~/.bashrc
    source ~/.bashrc
    설정 완료 (당신의 키 사용).

기본 사용

codex [options] ""

예: codex -m gpt-4.1-nano "List files in src/"

주요 옵션

  • -m : 모델 지정 (예: gpt-4.1-nano). 복잡한 분석.
  • -f: 전체 리포지토리 로드 (.codexignore로 제외). 대규모 작업.
  • -q: 비대화형 출력. 자동화.
  • --project-doc : 문서 컨텍스트 (예: README.md).
  • --verbose: 디버깅 로그.

2. 오늘의 경험

사용한 명령어

codex -m gpt-4.1-nano -f ".codexignore 참고해서 적절한거만 적용"

목표: DateP 프로젝트(src/HomeScreen.tsx, src/SubscriptionProvider.tsx) 구조 파악.

옵션:

  • -m gpt-4.1-nano: 고성능 모델.
  • -f: 전체 컨텍스트, .codexignore로 제외 시도.

설정:

  • ~/.codex/config.json: model=o4-mini, approvalMode=suggest.
  • .codexignore: node_modules/, build/, assets/ 등 제외.
  • API 키: ~/.bashrc에 설정.

작업 과정

  • 시도: -f로 src 폴더 분석, .codexignore로 불필요 파일 제외.
  • 결과:
    • 성공: API 키 설정, Codex 실행, 일부 코드 분석.
    • 문제: .codexignore 미인식, 7,771,249 토큰 초과.

3. 겪은 문제

  • .codexignore 미인식: CRLF → LF 변환(dos2unix) 완료, 하지만 node_modules/ 등 포함.
  • 컨텍스트 초과: 222개 파일(7,771,249 토큰), 2,000,000 제한 초과.
  • 프롬프트 모호: ".codexignore 참고..." 지시 효과 없음.
  • WSL2: /mnt/c/... 경로 문제 가능성.