OpenAI Codex란? 2026년 초보자 가이드

- Codex에 관한 사실은 빠르게 바뀌어요(모델 등급, 요금, 문서 도메인 등). 아래 내용은 모두 작성 시점의 공식 문서와 대조 확인했지만, 특정 숫자에 의존하기 전에 최신 문서에서 확인하세요.

OpenAI Codex란?

OpenAI Codex는 OpenAI의 에이전트형 코딩 제품이에요. 코드베이스를 읽고, 변경을 계획하고, 파일을 편집하고, 테스트나 린터를 실행하고, 풀 리퀘스트를 열어요. 작업을 맡기고 나면 대부분을 거의 스스로 처리해요. 이것이 기억해 둘 만한 핵심 정의이고, Codex가 자동완성보다 신입 엔지니어에 더 자주 비유되는 이유예요.

Codex는 동일한 기반 에이전트를 공유하는 세 가지 형태로 제공돼요. 터미널에서 실행하는 명령줄 도구, 웹·GitHub·Slack·Linear에서 병렬 샌드박스를 띄우는 클라우드 서비스, 그리고 VS Code와 JetBrains용 IDE 확장이에요. "이 모듈에 테스트를 추가해줘", "실패하는 CI 작업을 고쳐줘", "이 엔드포인트를 이전하는 PR을 열어줘" 같은 지시를 주면, 개발자가 하듯이 저장소를 헤쳐 나가요. 파일을 읽고, 편집하고, 명령을 실행하고, 결과를 확인하고, 반복해요.

이것은 OpenAI가 만들었고, GPT-5.6 계열 모델(자세한 내용은 아래에서)로 동작하며, 별도 제품으로 판매되는 대신 ChatGPT 요금제에 포함돼 있어요. GitHub Copilot의 초기 역사라는 맥락에서만 "Codex"라는 이름을 들어봤다면, 그것은 다른, 이미 종료된 제품이에요 - 다음에서 다룰게요.

이미 Claude Code를 쓰는 팀이라면 이 개념은 그대로 옮겨와요. 같은 "루프 안의 에이전트" 패턴이고, 공급업체와 기본값만 달라요.

2021년 Codex 모델과는 다른 제품

"Codex"라는 이름은 재활용된 것이고, 그것이 실제 혼란을 일으켜요 - Wikipedia조차 이 이름에 대해 별도의 동음이의 페이지 두 개를 유지하고 있는데, 사람들이 이 둘을 얼마나 자주 혼동하는지를 알 수 있어요.

원래의 Codex는 GPT-3에서 파생돼 공개 코드로 파인튜닝된 2021년의 OpenAI 모델이었어요. GitHub Copilot의 가장 초기 버전과 OpenAI 자체의 Codex API를 구동했지만, 이후 더 새로운 모델로 대체되어 지원이 중단됐어요.

오늘 설치하게 될 Codex는 2025년 이후의 에이전트 제품이에요. 코드베이스가 다르고, 상호작용 모델도 다르며(자동완성 API가 아니라 CLI/클라우드/IDE 에이전트), 기반이 되는 모델 계열도 완전히 달라요. 어떤 글이나 영상, 포럼 게시물이 Codex를 "제안을 받기 위해 호출하는 코드 자동완성 API"라고 설명한다면, 그것은 거의 틀림없이 종료된 2021년 제품을 가리키는 것이고, 이 가이드가 다루는 제품이 아니에요.

Codex 대 AgentKit 대 OpenAI AgentKit - 헷갈리지 마세요

이것은 모든 Codex 가이드가 건너뛰는 섹션이고, 실제로 혼란이 가장 많이 생기는 지점이에요. 세 제품이 겹치는 이름을 공유해요. 확실히 구분하세요.

짚고 넘어갈 점이 있어요. OpenAI는 2026-06-03에 Agent Builder와 Evals를 단계적으로 종료한다고 발표했어요(서비스 종료는 2026-11-30, Evals는 2026-10-31에 읽기 전용 전환). ChatKit과 Connector Registry는 유지돼요. 이에 의존하기 전에 OpenAI의 지원 중단 페이지에서 확인하세요 - 다만 이 글을 쓰는 시점에는, 이 이름을 지닌 제품 중 서드파티 AgentKit(agentkit.best)이 더 활발히 유지 관리되고 있다는 뜻이에요.

전체 내용을 자세히 보고 싶다면 OpenAI AgentKit 대 AgentKit을 참고하세요. 서드파티 키트가 실제로 어떻게 Codex에 결합되는지는 Codex 안에서 AgentKit 사용하기 또는 AgentKit 리뷰를 참고하세요.

Codex를 실행하는 세 가지 방법 - CLI, 클라우드, IDE

Codex는 하나의 에이전트이지만, 작업에 따라 세 가지 다른 형태로 접근할 수 있어요.

CLI는 대부분의 개발자가 처음 시작하는 형태이고, 이 클러스터에서 가장 깊이 다루는 형태예요 - 전체 Codex CLI 설치 가이드를 참고하세요. 설치 자체는 단일 셸 명령이고(별도로 관리할 런타임이 없음), 이것이 이미 Claude Code의 CLI를 쓰던 개발자들 사이에서 빠르게 퍼진 이유 중 하나예요.

클라우드는 사람들이 가장 놀라는 형태예요. 하나의 에이전트가 한 번에 하나의 작업을 처리하는 대신, GitHub 이슈나 Slack 메시지, 웹 앱에서 여러 작업을 시작할 수 있고, 각 작업이 자체 격리된 샌드박스에서 실행돼요. 이것은 의존성 올리기, 작은 버그 수정, 상용구 PR처럼 계속 지켜볼 필요가 없는, 작고 병렬화하기 좋은 작업에 유용해요. 전체 안내는 Codex Cloud 가이드를 참고하세요.

IDE 확장은 긴 작업을 실행하는 장소로서보다는, Codex가 이미 한 일을 에디터를 떠나지 않고 인라인으로 검토하는 장소로서 더 중요해요.

Codex를 구동하는 모델 - GPT-5.6 (Sol / Terra / Luna)

Codex는 OpenAI의 GPT-5.6 모델 계열로 동작하며, 이 모델은 2026-07-09에 일반 공급이 시작됐어요 - 이것은 이 페이지에서 가장 신선한 사실이므로, 확인 필요 항목으로 다루고 다른 곳에서 인용하기 전에 openai.com/index/gpt-5-6/를 확인하세요.

GPT-5.6은 비공식적으로 Sol, Terra, Luna라고 불리는 세 등급으로 제공되며, 속도·비용과 추론의 깊이를 맞바꿔요. 상위 등급은 더 오래 생각해서 더 어려운 리팩터링을 처리하고, 하위 등급은 더 빨리 답하며 일상적인 편집에 사용량 예산을 덜 써요. Codex는 합리적인 기본값을 고르고, 빠른 수정인지 대규모 이전인지에 따라 등급을 바꿀 수 있게 해줘요.

정확한 크레딧 요율과 등급별 요금은 자주 바뀌기 때문에, 여기서 고정하기보다 숫자와 함께 Codex 요금 가이드에서 따로 다뤄요.

Codex 비용은 얼마인가요?

Codex에는 별도의 가격표가 없어요. ChatGPT 요금제에 포함돼 있어서, 지불하는 금액은 이미 가입한(또는 업그레이드할) 요금제의 금액 그대로예요.

이 표를 바탕으로 예산을 짜기 전에 두 가지를 짚어둘게요. 첫째, 가격과 사용 한도는 바뀌어요 - 이것은 확인 필요 숫자이니, 확정하기 전에 learn.chatgpt.com/codex/pricing을 확인하세요. 둘째, "사용량"은 어느 등급에서도 무제한이 아니에요. 무거운 GPT-5.6 등급(특히 Sol)은 가벼운 것보다 예산을 더 빨리 소진하는데, 이것이 앞 섹션의 등급 선택기가 중요한 진짜 이유예요. 등급과 요금제별 현재 전체 내역은 Codex 요금 가이드를 참고하세요.

Codex 설정 & 신뢰 - AGENTS.md, 샌드박스, Skills

세 가지 설정이 Codex가 프로젝트에 대해 얼마나 알고, 얼마나 손댈 수 있는지를 결정해요. 각각 별도의 심층 안내가 있는데, 여기서는 각 항목의 요점만 정리할게요.

AGENTS.md. Codex는 프로젝트 지시를 AGENTS.md에서 읽으며, 다음 순서로 찾아요. ~/.codex/AGENTS.override.md, 그다음 ~/.codex/AGENTS.md, 이어서 git 루트부터 현재 폴더까지 디렉터리별 파일이에요. 루트에서 아래로 이어 붙이고, 더 가까운 파일이 덮어써요. 크기 상한이 있고(기본값 32 KiB), 그리고 - Claude Code도 함께 쓴다면 알아둘 점으로 - Codex는 CLAUDE.md를 읽지 않아요. 자세한 내용은 Codex용 AGENTS.md 가이드에 있어요.

샌드박스와 승인. Codex에 파일 시스템 접근을 얼마나 줄지(read-only, workspace-write(기본값), 또는 danger-full-access), 그리고 행동하기 전에 얼마나 자주 물어봐야 하는지(untrusted, on-request, 또는 never)를 고를 수 있어요. 이것을 실제 안전 경계로 삼으세요. 손대면 안 되는 것에 Codex가 손대지 않도록 막으려고 프롬프트 문구에만 의존하지 마세요. 자세한 내용은 샌드박스 및 승인 모드에 있어요.

Skills. Codex는 SKILL.md 기반 스킬을 지원하고, 그 형식은 Claude Code의 스킬과 상호 호환돼요 - 한 번 작성하면 두 도구에서 다 쓸 수 있어요. 여기서 정확한 공식 카탈로그 링크를 단정하지 않는 이유는, OpenAI 자체의 스킬과 플러그인 저장소가 둘 다 보관 처리(archived)됐기 때문이에요. 안전한 참조처는 최신 문서 허브예요. 자세한 내용은 Codex Skills 설명에 있어요.

이 세 가지 중 어느 것도 판단을 대신하지 않아요. AGENTS.md는 프로젝트가 무엇을 기대하는지 Codex에 알려주고, 샌드박스 설정은 작업에 필요하다고 Codex가 생각하든 말든 무엇이 허용되는지 알려주며, 스킬은 재사용 가능한 실행 지침을 줘요. 샌드박스 설정을 잘못하면 나머지 둘이 구해주지 못해요.

코드 검토 & 빠른 명령

Codex에는 내장 /review 명령이 있고, 차이(diff), 커밋하지 않은 변경, 특정 커밋, 또는 사용자 지정 범위를 검토하는 프리셋이 있어요. GitHub 풀 리퀘스트를 검토하려면 특히 gh CLI가 설치되고 인증돼 있어야 해요. 이것은 푸시하기 전에 변경을 한 번 더 훑는 빠른 방법이고, Codex가 생성한 코드뿐 아니라 직접 쓴 코드에도 실행할 가치가 있어요. 전체 안내는 Codex 코드 검토 가이드에 있어요.

/review 외에도 Codex에는 매번 찾아보기보다 외워둘 만한 슬래시 명령들이 있어요 - 최신 목록은 Codex CLI 치트 시트에서 관리하고 있어요.

Codex 대 Claude Code, GitHub Copilot, Gemini CLI

Codex가 유일한 에이전트형 코딩 도구는 아니에요. 하나를 고르는 일은 어느 것이 "최고인가"보다 어느 것이 내 스택에 맞는가의 문제예요. 여기서는 일부러 결론을 내지 않아요 - 각 비교는 저마다 전용 페이지가 있고, 아래에 링크했어요.

이미 Claude Code를 쓰고 있고 Codex를 추가할 만한지 고민 중이라면, 직접 비교는 Claude Code 대 Codex에 있어요. 결론은 그 페이지가 담당하고, 이 페이지는 전체 지형만 보여줘요. 나머지 둘과의 전용 맞대결은 Codex 대 GitHub Copilot과 Codex 대 Gemini CLI에 있어요.

Codex 안에서도 AgentKit을 실행할 수 있어요

여기서 경계는 흐려지기 쉬우니 분명히 해둘게요. Codex 그 자체 - CLI, 클라우드 샌드박스, /goal 자율 모드 - 는 무료(또는 요금제 포함)이고 OpenAI가 만든 것이에요. 이 섹션의 어떤 것도 Codex를 쓰는 데 필수는 아니에요.

AgentKit은 별도의 유료 애드온이에요(agentkit.best, OpenAI와 무관). 미리 만들어진 스킬, 서브에이전트, 워크플로를 Codex 위에 설치해요. 확인된 방식은 이래요. ak kit init engineer --target codex로 설치하고(사용자 전역 설치는 --global 추가), 그다음 Codex 세션 안에서 $ak:cook ...로 키트 명령을 실행해요($ 접두사에 주의 - Claude Code는 대신 /ak:cook을 써요). Codex에서는 특히 전달이 네이티브예요. 스킬, 규칙, 에이전트 디스패치는 동작하고, 훅은 부분적이며, Claude Code에 있는 것 같은 상태 표시줄이나 대화형 키트 명령 메뉴는 없어요.

그 가격만큼 값어치가 있는지는, 그 발판 중 얼마나 많은 것을 직접 만들었어야 하는지에 달려 있어요. 이미 자신만의 AGENTS.md 관례와 검토 습관이 있다면 필요하지 않을 수도 있어요. 텅 빈 Codex 설치에서 시작해 첫날부터 동작하는 스킬 세트와 코드 검토 게이트를 원한다면, 그것이 진짜 가치 제안이에요 - 전체 그림은 AgentKit 리뷰를, 설정 세부 사항은 AgentKit-in-Codex 가이드를 참고하세요.

자주 묻는 질문(FAQ)

OpenAI Codex는 무료인가요?

별도의 유료 제품이 아니에요 - 제한된 무료 등급을 포함해 ChatGPT 요금제에 포함돼 있어요. 더 많이 쓰려면 유료 요금제(Go, Plus, Pro, 또는 Business)가 필요하고, 사용 한도는 등급과 어떤 GPT-5.6 모델 등급을 고르느냐에 따라 달라요. 현재 숫자는 learn.chatgpt.com/codex/pricing에서 확인하세요.

이것은 2021년의 그 Codex와 같은 건가요?

아니에요. 2021년 Codex는 GPT-3 기반의 코드 자동완성 모델로, 초기 GitHub Copilot을 구동했지만 이후 지원이 중단됐어요. 이 가이드가 다루는 Codex는 다른 코드베이스와 다른 상호작용 모델을 가진 2025년 이후의 에이전트 제품이에요.

Codex 대 ChatGPT - 무엇이 다른가요?

ChatGPT는 범용 채팅 어시스턴트예요. Codex는 같은 기반 모델 위에 만들어진 코딩 에이전트 제품으로, CLI, 클라우드 샌드박스, 또는 IDE 확장을 통해 접근하며, 채팅 창에서 질문에 답하기만 하는 게 아니라 저장소 안에서 직접 행동해요.

Codex에 파일을 편집하게 해도 안전한가요?

샌드박스를 올바르게 설정하면 안전할 수 있어요. Codex의 workspace-write 기본값과 승인 프롬프트(untrusted/on-request/never)가 실제 안전 경계예요 - 운영 자격 증명이 있는 컴퓨터에서는 절대 danger-full-access를 주지 말고, 프롬프트 지시만으로 범위 밖으로 벗어나는 것을 막을 수 있다고 가정하지 마세요.

Windows에서 Codex를 쓸 수 있나요?

네. Codex CLI는 Windows, macOS, Linux에서 설치되고 실행되며, 클라우드와 IDE 형태도 함께 이용할 수 있어요.

Codex와 AgentKit의 차이는 무엇인가요?

Codex는 OpenAI의 코딩 에이전트예요. AgentKit(agentkit.best)은 미리 만들어진 스킬과 워크플로를 Codex 안에(그리고 Claude Code 안에) 설치하는 별도의 유료 서드파티 애드온이에요. 둘은 서로 다른 회사가 만들었고, AgentKit은 선택 사항이에요 - Codex는 그것 없이도 완전히 동작해요.

결론 - 다음으로 갈 곳

OpenAI Codex는 코딩 에이전트이지, 같은 이름의 2021년 모델도 아니고, 같은 대화에 떠도는 두 "AgentKit" 제품 중 어느 것도 아니에요. CLI, 클라우드, 또는 IDE에서 실행되고, 속도나 깊이에 맞춰 등급을 고를 수 있는 GPT-5.6 모델로 동작하며, 별도로 판매되는 대신 ChatGPT 요금제에 포함돼 있어요.

여기서부터는, Codex CLI를 설치하고, 현재 요금을 확인하고, AGENTS.md와 샌드박스 모드를 설정한 다음, 기본기가 갖춰지면 AgentKit이 그 위에 어떻게 얹히는지 살펴보세요.