For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to the page URL.
기본 탐색

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 what model and reasoning effort to use
  /review - review any changes and find issues
      

 Refactor the Dashboard component to React Hooks
      
  100% context left · ? for shortcuts
      
01

로컬 레포지토리에서 작업

Codex를 사용해 파일을 검사하고 편집하며 컴퓨터에 이미 설치된 도구를 실행하세요.

02

제어권 유지

작업에 맞는 모델, 추론 수준, 권한, 명령어를 선택하세요.

03

스크립트 및 CI와 연동

Codex를 대화형으로 사용하거나 반복 가능한 워크플로우 및 파이프라인에서 codex exec를 호출하세요.

빠른 시작

Codex CLI 시작하기

Codex를 설치하고 로그인한 다음, 프로젝트 디렉터리에서 첫 작업을 실행하세요.

  1. Codex 설치

    macOS 및 Linux용 독립 실행형 설치 프로그램으로 Codex CLI를 설치하세요.

    Codex 설치

    curl -fsSL https://chatgpt.com/codex/install.sh | sh

    Codex 업데이트

    curl -fsSL https://chatgpt.com/codex/install.sh | sh
  2. Codex 실행 및 로그인

    프로젝트 디렉터리를 열고 다음을 실행하세요 codex. Codex를 처음 실행할 때는 ChatGPT로 로그인 을 선택하거나 사용 가능한 다른 로그인 방법을 선택하세요.

    인증 옵션 검토
  3. 첫 작업 시작

    달성하려는 목표를 설명하세요. 예를 들어 Codex에 프로젝트를 설명하거나, 특정 부분만 변경하거나, 이슈 디버깅을 도와달라고 요청할 수 있습니다.

    이 프로젝트에 대해 설명해 주세요

    변경 사항을 되돌릴 수 있도록 작업 전후에 Git 체크포인트를 만드세요. 참고할 문서는 모범 사례.

Codex CLI로 할 수 있는 작업

대화형 작업, 자동화, 검토 및 위임을 하나의 집중된 터미널 루프에서 수행하세요.

01

코딩 루프를 터미널 안에서 유지

레포지토리에서 Codex를 시작해 익숙하지 않은 코드를 탐색하고 변경을 계획하며 파일을 편집하고 로컬 개발 도구를 실행하세요. 진행 중인 턴에 추가 지시를 내리고, 표시되는 명령어와 diff를 확인하며, 후속 작업도 같은 세션에서 계속하세요.

자세히 알아보기
02

스킬 및 플러그인 사용

반복 가능한 지침을 스킬로 패키징한 다음, CLI를 벗어나지 않고 Codex를 팀의 도구 및 데이터에 연결할 수 있도록 플러그인을 추가하세요.

자세히 알아보기
03

배포 전에 변경 사항 검토

커밋되지 않은 변경 사항, 커밋 또는 베이스 브랜치를 대상으로 전용 검토를 실행하세요. Codex는 작업 트리를 수정하지 않고 우선순위별 검토 결과를 보고하므로, 커밋하거나 Pull Request를 열기 전에 리스크를 해결할 수 있습니다.

자세히 알아보기

세션을 재개하고 시각적 컨텍스트와 웹 컨텍스트를 추가하며, 복잡한 작업을 나누고 Codex를 개발 도구에 연결하는 데 사용할 수 있는 CLI 기능을 알아보세요.

01 codex resume

저장된 채팅으로 돌아가기

현재 레포지토리의 최근 채팅을 다시 열거나, 이전 작업으로 돌아가야 할 때 로컬 채팅 전체를 검색하세요.

02 codex --image

프롬프트에 시각적 컨텍스트 추가

첫 프롬프트에 오류 스크린샷, 아키텍처 다이어그램 또는 디자인 참고 자료를 첨부하거나 대화형 Composer에 이미지를 붙여 넣으세요.

03 subagents

큰 조사 작업 나누기

Codex에 특정 작업을 전문 에이전트에게 위임하도록 요청한 다음, 결과를 기본 터미널 세션으로 가져오세요.

04 codex --search

최신 정보 검색

작업에 최신 릴리스, 문서 또는 외부 동작 정보가 필요하면 실행 중에 실시간 웹 검색으로 전환하세요. 검색 활동은 대화 기록에 계속 표시됩니다.

05 codex cloud

Codex 클라우드로 작업 이동

진행 중이거나 완료된 채팅을 살펴보고, 구성된 환경에 작업을 제출한 다음, 터미널에서 결과를 로컬 레포지토리에 적용하세요.

06 codex mcp

MCP로 외부 도구 연결

로컬 또는 원격 MCP 서버를 추가하고, 필요한 경우 인증한 다음, Codex가 도구를 사용하기 전에 현재 세션에서 사용할 수 있는 도구를 확인하세요.

07 /permissions

실행별 작업 범위 설정

Codex가 묻지 않고 파일을 편집하거나 명령어를 실행할 수 있는 시점을 정하고, 계속하기 전에 활성 샌드박스와 쓰기 가능한 루트를 확인하세요.

08 codex completion

터미널에 맞게 Codex 설정

셸 자동 완성을 생성하고, 구문 테마를 선택하고, 긴 프롬프트는 VISUAL 또는 EDITOR로 설정한 에디터에서 여세요.

Use Codex CLI when…

터미널에서 작업하는 경우

하나의 집중된 루프에서 레포지토리를 탐색하고 편집하고 실행하세요.

스크립트 또는 CI가 필요한 경우

반복 가능한 워크플로우에서 비대화형 명령어를 실행하세요.

로컬 코드 검토가 필요한 경우

커밋하거나 Pull Request를 열기 전에 변경 사항을 검사하세요.

클라우드에 작업을 맡기고 싶은 경우

클라우드 채팅을 시작하고 나중에 터미널로 돌아오세요.