Codex CLI
터미널에서 코드 검사,편집 및 실행하기
터미널을 벗어나지 않고 코드를 검사하고, 변경하고, 명령을 실행하고, 반복 가능한 작업을 자동화하세요.
$ codex
╭──────────────────────────────────────────────────╮ │ >_ OpenAI Codex │ │ │ │ model: gpt-5.6-sol medium /model to change │ │ directory: ~/code │ ╰──────────────────────────────────────────────────╯ To get started, describe a task or try one of these commands: /init - create an AGENTS.md file with instructions for Codex /status - show current session configuration /permissions - choose what Codex is allowed to do /model - choose the model and reasoning effort /review - review changes and find issues
› Refactor the Dashboard component to React Hooks
100% context left · ? for shortcuts
로컬 저장소에서 작업
Codex가 파일을 검사하고, 편집하고, 컴퓨터에 이미 설치된 도구를 실행하도록 할 수 있습니다.
제어권 유지
작업에 적합한 모델, 추론 수준, 권한 및 명령을 선택할 수 있습니다.
스크립트 및 CI와 결합
Codex를 대화형으로 사용하거나 반복 가능한 워크플로와 파이프라인에서 codex exec를 호출할 수 있습니다.
빠른 시작
시작하기
Codex를 설치하고 로그인한 다음 프로젝트 디렉터리에서 첫 번째 작업을 실행하세요.
-
Codex 설치
다음 설치 방법 중 하나를 선택하세요. macOS 및 Linux용 독립 실행형 설치 프로그램으로 Codex CLI를 설치합니다. 설치: 업데이트: Windows용 독립 실행형 설치 프로그램으로 Codex CLI를 설치합니다. 설치: 업데이트: npm으로도 Codex CLI를 설치할 수 있습니다. 설치: 업데이트: Homebrew로도 Codex CLI를 설치할 수 있습니다. 설치: 업데이트:
Codex 설치 -
Codex 실행 및 로그인
프로젝트 디렉터리를 열고 codex 을 실행합니다. Codex를 처음 실행할 때 ChatGPT로 로그인 또는 사용 가능한 다른 로그인 방법을 선택하세요.
인증 옵션 검토 -
첫 번째 작업 시작
달성하려는 목표를 설명하세요. 예를 들어 Codex에 프로젝트 설명, 특정 변경 작업 또는 문제 디버깅 지원을 요청할 수 있습니다. 변경 사항을 되돌릴 수 있도록 작업 전후에 Git 체크포인트를 만드세요. 모범 사례 를 참조하세요.
모범 사례
Codex CLI로 할 수 있는 작업 알아보기
하나의 집중된 터미널 루프에서 대화형 작업, 자동화, 검토 및 위임을 수행하세요.
코딩 루프를 터미널에서 유지
저장소에서 Codex를 시작하여 익숙하지 않은 코드를 탐색하고, 변경을 계획하고, 파일을 편집하고, 로컬 개발 도구를 실행하세요. 진행 중인 턴을 조정하고, 표시되는 명령과 diff를 검사하며, 후속 작업을 동일한 세션에서 계속하세요.
코딩 루프를 터미널에서 유지스킬 및 플러그인 사용
반복 가능한 지침을 스킬로 패키징한 다음, CLI를 벗어나지 않고 Codex를 팀의 도구 및 데이터에 연결하는 플러그인을 추가하세요.
스킬 및 플러그인 사용배포 전 변경 사항 검토
커밋되지 않은 변경 사항, 커밋 또는 기준 브랜치를 대상으로 전용 검토를 실행하세요. Codex는 작업 트리를 수정하지 않고 우선순위가 지정된 발견 사항을 보고하므로 커밋하거나 pull request를 열기 전에 위험 요소를 해결할 수 있습니다.
배포 전 변경 사항 검토Codex를 중심으로 터미널 워크플로 구축하기
세션을 재개하고, 시각적 컨텍스트와 웹 컨텍스트를 추가하고, 복잡한 작업을 나누고, Codex를 개발 도구에 연결하는 데 사용할 수 있는 CLI 기능을 알아보세요.
저장된 채팅으로 돌아가기
현재 저장소의 최근 채팅을 다시 열거나, 이전 작업으로 돌아가야 할 때 로컬 채팅 전체를 검색하세요.
프롬프트에 시각적 컨텍스트 추가하기
첫 번째 프롬프트에 오류 스크린샷, 아키텍처 다이어그램 또는 디자인 참고 자료를 전달하거나 대화형 작성기에 이미지를 붙여 넣으세요.
대규모 조사 분할하기
Codex에 전문 에이전트에게 세부 작업을 위임하도록 요청한 다음, 에이전트의 조사 결과를 기본 터미널 세션으로 가져오세요.
최신 컨텍스트 검색하기
작업이 최신 릴리스, 문서 또는 외부 동작에 의존하는 경우 실행을 실시간 웹 검색으로 전환하세요. 검색 활동은 기록에 계속 표시됩니다.
작업을 Codex cloud로 이동하기
진행 중이거나 완료된 채팅을 탐색하고, 구성된 환경에 작업을 제출하고, 터미널에서 결과를 로컬 저장소에 적용하세요.
MCP로 외부 도구 연결하기
로컬 또는 원격 MCP 서버를 추가하고, 필요할 때 인증하며, Codex가 도구를 사용하기 전에 현재 세션에서 사용 가능한 도구를 검사하세요.
각 실행의 경계 설정하기
Codex가 요청 없이 파일을 편집하거나 명령을 실행할 수 있는 시점을 선택하고, 계속하기 전에 활성 샌드박스와 쓰기 가능한 루트를 검사하세요.
터미널에 맞게 Codex 조정하기
셸 자동 완성을 생성하고, 구문 테마를 선택하고, VISUAL 또는 EDITOR로 구성된 편집기에서 긴 프롬프트를 여세요.
다음과 같은 경우 Codex CLI 사용하기
- 터미널에서 작업하는 경우
- 하나의 집중된 루프에서 저장소를 탐색하고, 편집하고, 실행하세요.
- 스크립팅 또는 CI가 필요한 경우
- 반복 가능한 워크플로에서 비대화형 명령을 실행하세요.
- 로컬 코드 검토가 필요한 경우
- 커밋하거나 pull request를 열기 전에 변경 사항을 검사하세요.
- 작업을 클라우드에 맡기려는 경우
- 클라우드 채팅을 시작하고 나중에 터미널로 돌아오세요.