플레이북 23편

코덱스 시작하기
앱, CLI, VS Code 설치와 첫 설정

시작, 세팅|2026년 10월 10일|9분 분량

먼저 답하면

Codex는 데스크톱 앱, 터미널(CLI), VS Code 같은 편집기 확장으로 쓸 수 있고 셋 다 ChatGPT 계정으로 로그인해요 다만 플랜마다 쓸 수 있는 입구가 달라서, 무료와 Go 플랜은 데스크톱 앱부터 시작합니다 처음에 꼭 볼 것은 세 가지예요 어떤 모델로 돌고 있는지, 내 파일을 어디까지 고칠 수 있게 되어 있는지, 컴퓨터에 깔린 Codex가 여러 벌이라면 버전이 서로 맞는지입니다

"코덱스 설치", "코덱스 사용법", "코덱스 앱 vs CLI"를 찾고 있나요? 이 글은 Codex를 처음 켜는 날 필요한 것만 다룹니다

Claude Code와 함께 쓰는 법은 19편(같은 규칙으로 번갈아 쓰기)과 20편(검수 맡기기)에, 사용량 관리는 22편에 있어요

입구 고르기 - 앱, CLI, 편집기 확장

같은 은행 계좌를 휴대폰 앱으로도, ATM으로도, 창구로도 쓰는 것과 비슷해요 입구는 달라도 계정과 설정은 하나로 이어집니다

입구	이런 사람에게	시작하는 법
데스크톱 앱	터미널이 낯설고, 대화창 화면이 편한 사람	ChatGPT 데스크톱 앱을 설치하고 Codex를 고른다(CLI가 있다면 `codex app`으로도 연다)
CLI(터미널)	여러 폴더를 오가며 작업하거나 자동화로 이어 붙이고 싶은 사람	`npm install -g @openai/codex` 또는 `brew install --cask codex`
편집기 확장	VS Code 같은 편집기를 이미 쓰는 사람	편집기의 확장 마켓에서 Codex 확장을 설치

기준 문서: OpenAI Codex 저장소 안내

입구를 고르기 전에 내 플랜에서 쓸 수 있는지부터 보세요 공식 요금 문서에 따르면 무료와 Go 플랜은 데스크톱 앱에서 가벼운 모델(GPT-6 Luna)을 쓸 수 있는데 순차 제공이라 아직 안 보일 수 있고, CLI와 편집기 확장은 Plus 플랜부터 안내돼 있어요 어느 입구든 처음 실행하면 "Sign in with ChatGPT"로 ChatGPT 계정에 로그인합니다

기준 문서: Codex 요금과 사용량

먼저 정할 것 - 내 파일을 어디까지 고칠 수 있게 할까

설정은 두 가지를 따로 정해요 하나는 어디까지 고칠 수 있나(울타리, 샌드박스)이고, 다른 하나는 언제 허락을 물을까(승인)입니다 놀이터로 치면 울타리의 크기와, 울타리 밖으로 나가고 싶을 때 선생님께 물어보는 규칙이 따로 있는 셈이에요 울타리는 공식 문서 기준 세 가지입니다

울타리	할 수 있는 것	언제
읽기 전용	파일을 읽고 읽기 전용 범위에서 명령을 실행, 고치지는 않음	처음 써 보거나, 버전 기록이 없는 폴더일 때 권장
작업 폴더 쓰기	지금 작업 폴더와 임시 폴더 안에서 파일 수정과 명령 실행, 인터넷 연결은 기본으로 꺼짐	버전 기록(git)이 있는 폴더의 기본값
제한 없음	울타리 없이 컴퓨터 전체와 인터넷에 접근	공식 문서도 믿을 수 없는 코드에는 권하지 않음

버전 기록이 있는 폴더의 기본값은 "작업 폴더 쓰기 + 필요할 때 승인 요청" 조합이에요 작업 범위 안에서는 읽고 고치고 명령을 실행하고, 범위 밖을 고치거나 인터넷에 접근해야 할 때 허락을 묻습니다 승인을 아예 묻지 않게 하는 설정도 있지만, 그때도 울타리는 그대로 남아요 이 기본값은 되돌릴 버전 기록이 있다는 전제 위에 있으니, 버전 기록이 없는 폴더라면 실행 중인 Codex에서 /permissions로 읽기 전용을 고르고 시작하세요

기준 문서: Codex 샌드박스와 승인

처음 막히는 곳 - 이 환경에서 실제로 겪은 것

함정 1

한 컴퓨터에 Codex가 세 벌 깔려 있었다

흔히 겪는 장면 - 같은 TV 리모컨이 세 개인데 하나만 배터리가 오래돼서, 그걸 집으면 안 켜지는 상황이에요

이 환경에서는 - 터미널용으로 직접 설치한 것, ChatGPT 앱 안에 들어 있는 것, VS Code 확장 안에 들어 있는 것까지 Codex가 세 벌 있었고 버전이 서로 달랐어요 직접 설치한 쪽이 오래된 버전이라 새 모델 이름을 넣자 "지원하지 않는다"는 오류로 거절했습니다 앱과 확장에 든 쪽은 정상이었고, 직접 설치한 쪽을 업데이트하자 풀렸어요 오류가 나면 지금 어느 Codex가 실행되는지, 그 버전이 무엇인지(codex --version)부터 확인하세요

함정 2

편집기 확장과 CLI가 같은 설정을 함께 쓴다

흔히 겪는 장면 - 리모컨 두 개가 같은 TV를 조종하니, 한쪽에서 음량을 바꾸면 다른 쪽으로 봐도 바뀌어 있죠

이 환경에서는 - VS Code 확장과 CLI가 홈 폴더의 같은 Codex 설정 폴더를 함께 읽었어요 설정 파일, 자동 점검 장치(훅) 목록, 그 신뢰 승인까지 공유합니다 한쪽에서 바꾼 설정이 다른 쪽에 그대로 적용된다는 뜻이에요 어느 날은 기본 모델과 생각 강도가 평소와 다르게 바뀌어 있었는데, 어느 입구에서 바뀌었는지는 끝내 확인하지 못했습니다 그 뒤로는 작업 시작 전에 어떤 모델로 돌고 있는지부터 확인해요

함정 3

프로젝트 폴더의 설정은 신뢰하기 전에는 읽히지 않는다

흔히 겪는 장면 - 새 기기를 휴대폰에 연결하려면 먼저 "연결 허용"을 눌러야 하는 것과 비슷해요

이 환경에서는 - 작업 폴더 안에 Codex 설정 파일을 두었는데, 그 폴더를 신뢰한다고 등록하기 전에는 아예 읽히지 않았어요 잘못된 값을 넣어도 오류조차 나지 않아, 적용됐는지 겉으로는 알 수 없었습니다 홈 폴더의 Codex 설정 파일은 프로젝트를 신뢰하지 않아도 읽히지만, 실행할 때 준 옵션이나 신뢰한 프로젝트의 설정이 그보다 앞섭니다 그래서 어느 파일에 적었느냐보다, 작업을 시작한 화면에서 지금 실제로 어떤 권한으로 도는지를 확인하는 편이 확실해요 자동 점검 장치(훅)도 신뢰 승인을 해야 실행됩니다 훅 정의(무엇을 언제 실행할지 적은 부분)를 바꾸면 다시 승인해야 하지만, 연결된 스크립트 내용만 바꾸면 승인이 그대로 남아 있었어요 그러니 스크립트를 고쳤다면 직접 다시 검토하세요

공식 문서도 프로젝트를 신뢰하지 않음으로 두면 그 프로젝트 안의 설정은 쓰지 않는다고 적고 있어요 설정이 안 먹는 것 같다면 먼저 그 폴더를 신뢰했는지 보세요

기준 문서: Codex 샌드박스와 승인

로그인은 생각보다 쉬웠어요 다른 컴퓨터에 처음 설치했을 때는 같은 컴퓨터의 ChatGPT 앱과 로그인 정보를 함께 써서, 설치하자마자 이미 로그인된 상태였습니다 반대로 Claude Code에서 쓰던 스킬과 설정을 옮겨 주는 "Claude에서 가져오기" 기능은 켜 두면 사본이 따로 생길 수 있으니 21편을 먼저 읽어 보세요

모델 고르기

모델은 자주 바뀝니다 공식 변경 기록에 따르면 2026년 9월 29일에 나온 GPT-6.1 Sol은 최상위 모델에 가까운 성능을 더 적은 비용으로 내는 모델로, 반복되고 오래 걸리는 작업에 맞춰져 있어요 이 환경은 평소 검증에는 Sol을, 실제 서비스에 바로 반영되는 중요한 건에는 최상위 모델을 씁니다 모델은 제공이 끝나거나 쓸 수 있는 플랜이 바뀔 수 있으니, 스크립트나 메모에 적어 둔 모델 이름이 지금도 지원되는지 쓰기 전에 확인하세요

기준 문서: Codex 변경 기록

첫날 점검 순서

입구마다 화면이 달라서 순서를 나눠 적었어요 고른 입구의 순서만 따라 하면 되고, 다른 입구를 따로 설치할 필요는 없습니다

데스크톱 앱으로 시작할 때(무료와 Go 플랜은 여기부터)

설치와 로그인 - 공식 안내에서 ChatGPT 데스크톱 앱을 내려받아 설치하고, ChatGPT 계정으로 로그인한다
Codex 고르기 - 앱의 선택 메뉴에서 ChatGPT 대신 Codex를 고르고 새 대화를 연다
연습용 폴더 열기 - 작업 위치로 중요한 파일이 없는 연습용 폴더를 고른다 앱은 고른 폴더의 파일을 읽고 고칠 수 있다
모델과 권한 확인 - 새 대화 화면에서 어떤 모델로 도는지, 파일을 어디까지 고칠 수 있는 설정인지 확인한다 메뉴 이름과 위치는 앱 버전마다 달라질 수 있으니 공식 앱 안내와 함께 본다
남은 양 - 웹의 Codex 사용량 화면에서 확인한다

기준 문서: ChatGPT 데스크톱 앱 안내, 시작하기

CLI(터미널)로 시작할 때(Plus 플랜부터)

설치와 버전 - 설치한 뒤 터미널에서 codex --version으로 버전을 확인하고, 컴퓨터에 Codex가 여러 벌인지 본다
연습용 폴더에서 첫 실행 - 중요한 파일이 없는 폴더로 이동해 codex를 입력해 실행하고, ChatGPT 계정으로 로그인한다
울타리 고르기 - 실행 중인 Codex 안에서 /permissions를 입력해 읽기 전용을 고르고, 바뀌었는지 화면에서 확인한다
남은 양 - 일반 터미널이 아니라 실행 중인 Codex 안에서 /status를 입력해 남은 양을 본다
모델 - 지금 기본 모델이 무엇인지 확인한다

편집기 확장으로 시작할 때(Plus 플랜부터)

편집기의 확장 마켓에서 Codex 확장을 설치하고 ChatGPT 계정으로 로그인한 뒤, 연습용 폴더를 열어 모델과 권한을 확인하세요 화면 구성은 확장 버전마다 달라질 수 있어서 공식 확장 안내를 따르는 편이 정확해요

입구와 관계없이

지침 파일 - 작업 폴더에 AGENTS.md로 공통 규칙을 적는다(19편)
첫 작업 - 중요한 폴더가 아닌 연습용 폴더에서 작은 일부터 맡긴다

그대로 요청하기 - 첫날 점검

지금 이 세션의 Codex 버전, 기본 모델, 울타리(샌드박스)와 승인 방식, 이 폴더에 버전 기록이 있는지부터 확인해줘
파일을 열어 봐야 알 수 있는 항목은 읽을 파일과 항목을 먼저 제안하고, 내가 허락한 뒤에 읽어줘
요청과 관계없는 내용은 읽거나 출력하지 말고, 설정은 바꾸지 말고, 확인할 수 없는 값은 미확인으로 적어줘

자주 묻는 질문

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

공식 요금 문서에 따르면 무료와 Go 플랜에서는 데스크톱 앱으로 가벼운 모델(GPT-6 Luna)을 쓸 수 있어요 순차 제공이라 아직 안 보일 수 있고, CLI와 편집기 확장은 Plus 플랜부터 안내돼 있습니다

앱, CLI, VS Code 중 무엇부터 시작할까요?

먼저 내 플랜에서 쓸 수 있는 입구인지 확인하세요 쓸 수 있다면 터미널이 낯설 때는 데스크톱 앱, 편집기를 이미 쓰면 편집기 확장, 여러 폴더를 오가거나 자동화로 잇고 싶으면 CLI가 맞아요

설치했는데 모델을 지원하지 않는다는 오류가 나요

컴퓨터에 깔린 Codex가 오래된 버전일 수 있습니다 이 환경에서는 직접 설치한 쪽이 오래돼 새 모델 이름을 거절했고, 업데이트하자 풀렸어요 지금 실행되는 Codex의 버전부터 확인하세요

코덱스가 내 파일을 마음대로 고치나요?

버전 기록이 있는 폴더의 기본값은 작업 범위 안에서는 고치고, 범위 밖을 고치거나 인터넷에 접근할 때 허락을 묻는 방식이에요 처음이거나 버전 기록이 없는 폴더라면 /permissions로 읽기 전용을 골라 시작하세요

설정 파일을 고쳤는데 적용이 안 돼요

작업 폴더 안의 설정은 그 폴더를 신뢰한다고 등록해야 읽힙니다 홈 폴더 설정은 늘 읽히지만 실행 옵션이나 신뢰한 프로젝트 설정이 앞서니, 작업을 시작한 화면에서 실제 권한을 확인하세요

클로드 코드와 같이 써도 되나요?

같이 쓸 수 있어요 같은 규칙으로 번갈아 쓰는 법은 19편에, 한쪽이 만들고 다른 쪽이 검수하는 법은 20편에 정리했습니다

같이 쓰기는 19편, 검수 맡기기는 20편, 스킬과 플러그인은 21편, 사용량은 22편으로 이어집니다

검증 기준일: 2026-10-08 KST 공식 문서로 확인한 기능과 한 환경의 운영 기록을 구분해 작성했으며, 설치 방법과 모델 이름은 제품 업데이트에 따라 달라질 수 있습니다

AI 에이전트 실전 플레이북 - 계속 더해 가는 시리즈

← 플레이북 전체 목록 보기

코덱스 시작하기앱, CLI, VS Code 설치와 첫 설정