분명히 말하겠다. '그냥 Claude Code만 사용하는' 시대는 완전히 끝났다. 4월 24일, GPT-5.5의 도래와 함께 Codex의 정확도는 '차원이 다른' 수준으로 뛰어올랐다. 해외에서는 이미 'Claude Code만 따라가는 것은 기회를 놓치는 것; 이제는 Codex의 시대다'라는 글이 넘쳐나고 있다.
0:53
하지만 일본에서는 대부분의 사람들이 여전히 'Codex가 뭐지?' 또는 'GPT-5.5가 뭐가 대단한데?'라는 수준에 머물러 있다.
그래서 이 글에서는👇
・Codex가 실제로 무엇인지 설명합니다
・GPT-5.5로 무엇이 바뀌었는지 자세히 설명합니다
・Claude Code와의 근본적인 차이점을 논합니다
・초보자에게 정확히 어디서부터 시작해야 하는지 보여줍니다
이 모든 것을 처음부터 시작해도 이해할 수 있는 수준으로 풀어내겠습니다.
다음과 같은 고민이 있다면 이 글을 끝까지 읽어야 합니다👇
・Codex가 도대체 뭐지? ChatGPT랑 뭐가 다른 거지?
・GPT-5.5가 대단하다고 들었는데, 구체적으로 왜인지 모르겠어.
・이미지를 만들 수 있다고 들었는데, 어떻게 작동하는 거지?
・사용하고 싶은데, API 키나 CLI 같은 용어가 전혀 이해가 안 돼.
・비용이 얼마나 들지 몰라서 건드리기가 무서워.
이것은 거의 모든 사람들이 Codex에 관심을 갖기 시작할 때 부딪히는 벽입니다. 공식 문서는 영어로 되어 있고, 정보는 여기저기 흩어져 있으며, 어디서부터 시작해야 할지 알기 어렵습니다. 게다가 매주 새로운 모델과 도구가 나오기 때문에 따라잡는 것만으로도 지칩니다.
이 가이드를 위해 2026년 4월 29일 기준 모든 OpenAI 공식 자료, 시스템 카드, API 문서, 개발자 가이드를 읽고 'Codex × GPT-5.5 × 이미지 생성'의 큰 그림을 하나의 교과서로 정리했습니다.
앱 설치부터 프롬프트 디자인, 이미지 생성 통합, 비용 관리, IDE 통합까지—이 글을 처음부터 끝까지 읽으면 아무것도 모르는 상태에서 완전히 사용할 수 있는 상태가 됩니다👇
■ Codex란 무엇인가?
간단히 말해, OpenAI Codex는 'AI 코딩 에이전트'입니다. ChatGPT와의 차이를 간단히 말하면: ChatGPT는 '말하는 AI'이고, Codex는 '일하는 AI'입니다.
ChatGPT에게 '이 코드를 수정해 줘'라고 하면 텍스트 응답을 반환합니다. Codex는 다릅니다. 실제로 파일을 열고, 코드를 다시 작성하고, 테스트를 실행하고, 결과를 확인합니다. 읽고, 쓰고, 실행하고, 수정하는 모든 작업을 Codex가 자동으로 수행합니다.
또한, 2026년 4월의 주요 업데이트('Codex for (almost) everything')를 통해 이제 코딩이 아닌 작업도 지원합니다. Jira, Slack, Notion, Google Workspace, HubSpot 등 90개 이상의 도구와 통합할 수 있는 '거의 범용 AI 에이전트'로 진화했습니다.
Codex를 사용하는 방법은 세 가지입니다.
・Codex Desktop App ── 가장 쉬운 방법입니다. 앱을 다운로드하고 로그인하기만 하면 됩니다. 터미널 작업이 필요 없습니다. macOS와 Windows를 지원합니다.
・Codex CLI ── 터미널에서 실행되는 에이전트입니다. 오픈 소스(Apache 2.0)로 공개되었습니다. 터미널에 익숙한 분들에게 더 유연합니다.
・Codex Cloud ── 클라우드에서 백그라운드로 작업을 실행합니다. 여러 작업을 병렬로 실행하거나 GitHub 저장소와 통합하는 데 좋습니다. 팀 개발을 대상으로 합니다.
초보자는 'Desktop App'으로 시작하는 것이 좋습니다. 터미널을 전혀 사용하지 않고 시작할 수 있습니다.
■ 시작하기 (Desktop App 편)
시작하는 가장 간단한 방법은 데스크톱 앱을 다운로드하는 것입니다.
Mac의 경우:
Mac App Store 또는 Homebrew를 통해 설치합니다:
brew install --cask codex
Windows의 경우:
Microsoft Store에서 'Codex'를 검색하여 설치합니다.
앱을 열면 ChatGPT 계정으로 로그인하기만 하면 됩니다. 인증을 위해 브라우저가 열리며, 즉시 사용할 수 있습니다. API 키 설정이 필요하지 않습니다.
네, ChatGPT 계정이 있다면 그대로 로그인할 수 있습니다. Free 플랜도 괜찮습니다.
앱이 열리면 다음과 같은 것을 시도해 보세요:
"이 폴더에 있는 파일 목록을 보여 줘"
"이 코드에서 버그를 찾아서 수정해 줘"
"README.md 파일을 만들어 줘"
Codex는 파일을 읽고, 생각하고, 실행하고, 결과를 반환합니다. 이 시점에서 '아, 이건 ChatGPT와 완전히 다르구나'라고 깨닫게 될 것입니다.
■ 시작하기 (CLI 편)
터미널에 익숙한 분들을 위해 Codex CLI는 더 많은 유연성을 제공합니다.
설치:
npm i -g @openai/codex
macOS의 경우:
brew install codex
인증:
codex auth
→ 브라우저가 열리며 ChatGPT 계정으로 로그인하거나 API 키를 입력합니다.
확인:
codex "Please introduce yourself in English."
응답이 오면 성공입니다. 그게 전부입니다.
인증에 API 키를 사용하는 경우 환경 변수로 설정하는 것이 편리합니다:
export OPENAI_API_KEY="sk-xxxxxxxx"
이것을 ~/.zshrc (Mac) 또는 ~/.bashrc (Linux)에 추가하면 매번 입력할 필요가 없습니다.
API 키는 platform.openai.com의 Dashboard → 'API Keys' → 'Create new secret key'에서 발급할 수 있습니다. 키는 한 번만 표시되므로 안전하게 복사하여 보관하세요. 절대 공유하거나 GitHub에 푸시하지 마세요.
■ 설정 파일 생성
Codex의 동작을 사용자 정의하려면 ~/.codex/config.toml을 생성하세요. 이는 데스크톱 앱과 CLI 모두에 공통입니다.
1model = "gpt-5.5"2approval_policy = "on-request"3sandbox_mode = "workspace-write"
각 설정의 의미:
model ── 사용할 모델입니다. gpt-5.5가 최고 성능입니다. 비용을 절약하려면 gpt-5.4도 옵션입니다.
approval_policy:
・'untrusted' ── 읽기 전용 명령만 자동으로 실행합니다. 그 외의 모든 것은 확인을 요청합니다 (가장 안전함).
・'on-request' ── 필요에 따라 확인을 요청합니다 (권장).
・'never' ── 확인 없이 모든 것을 실행합니다 (고급 사용자용).
sandbox_mode:
・'read-only' ── 파일 읽기만 가능.
・'workspace-write' ── 워크스페이스 내 읽기/쓰기 + 명령 실행 (권장).
・'danger-full-access' ── 제한 없음 (위험함, 일반적으로 사용하지 않음).
초보자는 on-request + workspace-write로 시작해야 합니다. Codex는 실행 전에 '이 작업을 수행해도 될까요?'라고 물어 예상치 못한 작업을 방지합니다.
■ GPT-5.5란 무엇인가? ('가장 강력하다'고 불리는 이유)
GPT-5.5는 2026년 4월 23일에 출시된 OpenAI의 최신 플래그십 모델입니다. 코드명 'Spud'로, OpenAI는 이를 '가장 복잡한 비즈니스 작업'을 위한 모델로 포지셔닝했습니다.
GPT-5.5는 Codex가 내부적으로 사용하는 모델이며, Codex의 '권장 모델'입니다. 즉, Codex가 놀라운 이유는 GPT-5.5가 놀랍기 때문입니다.
구체적인 수치를 살펴보겠습니다.
- 컨텍스트 윈도우: 1,050,000 토큰
한 번에 읽을 수 있는 데이터 양이 차원이 다릅니다. 약 800,000 일본어 문자에 해당합니다. 일반적인 단행본이 약 100,000자이므로 한 번에 8권의 정보를 처리할 수 있습니다. 대규모 코드베이스 전체를 넣고 '여기서 버그를 찾아 줘'라고 할 수 있는 수준입니다.
- 최대 출력: 128,000 토큰
이전 모델에서는 '중간에 끊기거나' '계속'이라고 요청해야 하는 경우가 있었지만, GPT-5.5에서는 그런 걱정이 거의 사라졌습니다. 긴 코드나 문서를 한 번에 생성할 때 매우 유용합니다.
- 멀티모달 지원
텍스트뿐만 아니라 이미지, 오디오, 비디오를 입력으로 처리할 수 있습니다. UI 스크린샷을 보여주고 '이 디자인을 다시 만들어 줘'라고 하거나, 손글씨 메모 사진을 넘겨주고 '이것을 텍스트로 변환해 줘'라고 할 수 있습니다. 이러한 모든 사용 사례가 가능합니다.
- 추론 노력 조정
다섯 단계: none / low / medium / high / xhigh. 기본값은 medium입니다. 간단한 작업에는 low를 사용하여 빠른 응답을 받고, 깊은 사고가 필요한 복잡한 작업에는 high를 사용하세요. 비용은 추론 노력에 비례하므로 상황에 따라 전환하는 것이 중요합니다.
- 벤치마크
・Terminal-Bench 2.0 (에이전트 자동화) ── GPT-5.5: 82.7% (1위), Claude Opus 4.7: 69.4%
・GPQA Diamond (대학원 수준 지식) ── GPT-5.5: 93.6%, Claude Opus 4.7: 94.2%, Gemini 3.1 Pro: 94.3%
・SWE-Bench Pro (소프트웨어 엔지니어링) ── GPT-5.5: 58.6%, Claude Opus 4.7: 64.3%
82.7%의 Terminal-Bench 점수는 특히 중요합니다. 이는 '에이전트로서 작업을 자동으로 완료하는 능력'의 지표로, Codex와 같은 에이전트 기반 개발에 직접적인 영향을 미칩니다. 모든 카테고리에서 이기는 모델은 없지만, 자동화 목적으로는 Codex × GPT-5.5 조합이 현재 가장 강력합니다.
■ gpt-image-2와의 통합 (원활한 이미지 생성)
GPT-5.5와 같은 주(2026년 4월 21일)에 출시된 것은 'gpt-image-2'(ChatGPT Images 2.0)입니다.
이 모델의 놀라운 점은 이미지 내에서 일본어 텍스트를 정확하게 렌더링할 수 있다는 것입니다. 이전에는 AI 이미지에서 일본어 문자가 깨지는 것이 일반적이었지만, gpt-image-2는 12개 이상의 언어에서 95% 이상의 문자 수준 정확도를 달성합니다. 포스터, 로고, 다이어그램 등 일본어에서도 깨지지 않습니다.
그리고 가장 큰 장점은 Codex와의 통합 용이성입니다. Codex에서 gpt-image-2를 호출하기 위해 특별한 설정이 필요하지 않습니다. 예를 들어:
"이 앱의 아이콘에 대한 패턴 3개를 만들어서 assets 폴더에 저장해 줘"
"이 데이터를 기반으로 다이어그램을 만들어 줘"
"랜딩 페이지용 히어로 이미지를 생성해 줘"
이것만으로도 Codex가 이미지 생성부터 파일 저장까지 모든 것을 처리합니다. 코드를 작성하다가 '여기에 다이어그램이 필요해'라고 생각하면 바로 그 자리에서 지시할 수 있습니다. 워크플로우가 중단되지 않는다는 점이 엄청나게 편리합니다.
하나의 프롬프트에서 최대 8개의 일관된 이미지 생성, 최대 16개의 참조 이미지에서 편집, 최대 3840px의 고해상도 출력을 지원합니다. 이미지 생성 비용은 해상도와 품질에 따라 이미지당 약 $0.006 ~ $0.21입니다.
■ 가격 (비용 정확히 이해하기)
AI 개발을 시작할 때 가장 큰 걱정은 비용입니다. 모호하게 남겨두지 말고 명확히 이해하세요.
먼저, ChatGPT 구독(Free / Go / Plus / Pro)을 통해 Codex를 사용하는 경우와 API를 직접 호출하는 경우의 청구 구조가 다릅니다.
ChatGPT 플랜을 통한 경우 (초보자는 여기서 시작):
・Free ($0) ── GPT-5.5 사용 가능. Codex 제한 시간 동안 사용 가능.
・Go ($8/월) ── GPT-5.5 사용 가능. Codex 제한 시간 동안 사용 가능.
・Plus ($20/월) ── GPT-5.5 사용 가능. Codex 사용 가능.
・Pro ($100–$200/월) ── GPT-5.5 Pro를 포함한 모든 기능.
처음에는 Free 플랜을 시도해보고, 본격적으로 사용할 때 Plus($20/월)로 업그레이드하는 것을 추천합니다. GPT-5.5와 Codex를 월 $20에 사용할 수 있다는 것은 훌륭한 가치입니다.
직접 API 사용 (중급 이상):
・GPT-5.5 ── 입력 $5.00 / 출력 $30.00 (1M 토큰 기준)
・GPT-5.4 ── 입력 $2.50 / 출력 $15.00
・GPT-5.3 ── 입력 $1.75 / 출력 $14.00
GPT-5.5는 5.4보다 두 배 비쌉니다. 현명한 사용 방법은 '보통 5.4를 사용하고, 복잡한 처리에만 5.5를 사용'하는 것입니다.
할인 옵션도 있습니다:
・Batch ── 표준보다 50% 할인. 실시간 응답이 필요 없는 작업용.
・Flex ── 역시 50% 할인. 대기 시간이 변동되는 대신 저렴합니다.
긴 컨텍스트 사용(272,000 토큰 초과 입력)은 입력 2배, 출력 1.5배의 비용이 발생합니다. 대량의 코드를 전달할 때 염두에 두세요.
■ Python / Node.js SDK (직접 API 사용용)
Codex CLI나 앱을 사용하지 않고 자체 코드에서 GPT-5.5 API를 직접 호출하려면 SDK를 설치하세요.
Python:
pip install openai
1from openai import OpenAI2client = OpenAI()3response = client.responses.create(4 model="gpt-5.5",5 reasoning={"effort": "medium"},6 input="파이썬으로 피보나치 수열을 계산하는 함수를 작성해 주세요."7)8print(response.output_text)
Node.js:
npm install openai
1import OpenAI from "openai";2const client = new OpenAI();3const resp = await client.responses.create({4 model: "gpt-5.5",5 reasoning: { effort: "medium" },6 input: "Express.js로 간단한 API 서버를 만들어 주세요."7});8console.log(resp.output_text);
자체 앱에 GPT-5.5를 '임베드'하고 싶을 때 사용합니다. 처음 시작하는 분들은 Codex CLI나 데스크톱 앱으로 충분합니다.
■ 로컬 vs 클라우드 (차이점)
Codex에는 로컬 실행과 클라우드 실행의 두 가지 모드가 있습니다.
로컬 실행은 데스크톱 앱이나 CLI에서 직접 모델을 호출합니다. 로컬 파일을 자동으로 컨텍스트로 사용하여 최소한의 프롬프트로 효율적입니다. 빠르며 개인 개발이나 빠른 수정에 적합합니다.
클라우드 실행(Codex Cloud)은 클라우드에서 백그라운드로 작업을 실행합니다. 병렬 작업, GitHub 통합, 팀 개발에 강점이 있습니다. ChatGPT 계정으로 로그인해야 합니다.
초보자는 로컬로 시작하고, 익숙해지면 클라우드를 시도해 보세요.
OS별 포인트:
・macOS ── 데스크톱 앱, CLI, IDE 확장 모두 지원. 가장 완벽한 환경.
・Windows ── 데스크톱 앱, CLI, IDE 확장 지원. Windows 11 + WSL2 권장.
・Linux ── 데스크톱 앱 미지원. CLI와 IDE 확장 사용 가능.
■ IDE 통합
앱과 터미널 외에도 에디터 내에서 직접 Codex를 사용할 수 있습니다.
VS Code:
Marketplace에서 'Codex - OpenAI's coding agent'를 설치하세요. Claude Code나 GitHub Copilot과 함께 사용할 수 있습니다.
열려 있는 파일이나 선택한 코드를 자동으로 컨텍스트로 사용하므로 복사-붙여넣기 없이 프롬프트를 작성할 수 있습니다.
확장 프로그램 내에서 다음을 할 수 있습니다:
・모델 전환 (GPT-5.5 ↔ 5.4 ↔ 5.3)
・추론 노력 수준 변경
・승인 모드 전환
・Cloud 환경에 연결
JetBrains (IntelliJ, PyCharm, WebStorm 등):
2026년 1월부터 네이티브 통합 제공. IDE 버전 2025.3 이상에서 사용 가능.
■ 프롬프트 디자인 (프롬프트 작성이 결과를 바꾼다)
GPT-5.5를 사용할 때 가장 큰 차이는 프롬프트 작성 방법에서 비롯됩니다. 동일한 모델이라도 프롬프트에 따라 출력 품질이 완전히 달라집니다.
GPT-5.5의 경우 다음 4가지 요소를 포함한 구조화된 프롬프트가 권장됩니다:
・Goal ── 달성하려는 것
・Context ── 상황 또는 환경
・Constraints ── 하지 말아야 할 것 또는 제한 사항
・Done when ── '완료'를 정의하는 것
예시:
Goal: 사용자 등록 API 엔드포인트를 생성한다.
Context: Python + FastAPI + PostgreSQL. 기존 users 테이블에 INSERT한다.
Constraints: 추가 외부 라이브러리 사용 금지. bcrypt로 비밀번호 해싱. 이메일 중복 확인 필수.
Done when: POST /users로 JSON(name, email, password)을 전송하면 사용자가 생성되고 201을 반환한다. 중복 이메일은 409를 반환한다.
'사용자 등록 API를 만들어 줘'라고만 해도 작동하지만, 위와 같이 작성하면 정확도가 크게 향상됩니다. 왔다 갔다 하는 횟수가 줄어들어 결국 더 빠릅니다.
추론 노력 선택:
・none / low ── 간단한 변환이나 일상적인 작업. 가장 빠른 응답.
・medium ── 일반적인 코딩 또는 Q&A (기본값).
・high ── 복잡한 알고리즘 설계 또는 디버깅.
・xhigh ── 최고 난이도의 에이전트 작업.
비용은 노력에 비례하므로 모든 것을 xhigh로 설정하는 것은 비효율적입니다. 작업에 맞는 수준을 선택하세요.
■ 디버깅 및 테스팅
코드 작성 후에는 디버깅과 테스팅이 이어집니다. Codex + GPT-5.5는 여기서도 빛을 발합니다.
디버깅의 요령은 에러 로그를 그대로 전달하는 것입니다.
'작동하지 않아' → NG
'pytest에서 RuntimeError 발생. 스택 트레이스: (전체 에러). 수정해 주세요.' → OK
GPT-5.5는 1,050,000 토큰 컨텍스트를 가지고 있으므로 긴 로그도 문제없습니다. 사실 정보가 많을수록 좋습니다.
Codex CLI를 사용하여 프로젝트 폴더에서:
codex "Investigate why this test is failing and fix it. Confirm that the test passes."
Codex는 파일을 읽고, 테스트를 실행하고, 에러를 분석하고, 수정하고, 테스트를 다시 자동으로 실행합니다. 이것이 '일하는 AI'의 본질입니다.
테스트 생성도 맡길 수 있습니다:
codex "Write pytest tests for the register_user function in src/auth/register.py. Include three patterns: success, error, and validation."
테스트 파일 생성부터 실행 확인까지 모든 것을 처리합니다.
■ 보안
Codex는 2계층 보안 구조를 가지고 있습니다.
① 샌드박스 모드 ── 기술적으로 '할 수 있는' 범위를 제한합니다. workspace-write를 사용하면 워크스페이스 외부의 어떤 것도 건드릴 수 없습니다.
② 승인 정책 ── 경계를 넘는 작업 전에 '이 작업을 수행해도 될까요?'라고 묻습니다. 의도하지 않은 작업을 방지합니다.
Codex Cloud는 격리된 OpenAI 관리 컨테이너에서 실행되므로 호스트 시스템에 접근할 수 없습니다. 로컬 CLI/IDE 확장 프로그램도 OS 수준에서 샌드박스로 강제됩니다.
초보자는 on-request + workspace-write로 시작하면 안전합니다.
■ 실제 사용 사례
OpenAI 직원의 85%가 매주 Codex를 사용하는 것으로 알려졌습니다.
・재무 팀 ── Codex로 24,771개의 K-1 세금 문서(71,637페이지) 검토를 처리했습니다. 전년보다 2주 일찍 완료했습니다.
・마케팅 팀 ── 주간 업무 보고서 생성을 자동화했습니다. 주당 5~10시간 절약.
・개발자 사례 ── 하나의 프롬프트로 단일 HTML 파일에 픽셀 아트 게임을 생성했습니다. Express.js와 테스트 스위트를 사용한 이커머스 CRUD API 자동 생성.
코드 작성뿐만 아니라 자료 분석, 보고서 작성, 데이터 정리까지—현재 Codex의 강점은 '지식 작업의 자동화'입니다.
■ 요약 ── 제로에서 Codex 마스터로 가는 로드맵
이것이 Codex × GPT-5.5 × gpt-image-2의 큰 그림입니다.
Step 1 (이해) ── Codex가 무엇인지 알기.
→ ChatGPT는 '말하는 AI', Codex는 '일하는 AI'.
Step 2 (시작) ── 데스크톱 앱을 다운로드하고 로그인.
→ 5분 안에 시작. 터미널 필요 없음.
Step 3 (기본) ── 4요소 프롬프트 사용 (Goal/Context/Constraints/Done when).
→ 모호하게 작성하지 말고 완료 조건을 명시하는 습관을 들이세요.
Step 4 (실습) ── 디버깅을 위한 에러 로그 전달 + 테스트 자동 생성 + IDE 통합.
→ 개발 사이클에 Codex를 통합하세요.
Step 5 (비용 최적화) ── 일반 작업에는 GPT-5.4, 복잡한 작업에는 GPT-5.5 사용.
→ Batch와 Flex를 활용하여 50% 할인.
Step 6 (고급) ── gpt-image-2로 이미지 생성, Cloud에서 병렬 작업, 플러그인으로 자동화.
→ 코딩을 넘어 사용 범위 확장.
Step 2부터 시작하세요. 앱을 다운로드하고 로그인하여 한 가지를 시도해 보세요. 5분 안에 시작할 수 있습니다. 일단 실행해 보면 나머지는 진행하면서 배울 수 있습니다.
Codex는 여전히 진화하고 있습니다. 2026년 초부터 거의 매월 주요 업데이트가 있었습니다. 따라서 지금 기본을 잡고 변화에 적응할 수 있는 기초를 다지는 것이 중요합니다.
이 글이 도움이 되셨다면:
Codex Studio (@Codestudiopjbk)는 세 명의 Codex 애호가가 운영하는 계정입니다. 매일 실용적인 CLI 사용법과 자동화에 대해 게시합니다.
다음에 대해 게시합니다:
・GPT-5.5와 OpenAI Codex를 사용한 실제 제품 개발 사례
・Codex 사용법 / CLI 자동화 / 개발 동향
・GPT-5.5 및 Codex에 관한 최신 해외 정보
개발 철학부터 설계, 구현, 개선까지, 1차 정보와 해외 정보를 요약하여 실제 작동하는 제품을 출시할 수 있도록 돕습니다.
관심 있으시면 팔로우해 주세요! 개발 상담은 DM으로 보내주세요.
