32단계Codex 설치와 첫 실행

걸리는 시간 · 읽기 약 15분 · 따라 하기 약 40분 · 난이도 ★★★ 심화

이 단계를 마치면

• 데스크톱 앱에서 Codex를 열고, 운영체제에 맞는 방법으로 Codex CLI를 설치한 뒤 codex --version으로 확인할 수 있습니다.
• ChatGPT 계정 로그인과 API 키 로그인의 차이를 설명하고, 알맞은 방식으로 로그인할 수 있습니다.
• 작업 폴더에서 Codex를 켜고, 모델과 추론 강도를 골라 첫 지시를 내릴 수 있습니다.

22단계에서 Claude Code를 설치해 본 분이라면 이번 단계는 훨씬 수월합니다. 공식 문서에서 명령을 복사하고, 설치가 끝나면 버전을 확인하고, 작업 폴더에 들어가서 켜는 순서가 같습니다. 달라지는 것은 두 가지입니다. 하나는 로그인 방식을 고르는 일이고, 다른 하나는 모델과 함께 "추론 강도"를 고르는 일입니다. 둘 다 사용량과 요금에 곧바로 이어지므로 처음에 제대로 알고 넘어가는 편이 좋습니다.

두 개의 문: 데스크톱 앱과 CLI

데스크톱 앱. 터미널이 아직 낯설다면 앱부터 시작하세요. chatgpt.com/download에서 ChatGPT 데스크톱 앱을 받습니다. Windows는 Microsoft Store에서 설치하거나, PowerShell에서 아래 명령으로 설치할 수도 있습니다.

winget install --id 9PLM9XGG6VKS -s msstore

앱을 열고 로그인하면 ChatGPT와 Codex 가운데 하나를 고르는 메뉴가 있습니다. Codex를 고르고 작업할 폴더를 엽니다. 실행 위치는 Local, Worktree, Cloud 세 가지인데, 처음에는 Local을 고릅니다. 지금 연 폴더에서 바로 일하는 방식입니다. Worktree는 Git의 워크트리 기능으로 작업 공간을 따로 떼어 일하는 방식이고, Cloud는 클라우드 환경에서 일하는 방식입니다. Free와 Go 요금제는 이 데스크톱 앱에서만 Codex를 쓸 수 있습니다.

CLI. 제3부처럼 터미널에서 일하려면 Codex CLI를 설치합니다. 설치 명령은 Codex CLI 공식 문서(learn.chatgpt.com/docs/codex/cli)에서 복사해 붙이세요. 참고로 집필 시점에 안내된 명령은 아래와 같았습니다.

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"

이미 Node.js를 쓰고 있다면 npm install -g @openai/codex로, Mac에서 Homebrew를 쓴다면 brew install --cask codex로 설치해도 됩니다. 업데이트는 설치 스크립트를 한 번 더 실행하거나 brew upgrade --cask codex를 씁니다.

Windows 사용자. 지금의 Codex는 PowerShell에서 바로 돌아가고, Windows 전용 샌드박스를 씁니다. 샌드박스는 Codex가 할 수 있는 일의 범위를 운영체제 차원에서 묶어 두는 장치로, 33단계에서 자세히 다룹니다. Windows 샌드박스에는 elevated(권장)와 unelevated 두 방식이 있습니다. 관리자 권한이 없는 회사 PC라면 unelevated가 대안으로 안내됩니다. 어느 쪽을 쓸지는 IT 담당자와 먼저 이야기하세요. WSL2(Windows 안의 리눅스 환경)에서 쓰는 방법도 있습니다. 이때는 작업 폴더를 /mnt/c 아래가 아닌 리눅스 홈 폴더 아래에 두라고 안내합니다. GitHub 저장소의 옛 설치 문서에는 아직 "WSL2로만" 쓴다는 설명이 남아 있으니, 두 안내가 다르면 공식 웹 문서를 따르세요.

권장 사양. macOS 12 이상, Ubuntu 20.04 이상, 메모리 4GB 이상(8GB 권장), Git 2.23 이상이 권장됩니다. 21단계에서 설치 전 준비를 마쳤다면 대부분 이미 갖춰져 있습니다.

설치 확인. 설치가 끝나면 터미널을 새로 열고 버전을 확인합니다.

codex --version

버전 번호가 나오면 설치가 끝난 것입니다. 무언가 이상하면 codex doctor를 실행해 보세요. 설치, 설정, 인증 상태를 진단한 보고서가 나옵니다. 오류가 있으면 그 보고서를 통째로 복사해 두는 것이 다음 걸음입니다.

로그인: ChatGPT 계정과 API 키

Codex에 로그인하는 방법은 두 가지입니다.

이 책의 독자라면 ChatGPT 계정 로그인이 기본입니다. 회사가 계약한 Business나 Enterprise 계정이 있다면 반드시 그 계정으로 들어가세요. 개발팀에서 "우리 API 키 쓰세요"라고 건네줄 때가 있는데, 그러면 사용 요금이 개발팀 API 계정으로 청구되고 클라우드 기능은 쓰지 못합니다.

CLI에서 쓰는 로그인 명령은 네 가지면 충분합니다.

로그인 정보는 내 홈 폴더의 .codex 폴더 안 auth.json 파일이나 운영체제의 자격 증명 저장소에 저장됩니다. auth.json은 비밀번호처럼 다뤄야 합니다. 공유 드라이브나 저장소에 올리지 말고, 다른 사람에게 보내지 마세요. CLI와 IDE 확장은 이 로그인 정보를 함께 씁니다. 이메일과 비밀번호로 가입한 계정은 Codex cloud를 쓰기 전에 2단계 인증(MFA)을 켜야 합니다.

첫 폴더 열기

첫 실행 순서는 22단계와 같습니다. 작업 폴더로 먼저 들어간 뒤 켭니다.

cd ~/work/nuri-supplies
codex

처음 켜면 로그인 방법을 묻습니다. Sign in with ChatGPT를 고르면 브라우저가 열리고, 로그인을 마치면 터미널로 돌아옵니다. 그다음 Codex는 이 폴더에서 얼마만큼 알아서 일해도 되는지 제안합니다. 폴더가 Git으로 관리되고 있으면 Auto를, 아니면 읽기 전용(read-only)을 권합니다. Auto는 폴더 안에서는 읽기·수정·명령 실행을 알아서 하고, 폴더 밖을 고치거나 인터넷을 쓰려 할 때만 묻는 방식입니다. 읽기 전용은 이름 그대로 읽기만 합니다. 이 차이가 곧 Git 체크포인트가 중요한 이유입니다. 되돌릴 기록이 있어야 알아서 고치게 둘 수 있기 때문입니다. 공식 문서도 작업 전후로 커밋을 남기라고 권합니다. 연습용 폴더라면 25·26단계에서 본 기록 장치 켜기(git 초기화)와 첫 커밋을 Codex를 켜기 전에 먼저 해 두세요. 제3부에서는 이 일을 Claude Code에게 시켰지만, 여기서는 터미널에서 직접 쳐도 세 줄이면 됩니다. 빈 폴더라면 메모 파일 하나(예: README.md)를 먼저 넣어야 첫 커밋이 만들어집니다.

git init
git add .
git commit -m "작업 시작 전 상태"

권한은 33단계에서 자세히 다룹니다.

첫 지시는 가볍게 합니다. "이 폴더에 무엇이 있는지 알려 줘." 폴더 안 파일 목록이 돌아오면 Codex가 제대로 된 폴더에 들어와 있는 것입니다. 이어서 /status를 입력해 보세요. 지금 쓰는 모델, 승인 정책, 쓰기가 허용된 폴더, 남은 맥락, 사용량이 한 화면에 나옵니다. 앞으로 무언가 이상하다 싶을 때 가장 먼저 칠 명령입니다. 끝낼 때는 /quit 또는 /exit를 입력합니다. 터미널에서 하던 대화를 앱 화면으로 보고 싶으면 /app을 입력합니다.

모델과 추론 강도 고르기

Codex에서는 모델과 추론 강도를 따로 고릅니다. 집필 시점 기준으로 고를 수 있는 주요 모델은 셋입니다.

추론 강도는 모델이 답하기 전에 얼마나 오래 따져 보는지를 정합니다. 화면에는 Light, Medium, High, Extra High, Max, Ultra로 나옵니다(CLI에서는 Light가 Low로 표시됩니다). 모델마다 지원하는 범위가 달라서, GPT-6 Luna는 Max까지만 되고 Ultra는 고를 수 없습니다. Ultra는 일을 여러 서브에이전트로 나눠 동시에 처리하는 방식입니다.

CLI에서는 /model을 입력해 모델과 추론 강도를 함께 고릅니다. 켤 때부터 모델을 정하려면 codex -m gpt-6-sol처럼 씁니다. 데스크톱 앱에서는 입력창 아래의 모델 메뉴에서 고릅니다.

어떻게 고를까요? 원칙은 단순합니다. 처음에는 권장값으로 시작하고, 답이 얕다고 느껴질 때만 한 단계씩 올립니다. 강도를 올릴수록 답은 느려지고 사용량은 빨리 찹니다. 31단계에서 본 것처럼 같은 Plus 요금제라도 모델에 따라 5시간에 보낼 수 있는 메시지 수가 열 배 넘게 차이 납니다. 파일 이름 바꾸기처럼 규칙이 분명한 일은 Luna로, 여러 파일에 걸친 수정은 Sol로, 정말 막힌 문제만 Astra로 보내는 식으로 나눠 쓰면 한도를 아낄 수 있습니다. 모델 이름은 몇 주 사이에도 바뀌고 있으니 /model 목록이 이 표와 다르면 화면이 맞습니다.

현장 장면

오세린 차장의 노트북은 Windows였습니다. IT팀 하준영 대리에게 먼저 연락해 설치 허락을 받았고, 하 대리는 관리자 권한은 줄 수 없으니 샌드박스는 unelevated로 쓰라고 알려 주었습니다. 오 차장은 Microsoft Store에서 ChatGPT 데스크톱 앱을 설치해 Codex 화면을 열어 본 뒤, 공식 문서에서 PowerShell 설치 명령을 복사해 CLI까지 설치했습니다. 새 창에서 codex --version을 치자 버전 번호가 나왔습니다.

첫 번째 걸림돌은 로그인이었습니다. 옆자리 개발팀 동료가 "우리 팀 API 키 있어요"라며 키를 알려 주었고, 오 차장은 별생각 없이 그 키로 로그인했습니다. 일은 잘됐습니다. 그런데 오후에 Codex cloud를 열어 보려 하자 쓸 수 없다는 안내가 나왔습니다. codex login status를 쳐 보니 API 키로 로그인돼 있었습니다. 게다가 오전에 쓴 양은 개발팀 API 요금으로 청구될 참이었습니다. 오 차장은 codex logout으로 나온 뒤 codex login으로 회사 Business 계정에 다시 들어갔고, 동료에게는 키를 쓴 사실을 알렸습니다.

두 번째 걸림돌은 폴더였습니다. 새로 만든 C:\work\nuri-supplies 폴더에서 Codex를 켜자 읽기 전용으로 시작하라는 제안이 나왔습니다. 그대로 두고 "비품 목록 파일을 하나 만들어 줘"라고 하자 Codex는 파일을 쓰려면 허락이 필요하다고 물었습니다. 폴더가 Git으로 관리되지 않았기 때문이었습니다. 오 차장은 Codex를 끝내고 메모 파일 하나를 넣은 뒤, 터미널에서 git 초기화와 첫 커밋을 직접 하고 다시 켰습니다. 이번에는 Auto를 권했습니다.

마지막은 모델이었습니다. 호기심에 /model에서 가장 높은 추론 강도를 골라 "이 폴더에 무엇이 있는지 알려 줘"라고 물었더니, 답은 한참 뒤에야 나왔고 /status의 사용량이 눈에 띄게 올라가 있었습니다. 오 차장은 GPT-6 Sol과 Medium으로 되돌렸습니다. 폴더 목록 하나 보는 데 깊은 생각은 필요 없었습니다.

따라 하기

1. chatgpt.com/download에서 ChatGPT 데스크톱 앱을 설치하고 로그인한 뒤 Codex를 고릅니다. 성공 기준: Codex 화면에서 폴더를 열 수 있고, 실행 위치 Local이 보입니다.
2. Codex CLI 공식 문서에서 내 운영체제의 설치 명령을 복사해 실행합니다. 회사 PC라면 먼저 IT 담당자의 허락을 받습니다. 성공 기준: 새로 연 터미널에서 codex --version이 버전 번호를 돌려줍니다.
3. codex login으로 ChatGPT 계정에 로그인하고 codex login status로 확인합니다. 성공 기준: API 키가 아닌 ChatGPT 계정으로 로그인돼 있다고 나옵니다.
4. 연습용 작업 폴더를 만들고 메모 파일 하나를 넣은 뒤 git init, git add ., git commit으로 첫 커밋을 하고, 그 폴더로 들어가 codex를 켭니다. 성공 기준: Codex가 Auto로 시작하자고 제안합니다.
5. 아래 프롬프트로 첫 지시를 내리고 /status를 입력합니다. 성공 기준: 폴더 안 내용이 돌아오고, /status에 모델과 승인 정책, 쓰기 가능 폴더가 보입니다.
6. /model로 GPT-6 Sol과 Medium을 고른 뒤 /quit로 끝냅니다. 성공 기준: 다시 켰을 때 고른 모델로 시작하는지 /status로 확인합니다.

복사해 쓰는 프롬프트

아직 파일은 만들거나 고치지 마. 먼저 상황만 알려 줘.
1. 이 폴더에 있는 파일과 하위 폴더 목록
2. 이 폴더가 Git으로 관리되고 있는지, 마지막 커밋이 언제인지
3. 지금 너에게 허용된 권한: 어디까지 읽고 쓸 수 있는지, 인터넷을 쓸 수 있는지
4. 이 폴더에 AGENTS.md가 있는지, 있으면 요점 세 가지
모르는 것은 모른다고 적어 줘.

막히면 이렇게

스스로 점검

• ☐ 새로 연 터미널에서 codex --version이 버전 번호를 돌려줍니까?
• ☐ codex login status에서 회사 ChatGPT 계정으로 로그인돼 있는 것을 확인했습니까?
• ☐ 모델과 추론 강도를 고르고, 그 선택이 사용량에 어떤 영향을 주는지 설명할 수 있습니까?

기억할 것

• 설치 명령은 쓸 때마다 공식 문서에서 복사하고, 설치 뒤에는 codex --version과 codex doctor로 확인합니다.
• 로그인은 회사 ChatGPT 계정으로 합니다. API 키 로그인은 따로 과금되고 클라우드 기능을 쓰지 못합니다. auth.json은 비밀번호처럼 다룹니다.
• 작업 폴더에 먼저 들어가서 켭니다. 모델과 추론 강도는 권장값에서 시작하고 필요할 때만 올립니다.

더 알아보기

• Codex CLI 설치와 사용
• 로그인 방식
• 모델과 추론 강도