OpenAI Codex CLI 설치와 사용법: 로그인과 첫 저장소 작업

Codex CLI를 설치하고 ChatGPT 또는 API 키로 로그인한 다음, 실제 저장소에서 첫 작업을 끝낸다.

필요한 것은 로컬 저장소를 읽고, 파일을 고치고, 로컬 도구를 돌리는 코딩 에이전트다. 루프는 터미널에 남겨 두고 싶다.

이 글은 OpenAI Codex CLI 설치와 사용을 공식 절차로 따라간다. 설치기, ChatGPT 또는 API 키 로그인, 실제 저장소에서의 첫 작업. 근거는 developers.openai.com/codex/cli와 developers.openai.com/codex/auth.

누구에게 맞나

Codex CLI는 로컬 저장소를 상대로 일한다. 파일을 보고, 고치고, 이미 설치한 도구를 실행한다. 대화형은 codex, 반복 파이프라인은 codex exec. ChatGPT 웹 탭이 아니며 IDE 확장을 먼저 깔 필요도 없다.

설치, 로그인, 첫 작업

1. 1

   CLI 설치

   macOS / Linux: curl -fsSL https://chatgpt.com/codex/install.sh | sh. Windows는 공식 PowerShell 설치기. npm install -g @openai/codex 또는 brew install --cask codex도 된다. 같은 명령으로 업데이트한다.

2. 2

   로그인

   프로젝트 디렉터리에서 codex 또는 codex login을 실행하고 Sign in with ChatGPT를 고른 뒤 브라우저를 마친다. 헤드리스이거나 localhost 콜백이 막히면 codex login --device-auth(ChatGPT 보안 설정에서 디바이스 코드 허용). 자동화는 printenv OPENAI_API_KEY | codex login --with-api-key. 확인은 codex login status, 로그아웃은 codex logout.

3. 3

   첫 저장소 작업

   저장소에 들어가 codex를 실행한다. 구조를 설명하게 한 뒤 테스트 추가나 분명한 오류 수정처럼 한 가지 변경을 요청한다. 커밋 전에 /review. 팀 상설 지시가 필요하면 /init으로 AGENTS.md를 쓸 수 있다.

curl -fsSL https://chatgpt.com/codex/install.sh | sh
# Windows: irm https://chatgpt.com/codex/install.ps1 | iex
# npm install -g @openai/codex
# brew install --cask codex

codex login
# printenv OPENAI_API_KEY | codex login --with-api-key
# codex login --device-auth

cd ~/code/your-repo
codex
# Tell me about this project

첫 실행에서 자주 막히는 점

auth.json은 비밀번호

로그인은 ~/.codex/auth.json 또는 OS 키링에 캐시된다. 커밋하지 말고 티켓에 붙이지 말 것. CLI와 IDE 확장은 캐시를 공유하므로 한쪽에서 로그아웃하면 다른 쪽도 다시 로그인해야 한다.

헤드리스는 다른 경로

원격이 localhost 콜백을 막으면 디바이스 코드를 우선한다. 대안은 브라우저가 있는 기기에서 로그인한 뒤 캐시를 안전하게 복사하거나 localhost:1455를 SSH로 전달하는 것이다.

회사 프록시는 CA

TLS 프록시나 사설 루트가 있으면 CODEX_CA_CERTIFICATE를 설정한 뒤 codex login. 없으면 SSL_CERT_FILE로 넘어간다.

API / CI에 대한 공식 경고: 신뢰할 수 없거나 공개된 환경에서 Codex 실행을 노출하지 말 것.

변경을 사람과 볼 때

에이전트가 고친 뒤에는 무엇이 바뀌었고 왜 합쳐도 되는지의 한 장이 부족한 경우가 많다. 회의 스위트는 필요 없다. tidemeet에서 짧은 공간을 열거나 공간 만들기를 본다. 캔버스는 공유 화이트보드 기초. 이 사이트의 OpenAI 평가 사고 메모는 METR 보고서.

질문