설치와 인증

~12 min · codex, install, auth, openai

Level 0🌱 입문자

0 XP0/70 lessons0/11 achievements

0/120 XP to next level120 XP to go0% complete

npm 패키지 1개, 인증 경로 3개

Codex CLI 가 @openai/codex 로 ship. 설치 후 codex 가 PATH 에. Claude Code 처럼 Git repo 필요 (--skip-git-repo-check 로 일회성 디렉토리 우회). 세 인증 경로가 개인부터 CI 까지 스펙트럼 커버.

ChatGPT OAuth via codex login — ChatGPT Plus/Pro 있으면 가장 쉬워. 브라우저 흐름, API key 관리 X, 청구가 구독으로 합산. 환경변수 API key — OPENAI_API_KEY env var, 서버와 CI 의 경로. stdin 통한 API key — echo "$KEY" | codex exec ... 로 키를 process listing 이나 셸 history 에 안 남기고 싶은 job 용.

설치 후 최소 ~/.codex/config.toml 과 글로벌 ~/.codex/AGENTS.md drop, 준비 끝. codex status 가 setup verify.

Code

Install + auth·bash

# Prereqs
node --version    # 18+
git --version

# Install
npm install -g @openai/codex
codex --version

# Auth path A — ChatGPT OAuth (individuals)
codex login

# Auth path B — API key (servers, CI)
echo 'export OPENAI_API_KEY="sk-..."' >> ~/.zshrc
source ~/.zshrc

# Auth path C — stdin (CI without leaking)
aws secretsmanager get-secret-value --secret-id openai-key \
  --query SecretString --output text | \
  codex exec "review src/auth.ts for security issues"

# Verify
cd ~/myproject && codex status

Minimum config.toml + AGENTS.md·bash

mkdir -p ~/.codex

cat > ~/.codex/config.toml <<'EOF'
model            = "gpt-5-codex"
approval_policy  = "on-request"
sandbox_mode     = "workspace-write"

[history]
persistence = "save-all"
EOF

cat > ~/.codex/AGENTS.md <<'EOF'
# Personal Codex Instructions
- Prefer TypeScript over JavaScript
- Tests use Vitest
- Add JSDoc to exported functions
- Functions max 40 lines
EOF

External links

Exercise

Codex 설치, 상황에 맞는 경로로 인증. 최소 ~/.codex/config.toml 과 ~/.codex/AGENTS.md drop. 실제 repo 에서 codex status. output 을 설치 영수증으로 캡처.

Progress

Progress is local-only — sign in to sync across devices.

← 🎓 Claude Skills퀴즈 · 3 questions Next →TUI — @, !, /, Tab

이 페이지에서 버그를 발견하셨거나 피드백이 있으세요?문제 신고

🔔 답글 알림 (로그인 필요)

로그인 — 댓글을 남기려면 로그인해 주세요.

아직 댓글이 없어요. 첫 댓글을 남겨보세요.