‹ 스킬공유자료실#026 · 10월 7일 꿀팁

새 코덱스 CLI 윈도우 설치

명령어 한 줄 + 챗GPT 로그인 + /agents

단계 5개따라 하기 약 8분
AI 공부방 오픈카카오톡 · 막히면 같이 공부해요
입장하기

한눈에 보기

1코덱스 설치하기클로드에게 부탁하면 끝›2코덱스 켜기명령어 창에 다섯 글자›3챗GPT로 로그인맨 위 선택지 고르기›4안전 설정 허락권장 항목 고르고 "예"›5일 시키기 · 지휘 센터한국어로 말하면 돼요›6막히면자주 나오는 것›
코덱스 CLI(Codex CLI)는 오픈AI가 만든 글자 입력 창(터미널)에서 쓰는 코딩 도우미예요. 깃허브 별 12만 개가 넘는 공식 무료 공개 프로그램(Apache-2.0)이에요. 이번에 화면 전체를 쓰는 새 모습으로 바뀌었고, 입력창이 아래에 고정돼 대화가 길어져도 편해요. 여러 작업을 한눈에 보는 에이전트 지휘 센터도 생겼어요.

읽는 순서 — ① 설치 → ② 켜기 → ③ 챗GPT로 로그인 → ④ 안전 설정 허락 → ⑤ 일 시키기·지휘 센터 → ⑥ 막히면.
준비물
  1. 윈도우 11 PC — 윈도우 11을 권해요. 최신 업데이트된 윈도우 10은 "최선을 다해 지원" 수준이에요.
  2. 클로드 코드 — 설치를 대신 해 줘요. 없으면 자료실 #017 맨 위 설치 안내를 보세요. (클로드 코드 없이 직접 깔고 싶다면 1단계의 "직접 명령어로" 칸을 쓰세요.)
  3. 챗GPT 계정 — 로그인에 써요. 쓸 수 있는 범위는 6단계 주의 상자를 꼭 보세요.
1

코덱스 설치하기클로드에게 부탁하면 끝

클로드 코드를 열고 아래 문장을 그대로 붙여 넣으세요. 설치는 클로드가 알아서 해요.

오픈AI 코덱스 CLI를 제 윈도우 컴퓨터에 설치해 주세요. 오픈AI 공식 설치 방법으로 하고, 다 되면 잘 깔렸는지 확인까지 해 주세요.
직접 명령어로 하고 싶다면

시작 메뉴에서 PowerShell(윈도우 기본 명령어 창)을 검색해 열고, 아래 한 줄을 붙여 넣고 Enter. 공식 안내문 원문 그대로예요. winget(윈도우 기본 프로그램 설치 도구)은 보통 윈도우에 이미 들어 있어요.

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

Node.js(노드)가 이미 있는 분은 아래로도 설치할 수 있어요.

npm install -g @openai/codex
이렇게 되면 성공 — 클로드가 "코덱스 설치 끝났어요"라고 답해요.
2

코덱스 켜기명령어 창에 다섯 글자

코덱스는 명령어 창에서 돌아가는 프로그램이라, 켤 때만 직접 쳐야 해요. 시작 메뉴에서 PowerShell을 열고 codex 다섯 글자를 친 뒤 Enter를 누르세요. 작업할 폴더에서 켜면 그 폴더를 보고 일해요.

직접 명령어로 하고 싶다면 
codex
이렇게 되면 성공 — Welcome to Codex, OpenAI's command-line coding agent 환영 문구가 떠요.
3

챗GPT로 로그인맨 위 선택지 고르기

로그인 방법 3가지가 나와요. 맨 위 Sign in with ChatGPT(챗GPT로 로그인)를 고르세요. 인터넷 창이 열리면 평소 쓰는 챗GPT 계정으로 로그인해요.

화면에 Finish signing in via your browser(인터넷 창에서 로그인을 마치세요)가 보이면 인터넷 창 쪽을 확인하세요. Provide your own API key(쓴 만큼 돈이 나가는 개발자용 열쇠)는 추가 설정이 필요해서 처음 쓰는 분께는 권하지 않아요.

4

안전 설정 허락권장 항목 고르고 "예"

처음 켤 때 샌드박스(코덱스가 내 컴퓨터를 함부로 건드리지 못하게 막는 울타리) 설정 창이 떠요. 권장 항목인 elevated를 고르고, 관리자 허락 창이 뜨면 예를 누르세요.

5

일 시키기 · 지휘 센터한국어로 말하면 돼요

한국어로 할 일을 그냥 말하면 돼요. / 를 누르면 쓸 수 있는 명령 목록이 나와요. 여러 작업을 한눈에 보려면 코덱스 입력창에 이렇게 치세요.

/agents
이렇게 되면 성공 — 에이전트 지휘 센터(agent command center)가 열려 여러 작업을 한 화면에서 관리할 수 있어요.

자주 쓰는 명령 — /model 모델·생각 깊이 고르기, /plan 계획 모드, /review 내가 고친 내용 검토, /usage 내 사용량 보기, /status 현재 설정·사용량(토큰) 보기. 단축키 안내는 ? 를 누르세요.

6

막히면자주 나오는 것

"무료로 다 된다"가 아니에요. 코덱스 CLI 프로그램 자체는 무료지만, 일을 시키면 챗GPT 계정의 사용량을 써요(챗GPT와 코덱스가 사용량을 함께 씀). 공식 안내는 Plus·Pro·Business·Edu·Enterprise 플랜에 포함된 사용을 권하고, 로그인 화면 문구도 유료 플랜 기준이에요. 무료 계정에서 어디까지 되는지는 계정마다 다를 수 있으니 /usage 로 확인하세요.

"codex 를 찾을 수 없다"고 나와요 — 설치 직후라면 PowerShell 창을 닫고 새로 연 뒤 다시 치세요. 그래도 안 되면 클로드에게 이렇게 말하세요.

코덱스를 깔았는데 codex 를 치면 찾을 수 없다고 나와요. 고쳐 주세요.

인터넷 창 로그인이 안 돼요 — 로그인 화면 2번 Sign in with Device Code(다른 기기에서 일회용 코드로 로그인, 베타)를 고르세요. 먼저 챗GPT 웹의 보안 설정에서 '기기 코드 로그인'을 켜 둬야 해요. 명령어 창에 나온 링크를 인터넷 창으로 열어 로그인한 뒤, 명령어 창에 보이는 코드를 입력하면 돼요.

윈도우 10에서 이상하게 움직여요 — 윈도우 10은 최선 노력 지원이에요. 윈도우 업데이트를 최신으로 하거나 윈도우 11에서 쓰세요.

확인한 것
  • 윈도우 설치 한 줄·npm 대안·Sign in with ChatGPT·권장 플랜 — 공식 README github.com/openai/codex (2026-10-06)
  • 최신 정식 버전 0.160.1(2026-10-05), 별 128,028·Apache-2.0 — GitHub releases·API (2026-10-06)
  • 새 전체 화면 인터페이스·입력창 고정·지난 기록 불러오기 — OpenAI 커뮤니티 공식 발표 (2026-09-30)
  • 윈도우 11 권장·winget·elevated 샌드박스 — learn.chatgpt.com Windows sandbox 문서 (2026-10-06)
  • 로그인 선택지·/agents 등 명령 설명 — codex-rs/tui 소스 v0.160.1 (2026-10-06)
  • 챗GPT와 코덱스 사용량 공유 — learn.chatgpt.com/docs/pricing (2026-10-06)
  • Device Code 로그인(베타·보안 설정에서 켜기) — learn.chatgpt.com/docs/auth (2026-10-07)
AI 공부방 오픈카카오톡 · 막히면 같이 공부해요
입장하기 ‹ 다른 자료 보러 가기

트렌드코어 스킬공유자료실 · 무료