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

Codex CLI

터미널에서 코드를 살펴보고 수정하고 실행하세요

터미널에서 바로 코드를 살펴보고 수정하세요. 명령어를 실행하고 반복 작업도 자동화할 수 있습니다.

$ codex
╭──────────────────────────────────────────────────╮
│ >_ OpenAI Codex                                  │
│                                                  │
│ model:     gpt-6.1-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 명령어를 호출하세요.

Quickstart

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 실행 및 로그인

    Open a project directory and run codex. The first time you run Codex, choose ChatGPT로 로그인 or another available sign-in method.

    인증 옵션 살펴보기
  3. 첫 작업 시작하기

    원하는 결과를 설명하세요. 예를 들어 Codex에 프로젝트를 설명해 달라고 하거나 특정 부분을 수정해 달라고 요청할 수 있습니다. 문제를 디버깅할 때도 도움을 요청할 수 있습니다.

    Tell me about this project

    변경 사항을 되돌릴 수 있도록 작업 전후에 Git 체크포인트를 만드세요. 자세한 내용은 다음 문서를 참고하세요. 권장 사항.

Codex CLI로 할 수 있는 일

대화형 작업부터 자동화, 코드 리뷰, 작업 위임까지 터미널 한 곳에서 처리하세요.

01

터미널에서 코딩 작업 이어가기

리포지터리에서 Codex를 시작하세요. 낯선 코드를 살펴보고 수정 계획을 세운 뒤 파일을 편집하고 로컬 개발 도구를 실행할 수 있습니다. 작업 중에도 추가 지시를 내리거나 명령어와 코드 변경 내역을 표시되는 즉시 확인할 수 있습니다. 후속 작업도 같은 세션에서 이어가세요.

Learn more
02

스킬과 플러그인 사용하기

반복해서 사용할 지침을 스킬로 만드세요. 그런 다음 CLI에서 플러그인을 추가해 Codex를 팀의 도구 및 데이터에 연결하세요.

Learn more
03

배포 전 변경 사항 검토하기

코드 리뷰 기능으로 아직 커밋하지 않은 변경 사항이나 특정 커밋을 검토하세요. 기준 브랜치와 비교해 검토할 수도 있습니다. Codex는 작업 트리를 수정하지 않고 발견한 문제를 우선순위순으로 알려 줍니다. 커밋하거나 pull request를 열기 전에 위험 요소를 해결하세요.

Learn more

CLI에서 세션을 재개하고 시각 자료와 웹 정보를 컨텍스트에 추가하는 방법을 알아보세요. 복잡한 작업을 나누거나 Codex를 개발 도구에 연결할 수도 있습니다.

01 codex resume

저장된 채팅 이어가기

현재 리포지터리의 최근 채팅을 다시 여세요. 예전 작업을 이어가려면 전체 로컬 채팅에서 검색하세요.

02 codex --image

프롬프트에 시각 자료 추가하기

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

03 subagents

규모가 큰 조사 작업 나누기

Codex에 세부 작업을 전문 에이전트에게 나누어 맡긴 뒤 각 에이전트의 조사 결과를 메인 터미널 세션에 모아 달라고 요청하세요.

04 codex --search

최신 정보 검색하기

최신 릴리스나 문서, 외부 시스템의 현재 동작을 확인해야 할 때는 실시간 웹 검색으로 전환하세요. 검색 내역은 대화 기록에서 계속 확인할 수 있습니다.

05 codex cloud

Codex Cloud로 작업 옮기기

터미널에서 진행 중이거나 완료된 채팅을 살펴보세요. 설정해 둔 환경에 작업을 제출하고 그 결과를 로컬 리포지터리에 적용할 수 있습니다.

06 codex mcp

MCP로 외부 도구 연결하기

로컬 또는 원격 MCP 서버를 추가하고 필요한 경우 인증을 마치세요. Codex가 도구를 사용하기 전에 현재 세션에서 어떤 도구를 쓸 수 있는지 확인하세요.

07 /permissions

실행별 허용 범위 설정하기

Codex가 승인 요청 없이 파일을 수정하거나 명령어를 실행할 수 있는 조건을 선택하세요. 계속하기 전에 현재 적용된 샌드박스와 쓰기가 허용된 루트 디렉터리를 확인하세요.

08 codex completion

터미널에 맞게 Codex 설정하기

셸 자동 완성 스크립트를 생성하고 구문 강조 테마를 선택하세요. 긴 프롬프트는 VISUAL 또는 EDITOR로 지정한 편집기에서 여세요.

Use Codex CLI when…

터미널에서 작업할 때

터미널 한 곳에서 리포지터리의 코드를 살펴보고 수정하고 실행하세요.

스크립트나 CI가 필요할 때

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

로컬에서 코드 리뷰를 받고 싶을 때

커밋하거나 pull request를 열기 전에 변경 사항을 확인하세요.

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

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