Mac에서 OpenAI CLI 설치하고 사용하는 방법 (2026 최신 가이드)
개발하면서 AI를 웹에서 복사 → 붙여넣기 방식으로 사용하는 건 생각보다 비효율적이다. 터미널에서 바로 AI를 호출할 수 있다면 반복 작업을 크게 줄일 수 있다.
이번 글에서는 Mac 환경에서 AI를 CLI로 사용하는 방법을 가장 기본부터 실전까지 정리한다.
1. OpenAI CLI란?
OpenAI CLI는 터미널에서 AI 모델을 직접 호출할 수 있는 도구다. 브라우저 없이도 코드 생성, 리팩토링, 자동화 작업을 수행할 수 있다.
- 코드 생성 자동화
- 터미널 기반 빠른 작업
- 스크립트와 결합 가능
2. Node.js 설치
OpenAI CLI는 Node.js 기반이므로 먼저 설치가 필요하다.
brew install node설치 확인:
node -v
npm -v정상적으로 버전이 출력되면 설치가 완료된 것이다.
3. OpenAI CLI 설치
npm을 이용해 전역(global)으로 설치한다.
npm install -g openai설치 확인:
openai --version버전이 출력되면 정상적으로 설치된 것이다.
4. API Key 발급 및 설정
CLI를 사용하려면 API Key가 필요하다. 아래 사이트에서 발급할 수 있다.
👉 https://platform.openai.com
환경변수 설정
export OPENAI_API_KEY="sk-xxxx"Mac에 영구 적용
echo 'export OPENAI_API_KEY="sk-xxxx"' >> ~/.zshrc
source ~/.zshrc이 과정을 거치면 터미널을 다시 실행해도 자동으로 적용된다.
5. 기본 사용법
터미널에서 바로 AI를 호출할 수 있다.
openai responses.create \
-m gpt-4.1 \
-i "Swift로 네트워크 레이어 만들어줘"명령어 실행 후 바로 AI 응답이 출력된다.
6. alias로 더 편하게 사용하기
매번 긴 명령어를 입력하는 것은 비효율적이다.
alias codex="openai responses.create -m gpt-4.1"이제 아래처럼 간단하게 사용할 수 있다.
codex -i "iOS 네트워크 매니저 만들어줘"7. 실전 활용 예시
코드 생성
codex -i "Swift async/await 네트워크 코드 작성"리팩토링
codex -i "이 코드를 async/await 구조로 변경"에러 분석
codex -i "이 에러 원인 분석해줘"8. 자주 발생하는 문제
npm 설치 오류
npm error enoent package.json not found이 오류는 잘못된 명령어 입력 또는 현재 디렉토리 문제로 발생하는 경우가 많다. 전역 설치는 반드시 아래처럼 입력해야 한다.
npm install -g openai명령어 인식 안됨
command not found: openai이 경우 터미널을 재시작하거나 PATH 설정을 확인해야 한다.
9. 정리
OpenAI CLI를 활용하면 웹을 열지 않고도 터미널에서 바로 AI를 사용할 수 있다.
- 빠른 코드 생성
- 자동화 작업 가능
- 개발 생산성 향상
다음 글 예고
다음 글에서는 AI를 활용해 코드 자동 수정하는 CLI 스크립트를 직접 만들어본다. (파일을 읽고, 수정하고, 자동으로 반영하는 방식)
📌 AI CLI 시리즈
'IT' 카테고리의 다른 글
| AI를 터미널에서 사용하는 이유 (AI CLI 개념 완벽 정리) (0) | 2026.03.26 |
|---|---|
| Mac에서 AI로 코드 자동 수정하는 CLI 만들기 (복붙 없이 자동화) (0) | 2026.03.26 |
| Claude Code 최신 업데이트 정리 (2026) – AI 코드 리뷰까지 진화했다 (0) | 2026.03.23 |
| Firebase iOS 크래시 대응 방법 (Crashlytics 완벽 가이드) (0) | 2026.03.22 |
| FirebaseApp.configure() 완료 시점 확인 방법 (iOS Firebase 초기화 완벽 정리) (0) | 2026.03.21 |