본문으로 건너뛰기
블로그로 돌아가기
[GUIDE]

코덱스 시작하기 2026: 뭐부터 할지 모를 때 고르는 시작 장소 3곳과 첫날 따라 할 순서 5단계

퀀텀점프클럽 정상록퀀텀점프클럽 정상록12분 읽기2 views

코덱스 시작하기 2026: 뭐부터 할지 모를 때 고르는 시작 장소 3곳과 첫날 따라 할 순서 5단계

코덱스: Codex라는 이름의 OpenAI AI 도구예요. 말로 요청하면 내가 고른 폴더 안의 파일을 읽고 고쳐 줍니다. 데스크톱 앱, 터미널(명령어를 글자로 입력하는 창), 코드 편집 프로그램의 확장 기능 3곳에서 쓰고, ChatGPT(OpenAI의 대화형 AI 서비스) 계정으로 로그인해서 써요.

코덱스는 어디서 시작하면 되나요?

OpenAI 공식 퀵스타트 문서에 따르면 코덱스는 데스크톱 앱으로 시작할 수 있고, macOS·Windows·Linux에서 돌아가요. 나머지 두 곳은 CLI(터미널에서 명령어로 쓰는 도구)와 IDE(코드를 편집하는 프로그램) 확장이고, 각각 공식 문서가 따로 있어요. 그래서 시작할 곳은 3곳이고, 처음에는 하나만 고르면 충분해요.

이런 분이라면처음 고를 곳
터미널이 낯설다, 앱처럼 쓰고 싶다데스크톱 앱
명령어 창에서 직접 해 보고 싶다CLI
이미 VS Code 같은 편집 프로그램을 쓴다IDE 확장

IDE 문서에는 VS Code·Cursor(AI 기능이 들어간 코드 편집 프로그램)·Windsurf는 Codex 확장을 설치하고, Xcode와 JetBrains는 자체 통합으로 쓴다고 적혀 있어요.

요금제에 따라 갈리는 부분도 있어요. 공식 요금 문서의 Free와 Go 설명에는 데스크톱 앱에서 쓴다는 말만 나옵니다. 웹, CLI, IDE 확장, iOS에서 코덱스를 쓴다는 설명은 월 20달러인 Plus 항목에 붙어 있어요. 무료로 시작해 본다면 데스크톱 앱이 가장 단순한 출발점입니다.

시작 전에 무엇을 준비하면 되나요?

준비물은 3가지예요. ChatGPT 계정, 내 요금제 확인, 작업할 폴더입니다.

1. ChatGPT 계정. 코덱스 로그인 방식은 2가지예요. 공식 인증 문서에 따르면 ChatGPT 계정으로 로그인하는 방식과, API(프로그램끼리 정보를 주고받는 통로) 키, 즉 프로그램용 비밀 문자열로 로그인하는 방식이 있어요. API 키로 들어가면 구독에 포함된 사용량이 아니라 표준 API 요금으로 과금돼요. 처음에는 ChatGPT 계정 쪽을 고르면 돼요.

2. 요금제. 공식 요금 문서에 따르면 2026년 11월 기준 월 요금은 이렇게 적혀 있어요.

  • Free는 $0예요. 데스크톱 앱에서만 쓰고, 순차 적용이라고 적혀 있습니다.
  • Go는 $8이고 Free와 같은 설명이 붙어 있어요.
  • Plus는 $20이에요. 웹, CLI, IDE 확장, iOS에서 코덱스를 쓴다고 나와요.
  • Pro는 $100부터이고 $100, $200, $500 세 가지예요.
  • Business는 사용자당 월 $20이에요. 2명 이상, 연간 결제 조건이 붙고 월 결제는 $25입니다.

가격과 포함 범위는 바뀔 수 있으니 결제 전에 공식 요금 페이지를 한 번 더 보세요.

3. 작업할 폴더. 공식 퀵스타트에는 "ChatGPT can read and modify files in the folder you choose"라고 적혀 있어요. 고른 폴더의 파일을 읽고 고칠 수 있다는 뜻입니다. 중요한 파일이 든 폴더보다 연습용 빈 폴더를 하나 만들어 두면 마음이 편해요.

첫날에는 무엇을 해 보면 되나요?

공식 퀵스타트의 데스크톱 앱 흐름은 5단계예요. 단계마다 왜 필요한지도 붙였어요.

  1. 앱을 설치해요. 앱이 있어야 폴더를 열고 대화할 수 있어서예요.
  2. ChatGPT 계정으로 로그인해요. 내 요금제와 사용량이 계정에 묶여 있어서예요.
  3. 채팅을 시작하고 작업 폴더를 열어요. 코덱스는 고른 폴더 안에서 일하는 게 기본이라서예요.
  4. ChatGPT 드롭다운(펼침 메뉴)에서 Codex를 골라요. 퀵스타트에 따르면 소프트웨어 개발 작업은 이 선택으로 시작하고, Codex 쪽에서는 New chat으로 대화를 열어요.
  5. 첫 메시지를 보내요. 프롬프트(AI에게 보내는 요청 문장)를 한 줄 써서 보내면 코덱스가 폴더를 읽고 답해요.

첫 메시지는 어떻게 쓰나요?

퀵스타트는 첫 메시지 예시를 3개 보여 줘요. 결정 메모 만들기, 스프레드시트 분석, 앱 개선이에요. 그중 앱 개선 예시는 이렇게 생겼어요.

"Inspect this app, identify one high-impact usability improvement, implement it, update the relevant tests, and verify the result on mobile and desktop."

이 앱을 살펴보고, 사용성에 가장 도움이 될 개선 하나를 찾아서 고치고, 관련 테스트도 맞추고, 모바일과 데스크톱에서 결과를 확인하라는 뜻이에요. 한 번에 시키는 일이 꽤 크죠. 첫날에는 읽기만 시키는 질문이 안전해요. 공식 CLI 문서의 첫 요청 예시가 Tell me about this project, 즉 이 프로젝트가 무엇인지 알려 달라는 문장이에요. 무언가를 고치라는 요청이 아니라 설명을 듣는 요청이라 첫 연습으로 알맞아요.

터미널에서 시작하고 싶다면 어떻게 하나요?

CLI 설치 방법은 4가지예요. macOS와 Linux용 설치 스크립트, Windows PowerShell(윈도우에 들어 있는 명령어 창), npm, Homebrew 중 하나를 고르면 돼요. 아래 명령은 macOS나 Linux에서 코덱스를 내려받아 설치하는 명령이에요.

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

설치가 끝나면 작업할 폴더로 이동해서 codex를 입력해요. 공식 CLI 문서 기준으로 첫 실행 때 로그인 화면이 나오면 Sign in with ChatGPT를 고르고, 열린 브라우저에서 로그인하면 됩니다.

codex

위 한 줄이 코덱스를 실행하는 명령이에요. 입력창이 뜨면 Tell me about this project부터 보내 보세요. 윈도우 설치 명령과 npm, Homebrew 명령은 코덱스 사용법에서 단계별로 볼 수 있어요.

일을 시키기 전에 무엇을 해 두면 좋나요?

공식 CLI 문서는 이런 습관을 권해요.

"Create Git checkpoints before and after a task so you can revert changes."

작업 전후에 Git(파일이 바뀐 기록을 저장해 두고 되돌릴 수 있게 하는 도구)으로 되돌림 지점을 만들어 두라는 말이에요. 코덱스가 파일을 고쳤는데 마음에 안 들 때 원래대로 돌아갈 수 있거든요. Git이 처음이면 이 습관은 나중에 익혀도 되지만, 중요한 폴더에서 일을 시킬 때는 꼭 떠올려 두세요.

코덱스는 내 컴퓨터에서 어디까지 할 수 있나요?

기본값 2개만 기억하면 돼요. 공식 권한 문서에 따르면 네트워크(인터넷 연결)는 꺼져 있고, 파일 쓰기는 현재 작업 폴더로 제한돼요. 샌드박스(실수가 번지지 않게 작업 범위를 가두는 울타리)가 처음부터 쳐져 있는 셈이에요.

CLI와 IDE의 Auto 프리셋(미리 정해진 권한 묶음)은 이렇게 움직여요.

  • 작업 폴더 안에서 파일을 읽고, 고치고, 명령을 실행하는 건 알아서 해요.
  • 폴더 밖 파일을 고치거나 네트워크를 쓰는 명령은 먼저 승인을 물어봐요.

고치는 게 불안하면 CLI에서 /permissions를 입력해 read-only(읽기 전용)로 바꿀 수 있어요. 파일을 바꾸지 않고 대화와 계획 세우기만 하는 모드예요. 처음 며칠은 이 모드로 코덱스가 폴더를 어떻게 읽는지 지켜보는 것도 좋은 방법이에요.

사용량은 어디서 확인하나요?

공식 요금 문서에 따르면 남은 사용량은 사용량 대시보드(chatgpt.com/codex/settings/usage)에서 볼 수 있고, CLI에서는 /status를 입력하면 돼요.

사용량은 5시간 구간으로 가늠하고, 주간 한도가 따로 걸릴 수도 있어요. 요금 문서는 Plus에서 5시간당 보낼 수 있는 로컬 메시지를 모델별 추정치로 보여 줘요. GPT-6.1 Sol은 15에서 160개, GPT-6.1 Terra는 35에서 285개, GPT-6 Luna는 350에서 3,000개예요. 고정 한도가 아니라 작업 크기와 모델에 따라 달라지는 추정치라는 점을 꼭 기억하세요. 2026년 11월 기준 Pro는 5시간 한도가 없다고 적혀 있어요.

사용량을 아끼는 방법도 문서에 있어요. 프롬프트를 간결하게 쓰고, 관련 파일만 가리키고, MCP(코덱스에 외부 도구를 붙이는 연결 방식) 서버 수를 줄이는 거예요. 이미지 생성은 비슷한 일반 요청보다 사용량을 평균 3배에서 5배 빨리 쓰고 Free에서는 쓸 수 없어요. ChatGPT Work와 코덱스는 사용량을 함께 쓴다는 점도 알아 두세요.

처음 하면 여기서 막힙니다

공식 문서가 직접 주의하라고 적은 지점 7개만 골랐어요.

1. 로그인 방식을 헷갈려요. 로그인 방식은 2가지이고, API 키로 로그인하면 구독 사용량이 아니라 표준 API 요금으로 과금돼요. codex login status로 지금 어떤 방식인지 볼 수 있어요. 로그아웃은 codex logout이에요.

2. 이메일과 비밀번호로 가입했는데 막혀요. 공식 인증 문서에 따르면 이메일·비밀번호로 가입한 계정은 Codex cloud를 쓰기 전에 MFA(로그인 때 한 번 더 확인하는 2단계 인증)를 설정해야 해요. 구글, 마이크로소프트, 애플 소셜 로그인은 의무가 아니라고 적혀 있어요.

3. 브라우저가 없는 원격 환경이에요. 이럴 때는 codex login --device-auth(베타)를 써요. 먼저 ChatGPT 보안 설정에서 기기 코드 로그인을 허용해 둬야 해요. 로그인 정보는 ~/.codex/auth.json에 저장될 수 있으니 비밀번호처럼 다뤄야 한다고 문서에 나와요.

4. 인터넷이 필요한 작업이 멈춰요. 네트워크가 꺼져 있는 게 기본값이에요. 네트워크를 쓰는 명령은 승인을 물어보니, 고장이 아니라 안전장치가 작동한 거예요.

5. 윈도우에서 설치가 안 돼요. 공식 윈도우 문서는 Windows 11을 권장하고, Windows 10은 1809 이상에서 best effort(최선 지원)라고 적어요. winget(윈도우 패키지 설치 도구)이 필요하고, WSL 없이 PowerShell에서 Windows 샌드박스로 돌아가요. 확장을 설치했는데 반응이 없으면 C++ 빌드 도구를 설치한 뒤 VS Code를 완전히 다시 시작하라고 안내해요.

6. IDE에서 코덱스 아이콘이 안 보여요. 공식 IDE 문서에 따르면 명령 팔레트(명령 검색창)에서 "Codex: Open Codex Sidebar"를 실행하면 돼요.

7. 한도에 닿았어요. 한도에 닿아도 진행 중이던 턴은 공정 사용 범위 안에서 마무리돼요. Plus와 Pro는 추가 크레딧을 살 수 있어요. 앞서 본 대로 사용량은 /status나 대시보드로 보세요.

마무리

오늘은 3곳 중 하나만 고르세요. 터미널이 낯설면 데스크톱 앱, 연습용 폴더 하나, 읽기만 시키는 첫 질문이면 충분해요. 코덱스가 폴더를 어떻게 읽는지 한 번 보면 그다음 요청은 훨씬 쉬워져요.

다음 걸음은 이렇게 이어가 보세요.

자주 묻는 질문

코덱스는 무료로 쓸 수 있나요?

공식 요금 문서에 Free는 월 $0로 적혀 있어요. 다만 데스크톱 앱에서만 쓰고, 순차 적용이라는 조건이 붙어 있어요. 가격과 포함 범위는 바뀔 수 있으니 공식 요금 페이지에서 직접 보세요.

터미널이 어려운데 꼭 써야 하나요?

아니요. 코덱스는 데스크톱 앱, CLI, IDE 확장 3곳에서 쓸 수 있고, 퀵스타트의 앱 흐름은 5단계 안에 터미널이 들어가지 않아요. 터미널이 낯설면 앱으로 시작하세요.

코덱스는 내 컴퓨터 어디까지 건드리나요?

공식 권한 문서 기준으로 기본값은 네트워크 꺼짐, 파일 쓰기는 작업 폴더만이에요. Auto 프리셋에서는 폴더 밖 수정과 네트워크 명령이 나오면 승인을 먼저 물어봐요. /permissions로 읽기 전용으로 바꿀 수도 있어요.

ChatGPT 계정 말고 API 키로 로그인하면 뭐가 달라지나요?

구독에 포함된 사용량 대신 표준 API 요금으로 과금돼요. 지금 어떤 방식인지는 codex login status로 볼 수 있어요. 처음 시작하는 분은 ChatGPT 계정 로그인이 더 단순해요.

사용량 한도에 닿으면 어떻게 되나요?

진행 중이던 턴은 공정 사용 범위 안에서 마무리돼요. Plus와 Pro는 추가 크레딧을 살 수 있어요. 남은 양은 대시보드나 CLI의 /status로 보고, 메시지 수는 고정 한도가 아니라 추정치라는 점을 기억해 두세요.

관련 글

참고 자료