본 문서는 CLI(씨엘아이, Command Line Interface) 환경에서 사용하는 AI 코딩 도구의 설치와 활용법을 다룬다. 운영체제 환경별 설치 명령어와 공식 문서, 프롬프트 작성 가이드, 확장 기능 연동 문서를 단계별로 안내한다. 터미널 환경에서 도구를 안정적으로 구성하고 작업 흐름에 적용하는 방법을 설명한다.
1. 공식문서
도구의 전체 명령어 목록과 구성 파일 설정 방법은 공식 문서에서 제공된다. 도구의 세부 옵션과 지원 환경을 확인하기 위해 공식 가이드를 참조한다.
2. install
운영체제 및 개발 환경에 따라 적합한 설치 방식을 선택하여 터미널에 명령어를 입력한다. macOS 전용 셸 스크립트, Windows PowerShell(파워셸) 스크립트, 또는 Node.js의 패키지 관리자인 npm(엔피엠)을 통한 전역 설치를 지원한다.
curl -fsSL https://chatgpt.com/codex/install.sh | shpowershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"npm install -g @openai/codex설치 명령어 세부 동작 및 옵션
각 설치 명령어의 동작 원리와 옵션은 다음과 같다.
- macOS (curl 방식): 웹에서 설치 스크립트를 다운로드하여 즉시 기본 셸(sh)로 전달해 실행한다.
-fsSL옵션 중-f는 서버 오류 시 실패 처리,-s는 다운로드 진행률 숨김,-S는 오류 발생 시 메시지 출력,-L은 HTTP 리다이렉트 발생 시 최종 목적지까지 추적하는 역할을 한다. 설치 경로가 시스템의 환경 변수(PATH)에 등록되어 있어야 명령어를 바로 실행할 수 있다. - Windows (PowerShell 방식):
-ExecutionPolicy ByPass옵션을 지정하여 시스템의 스크립트 실행 제한 정책을 일시적으로 우회한다.-c뒤에 전달된 명령어 중irm(Invoke-RestMethod)으로 설치 스크립트 내용을 읽어오고,iex(Invoke-Expression)로 해당 코드를 메모리 상에서 실행한다. 관리자 권한이 없는 터미널에서는 파일 생성 실패 오류가 발생할 수 있으므로 권한 상태를 확인해야 한다. - npm 방식:
-g(global) 옵션은 패키지를 전역 디렉터리에 설치하여 시스템 내 어느 경로에서든 명령어를 직접 실행할 수 있도록 만든다. Node.js 런타임 환경이 사전에 설치되어 있어야 하며, 글로벌 디렉터리에 대한 쓰기 권한이 필요하다.
3. 프롬프트 가이드
프롬프트(Prompt, 지시문)는 AI 모델에게 코드 생성, 수정, 분석 등의 작업을 지시하기 위해 입력하는 텍스트이다. 모델이 지시 의도를 정확히 이해하도록 작업 목표, 제약 조건, 파일 맥락을 구조화하여 전달하는 작성 기법을 공식 가이드에서 다룬다.
4. 스킬&플러그인
스킬 및 플러그인(Plugin, 확장 모듈)은 CLI 도구의 기본 기능 외에 외부 도구 연동이나 사용자 정의 기능을 추가할 수 있도록 지원하는 확장 인터페이스이다. 개발 워크플로에 맞춰 기능을 확장하거나 자동화 규칙을 정의할 때 아래 문서를 확인한다.