코덱스 사용법 2026: 처음 쓰는 비개발자를 위한 앱 설치·로그인·첫 요청까지 15분 가이드
퀀텀점프클럽 정상록8 min read2 views코덱스 사용법 2026: 처음 쓰는 비개발자를 위한 앱 설치·로그인·첫 요청까지 15분 가이드
코덱스는 ChatGPT 계정 하나로 바로 쓸 수 있는 OpenAI의 코딩 AI예요. 무료 요금제에도 들어 있고, 처음이라면 ChatGPT 데스크톱 앱에서 시작하는 게 가장 쉬워요. 이 글을 끝까지 따라 하면 코덱스를 켜서 ChatGPT 계정으로 로그인하고, 내 폴더를 설명해 달라는 첫 요청까지 직접 보낼 수 있게 됩니다. 15분이면 충분해요. 설치 명령은 복사해서 붙여넣기만 하면 되고, 처음 쓰는 분들이 자주 막히는 지점은 뒤쪽에 따로 모아 두었어요.
코덱스: OpenAI가 만든 코딩 AI 에이전트예요. 에이전트는 사람 대신 여러 단계의 일을 이어서 처리하는 AI를 말해요. ChatGPT 계정으로 로그인한 뒤 데스크톱 앱이나 터미널(글자로 명령을 입력하는 검은 창), 코드 편집기에서 쓰고, 말로 부탁하면 코드를 읽고 고쳐 줘요.
코덱스는 어디에서 쓸 수 있나요?
코덱스를 여는 곳은 3곳이에요. 셋 다 같은 ChatGPT 계정으로 로그인하니까 편한 곳 하나만 고르면 돼요.
| 쓰는 곳 | 어떻게 쓰나요 | 이런 분께 |
|---|---|---|
| ChatGPT 데스크톱 앱 | macOS·Windows·Linux용 앱에서 폴더를 열고 드롭다운 메뉴(누르면 아래로 펼쳐지는 선택 목록)에서 Codex를 고름 | 처음 쓰는 분 |
| Codex CLI | 터미널에서 codex를 입력해 대화 | 명령어 입력이 익숙한 분 |
| 코드 편집기 확장 | VS Code·Cursor·Windsurf에 Codex 확장을 설치 | 코드 편집기를 쓰고 있는 분 |
CLI는 마우스 대신 글자 명령으로 쓰는 프로그램을 뜻해요. 확장은 편집기에 기능을 덧붙이는 추가 프로그램이고요. OpenAI의 IDE(코드를 쓰고 실행까지 하는 편집 프로그램) 문서에 따르면 Xcode와 JetBrains 계열 편집기는 확장 대신 자체 통합 방식으로 Codex를 지원해요.
처음이라면 데스크톱 앱을 권해요. 설치 명령을 칠 필요가 없고, 폴더를 여는 방식도 평소 쓰던 프로그램과 같거든요.
내 ChatGPT 요금제로 코덱스를 쓸 수 있나요?
대부분 쓸 수 있어요. OpenAI 공식 요금 페이지에는 "ChatGPT Work and Codex are included in your ChatGPT Free, Go, Plus, Pro, Business, Edu, or Enterprise plan"이라고 적혀 있어요. 무료부터 기업용까지 7개 요금제에 코덱스가 들어 있다는 뜻이죠.
다만 요금제마다 쓸 수 있는 곳이 달라요. 아래 금액은 공식 요금 페이지의 미국 달러 표기 기준이에요.
| 요금제 | 월 요금(공식 요금 페이지의 미국 달러 표기) | 요금 페이지에 적힌 내용 |
|---|---|---|
| Free | $0 | 데스크톱 앱에서 GPT-6 Luna, 순차 적용 |
| Go | $8 | Free와 같은 설명 |
| Plus | $20 | 웹·CLI·IDE 확장·iOS에서 Codex, GPT-6 Sol과 GPT-6 Luna |
| Pro | $100부터 | Plus보다 5배 또는 20배 많은 사용량 |
Free와 Go 항목에는 "GPT-6 Luna at Standard speed in the desktop app, subject to rollout"이라고 쓰여 있어요. 데스크톱 앱에서 GPT-6 Luna를 표준 속도로 쓸 수 있고, 모든 계정에 한꺼번에 열리지 않고 순서대로 풀린다는 말이에요. 요금 페이지의 Free·Go 항목에는 데스크톱 앱만 적혀 있으니 무료로 시작한다면 앱부터 열어 보세요. Business·Edu·Enterprise 요금은 공식 요금 페이지에서 볼 수 있어요.
API 키로 로그인하면 요금이 따로 나가요
로그인 방식은 두 가지예요. 하나는 ChatGPT 계정 로그인이에요. 다른 하나는 API 키(프로그램이 OpenAI 서비스를 쓸 때 쓰는 비밀 열쇠 문자열) 로그인이죠. OpenAI 인증 문서에 따르면 API 키로 로그인하면 요금제에 포함된 사용량이 아니라 표준 API 요금으로 따로 과금돼요. 처음이라면 ChatGPT 계정 로그인을 고르는 편이 안전해요.
한 번에 얼마나 쓸 수 있나요?
코덱스 사용량은 정해진 횟수가 아니라 5시간 구간마다 계산되는 추정치예요. 공식 요금 페이지는 이 기준을 "local messages per five-hour period"라고 적어요. 내 컴퓨터에서 보내는 메시지를 5시간 구간마다 대략 몇 개 쓸 수 있는지 어림한 값이라는 뜻이에요.
Plus 요금제 기준 추정치는 이래요.
| 모델 | 5시간 구간당 로컬 메시지 추정치(Plus) |
|---|---|
| GPT-6 Sol | 15~150 |
| GPT-6 Luna | 350~3,000 |
폭이 넓은 건 작업 크기에 따라 한 번에 쓰는 양이 달라지기 때문이에요. 이 값은 고정 한도가 아니고, 주간 한도가 추가로 적용될 수 있어요. 한도에 닿아도 진행 중이던 턴은 공정 사용 범위 안에서 마무리해 줘요. Plus와 Pro는 추가 크레딧(사용량을 더 쓰려고 사는 이용권)을 살 수 있어요.
남은 양은 사용량 대시보드(사용량을 한눈에 보여 주는 화면)나 CLI의 /status 명령에서 볼 수 있어요. 참고로 공식 요금 페이지에 따르면 GPT-5.5는 2026-10-14에 ChatGPT와 Codex의 모든 요금제에서 종료돼요. API 쪽은 영향이 없다고 적혀 있어요.
데스크톱 앱에서는 어떻게 시작하나요?
ChatGPT 데스크톱 앱은 macOS·Windows·Linux를 지원해요. 순서는 4단계예요.
- ChatGPT 데스크톱 앱을 열고 ChatGPT 계정으로 로그인해요. 이 계정의 요금제가 곧 코덱스 사용량이 되기 때문이에요.
- 코덱스에게 맡길 폴더를 열어요. 코덱스가 파일을 고치는 범위를 여기서 정하는 셈이라 순서상 먼저예요.
- 드롭다운에서 Codex를 골라요. 일반 ChatGPT 대화와 코덱스 작업을 나누는 스위치 역할이에요.
- 첫 요청을 입력해요. 아래 "첫 요청" 부분의 문장을 그대로 써도 돼요.
처음 연습할 때는 중요한 원본 대신 복사해 둔 폴더를 여는 게 마음 편해요.
터미널에서 Codex CLI는 어떻게 설치하나요?
터미널이 익숙하다면 Codex CLI도 좋아요. 설치 방법은 3가지이고, OpenAI CLI 문서와 GitHub의 공식 저장소 설명에 나온 명령을 그대로 옮겼어요.
macOS나 Linux라면 아래 명령을 터미널에 붙여넣으세요. 설치 스크립트(설치 과정을 자동으로 처리하는 짧은 프로그램)를 내려받아 실행하는 명령이에요.
curl -fsSL https://chatgpt.com/codex/install.sh | sh
Windows라면 PowerShell(윈도우에 기본으로 들어 있는 명령 입력 창)을 열고 아래 명령을 붙여넣으세요.
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
npm(자바스크립트 프로그램을 설치해 주는 도구)을 쓰고 있다면 이 방법도 돼요. 맥에서 Homebrew(맥용 프로그램 설치 도구)를 쓴다면 두 번째 줄을 쓰면 되고요.
npm install -g @openai/codex
brew install --cask codex
두 줄 중 한 줄만 실행하면 돼요.
Windows 문서에 따르면 Windows 11을 권장하고, Windows 10은 1809 버전 이상이 필요해요. Windows에서는 WSL(윈도우 안에서 리눅스를 돌리는 기능) 없이 PowerShell에서 동작해요. 설치에는 winget(윈도우용 프로그램 설치 도구)이 있어야 하고요.
로그인은 이렇게 해요
- 작업할 프로젝트 폴더로 들어가
codex를 입력해요. 코덱스는 실행한 폴더를 작업 범위로 삼기 때문이에요. - 첫 실행 화면에서 "Sign in with ChatGPT"를 골라요. 요금제에 포함된 사용량을 쓰려면 이 방식이어야 해요.
- 열린 브라우저 창에서 ChatGPT 계정으로 로그인해요. 끝나면 터미널로 돌아와 이어서 쓸 수 있어요.
- 로그인이 제대로 됐는지 확인해요. 나중에 오류가 났을 때 원인을 좁히는 첫 단서가 돼요.
확인 명령은 아래 한 줄이에요. 지금 로그인 상태를 보여 줘요.
codex login status
첫 요청은 뭐라고 보내면 되나요?
처음엔 코드를 고쳐 달라고 하기보다 폴더를 설명해 달라고 해 보세요. 공식 CLI 문서도 첫 예시로 이 문장을 들어요.
Tell me about this project
이 프로젝트에 대해 알려 달라는 뜻이에요. 코덱스가 폴더를 어떻게 이해했는지 먼저 확인하고 나서 일을 맡기면 엉뚱한 수정이 줄어요.
시작할 때 알아 두면 좋은 명령은 5개예요.
/init: AGENTS.md라는 안내 파일을 만들어요. 이 폴더에서 지킬 규칙을 적어 두는 메모장 같은 파일이에요./status: 지금 설정과 남은 사용량을 보여 줘요./permissions: 코덱스가 어디까지 해도 되는지 허용 범위를 정해요./model: 쓸 모델과 추론 강도(답하기 전에 얼마나 깊이 생각할지)를 바꿔요./review: 바뀐 내용을 검토해 줘요.
코덱스가 내 파일을 함부로 고치지는 않나요?
기본 설정은 조심스러운 쪽이에요. OpenAI 보안 문서에 따르면 기본값에서 2가지가 막혀 있어요.
- 네트워크가 꺼져 있어요. 인터넷에서 무언가를 받아 오는 명령은 바로 실행되지 않죠.
- 파일 쓰기는 현재 작업 폴더 안으로 제한돼요.
이런 울타리를 샌드박스(프로그램이 정해진 구역 밖으로 못 나가게 막는 안전장치)라고 불러요. Auto 프리셋(미리 묶어 둔 권한 설정)에서는 폴더 밖 파일을 고치거나 인터넷이 필요한 명령을 실행하기 전에 승인을 물어요.
공식 CLI 문서는 작업 전후로 Git 체크포인트를 만들어 두라고 권해요. Git(깃)은 파일의 변경 이력을 저장해 뒀다가 원하는 시점으로 되돌릴 수 있게 해 주는 도구예요. 체크포인트는 게임의 저장 지점처럼, 결과가 마음에 안 들 때 돌아갈 자리를 만들어 두는 일이죠.
처음 하면 여기서 막힙니다
X(옛 트위터)에 올라온 사용자 보고와 공식 문서를 함께 봤어요. 사용자 보고는 "이런 데서 막혔다"는 신호로만 읽어 주세요.
ChatGPT로 로그인했는데 "Incorrect API key" 오류가 떠요
2026-09-25에 여러 사용자가 같은 날 401 Unauthorized: Incorrect API key provided 오류를 보고했어요. 원인은 공식 문서에서 확인하지 못했어요. 먼저 codex login status로 어떤 방식으로 로그인돼 있는지 보고, 아래 두 줄로 다시 로그인해 보세요.
codex logout
codex login
첫 줄이 로그아웃, 둘째 줄이 다시 로그인하는 명령이에요.
사용량이 남았는데 작업이 멈춰요
2026-09-26에는 Plus 사용자가 주간 한도는 남았는데 5시간 한도 때문에 작업이 끊겼다는 보고가 있었어요. 5시간 구간과 주간 한도는 따로 적용돼요. /status로 남은 사용량을 확인해 보세요.
Windows에서 창이 열렸다 닫혀요
2026-09-26에 Windows용 CLI 새 버전에서 PowerShell과 터미널 창이 계속 열렸다 닫힌다는 보고가 올라왔어요. 2026-09-25에는 홈 폴더에서 켜면 셸(명령을 받아 실행하는 프로그램)이 열리지 않는다는 보고도 있었고요. 홈 폴더가 아니라 프로젝트 폴더로 들어가서 실행하거나, codex -C <폴더>처럼 폴더를 지정해 보세요. Windows 10이라면 1809 버전 이상인지도 확인해 두세요.
인터넷이 필요한 명령이 막혀요
기본값에서 네트워크가 꺼져 있으니 승인을 묻는 게 정상이에요. 2026-09-23에도 이 설정이 헷갈린다는 반응이 있었어요. 필요한 명령이면 승인하고, 허용 범위는 /permissions에서 조정하면 돼요.
편집기에 코덱스 아이콘이 안 보여요
명령 팔레트(편집기 기능을 이름으로 검색해 실행하는 창)를 열고 "Codex: Open Codex Sidebar"를 입력하세요. OpenAI IDE 문서가 안내하는 방법이에요.
화면 아래 "F2 to view"가 결제 안내처럼 보여요
2026-09-27에 CLI 화면의 F2 to view를 2파운드 결제로 오해했다는 글이 있었어요. 문구 그대로 읽으면 F2 키를 누르면 내용을 볼 수 있다는 안내예요.
Codex cloud로 넘어가려는데 막혀요
Codex cloud는 ChatGPT 계정 로그인이 필수예요. 이메일과 비밀번호로 가입한 계정이라면 먼저 MFA(비밀번호에 더해 인증 코드를 한 번 더 확인하는 2단계 인증)를 설정해야 해요. 구글·마이크로소프트·애플 계정으로 가입했다면 의무가 아니에요.
마무리
코덱스 사용법의 첫 단계는 생각보다 짧아요. ChatGPT 데스크톱 앱에서 로그인하고, 연습용 폴더를 열고, 드롭다운에서 Codex를 고른 뒤 "Tell me about this project"를 보내면 첫 사용이 끝나요. 15분이면 여기까지 갈 수 있어요. 익숙해지면 Codex CLI나 코드 편집기 확장으로 넓혀 가면 되고, 무언가를 고치게 하기 전에는 Git 체크포인트부터 만들어 두세요.
자주 묻는 질문
코덱스는 무료로 쓸 수 있나요?
공식 요금 페이지에 따르면 Free($0) 요금제에도 포함돼요. Free 항목에는 데스크톱 앱에서 GPT-6 Luna를 쓴다고 적혀 있고, 순차 적용 조건이 붙어 있어요.
개발자가 아니어도 쓸 수 있나요?
ChatGPT 데스크톱 앱에서는 설치 명령 없이 폴더를 열고 드롭다운에서 Codex를 고르면 시작돼요. 명령어 입력이 부담스럽다면 앱부터 써 보세요.
ChatGPT 계정 대신 API 키로 로그인해도 되나요?
로그인은 돼요. 다만 요금제에 포함된 사용량이 아니라 표준 API 요금으로 따로 과금돼요.
남은 사용량은 어디서 보나요?
사용량 대시보드나 CLI의 /status에서 봐요. Plus 기준 GPT-6 Sol은 5시간 구간당 로컬 메시지 15~150개로 추정돼요.
브라우저가 없는 원격 컴퓨터에서는 어떻게 로그인하나요?
codex login --device-auth를 써요. 베타(시험 단계) 기능이라 보안 설정에서 기기 코드 로그인을 허용해 둬야 해요.
관련 글
- 코덱스 컴퓨터 사용 체크포인트
- Codex GPT-5.6 정리
- Claude Code vs Codex vs Cursor 선택 기준
- 비개발자를 위한 클로드 코드 입문 가이드
- 챗GPT 처음 쓰는 분을 위한 가이드
