터미널이 처음이어도 괜찮다. 안심하고 따라오면 된다.
2025년 4월, OpenAI(ChatGPT를 만든 회사)가 "Codex"라는 AI 도구를 세상에 내놓았다. 이름은 생소하지만 작동 방식은 단순하다. 목표를 말하면 스스로 파일을 읽고, 고치고, 명령을 실행한다. 이런 AI를 "에이전트"라고 부른다. 단순히 질문에 답하는 챗봇이 아니라, 실제로 일을 처리하는 AI다.
Codex에 접근하는 방법은 네 가지다. 브라우저에서 바로 쓰는 웹(chatgpt.com/codex), 내 컴퓨터에서 직접 실행하는 CLI(명령줄 인터페이스, 터미널 창에 명령어를 입력하는 방식), 데스크톱 앱, 그리고 VS Code 같은 코딩 편집기에 붙이는 IDE 확장(개발자용이라 이 책에서는 다루지 않는다)이다. 이 중 비개발자에게는 웹이 가장 쉽다 — 설치 없이 브라우저에서 바로 열리니 진입 장벽이 낮다.
비개발자에게 Codex가 매력적인 이유는 말하자면 "목표만 던지는 방식" 때문이다(화면에 그런 이름의 버튼이 따로 있는 건 아니다). 최종 목표만 던지면 Codex가 스스로 단계를 쪼개고 실행해 완성한다. 중간 과정을 일일이 지시하지 않아도 된다. 실제 사례가 있다. 유튜버 Riley Brown이 시연한 영상에서, 다운로드 폴더에 쌓인 영수증 사진 53장을 Codex에 넘기고 "엑셀로 분석하고 차트 만들어줘"라고 했더니, Codex가 사진에서 글자를 읽고 분류해서 7분 만에 총지출 및 결제수단별·월별 트렌드 대시보드를 만들어냈다. 코딩 한 줄 없이.
요금의 현실은 이렇다.
Free 플랜은 설치하고 분위기를 익히는 데는 쓸 만하지만, 실제 에이전트 작업을 돌리기엔 한도가 매우 낮다. 제대로 써보려면 Plus(월 $20, 약 2만 9천 원 + 부가세) 이상이 필요하다. 더 무거운 작업을 많이 돌릴 계획이라면 Pro 5x(월 $100) 또는 Pro 20x(월 $200)도 있다 — 여기서 '5x·20x'는 Plus 대비 쓸 수 있는 양이 각각 5배·20배라는 뜻이다. 참고로 기본 AI 모델은 gpt-5.5로, 지금 ChatGPT에서 쓰는 것과 같은 급의 최신 모델이다.
Codex를 처음 써보려는 사람이 가장 많이 막히는 지점은 세 곳이다. 미리 알면 막히지 않는다. 단, 아래 함정 ①②는 내 컴퓨터에 직접 까는 CLI로 시작할 때 이야기다 — 1장에서 권한 웹(chatgpt.com/codex)으로 시작하면 설치·로그인이 없어 ①②는 건너뛰어도 된다. 함정 ③(사용 한도)만 웹·CLI 모두 해당된다.
CLI로 깔 때 흔한 함정이다. 다른 블로그·영상이 터미널(명령줄 창)에서 npm i -g codex를 치라고 안내하는 경우가 많은데(npm은 프로그램을 설치해주는 도구다), 그대로 따라 치면 2012년에 만들어진 전혀 다른 동명의 패키지가 조용히 깔린다. OpenAI의 Codex가 아니다. 이름이 같아서 생기는 혼란이다.
터미널 여는 법. 맥은 Spotlight(⌘+스페이스)에 "터미널"을 치면 나온다. 윈도우는 시작 메뉴에서 "PowerShell"을 연다.
이렇게 피한다. 반드시 @openai/가 붙은 아래 명령을 써야 한다.
또는 공식 권장 방법인 스탠드얼론 설치 스크립트를 쓴다. Node.js(자바스크립트 실행 환경)가 깔려 있지 않아도 동작한다.
윈도우 사용자라면. 위 curl … | sh 스크립트는 맥·리눅스 전용이라 윈도우에서는 오류가 난다. 윈도우에서는 먼저 Node.js(nodejs.org에서 LTS 설치)를 깐 뒤 npm install -g @openai/codex를 쓰거나, 아예 설치 없이 웹(chatgpt.com/codex)으로 시작하는 편이 가장 확실하다.
codex login을 입력하면 전화 인증 코드를 받아야 하는 화면이 나온다. 그런데 코드가 안 오거나, 재전송을 눌렀더니 "너무 많이 시도했다"는 오류가 뜨면서 차단되는 일이 많다. 웹 ChatGPT는 전화 인증이 없는데 CLI에서만 이런 문제가 생긴다.
이미 ChatGPT 계정으로 로그인된 상태에서 API 키(서비스 접근 비밀번호 같은 것)를 환경변수로 설정해도, Codex가 계속 같은 오류를 내기도 한다. 로그인 방식이 충돌하는 것이다.
이렇게 피한다. 아래 순서를 반드시 지킨다. 순서를 바꾸면 또 막힌다.
export(윈도우는 $env:)는 API 키를 시스템에 임시로 등록하는 명령이다. 1번으로 기존 로그인을 지우고, 2번으로 API 키를 먼저 심은 다음, 3번으로 새로 로그인하는 순서다.
API 키는 어디서 받나? platform.openai.com에 로그인 → 오른쪽 위 프로필 → "API keys" → "Create new secret key"로 발급받아, sk-로 시작하는 그 문자열을 위 <여기에 API 키> 자리에 넣는다. 한 가지 주의 — 이 API 키 사용은 Plus/Pro 월 구독과 별개로, 쓴 만큼 따로 과금된다. 월 구독만으로 쓰고 싶다면 API 키 없이 codex login의 ChatGPT 계정 로그인을 그대로 쓰면 된다(이 함정은 그 로그인이 막힐 때의 우회로다).
어느 순간 Codex가 "You've hit your usage limit"이라는 오류를 내며 멈춘다. 사용 한도를 다 썼다는 뜻이다. Free 플랜은 한도가 매우 낮고, Plus 이상도 한도가 있다. 문제는 공식 대시보드처럼 남은 양을 한눈에 보여주는 곳이 없다는 것이다. 에이전트가 작업하는 동안 백그라운드에서 토큰(AI가 처리하는 단위)을 모르는 사이에 소모하기 때문에, 얼마나 남았는지 가늠하기 어렵다. 다만 완전히 깜깜한 건 아니다 — 아래처럼 Codex 안에서 대략은 확인할 수 있다.
이렇게 피한다. Codex 터미널 UI 안에서 슬래시(/) 명령을 활용한다.
/compact
— 대화 기록을 압축해 한도 소모를 줄인다
/status
— 남은 용량을 확인한다
긴 작업을 시작하기 전에 /status로 먼저 확인하고, 대화가 길어지면 /compact를 습관처럼 쓰면 한도를 조금 더 아낄 수 있다.
참고 자료