Codex CLI 설치와 인증

~12 min · codex, install, auth, openai

Level 0🌱 입문자

0 XP0/70 lessons0/11 achievements

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

설치 뒤에는 개인·서버·CI에 맞는 인증을 고르면 돼

Codex CLI는 @openai/codex 패키지로 설치하고 codex 명령으로 실행해. 기본적으로 Git 저장소 안에서 동작하므로 진짜 작업이라면 먼저 git init을 해. 일회성 폴더만 --skip-git-repo-check로 예외 처리하면 돼.

ChatGPT Plus나 Pro 사용자는 codex login의 OAuth가 가장 편해. 서버와 CI는 OPENAI_API_KEY를 환경변수로 주입하고, process 목록이나 셸 기록 노출까지 줄여야 하는 CI에서는 stdin으로 키를 넘길 수 있어.

설치 뒤 ~/.codex/config.toml에 모델과 승인·sandbox 기본값을 정하고, 전역 ~/.codex/AGENTS.md에 개인 지침을 둬. 실제 저장소에서 codex status까지 확인해야 설치가 끝난 거야.

정리하면 패키지는 1개고 인증 경로는 OAuth·환경변수·stdin의 3개야.

직접 확인할 항목: echo "$KEY" | codex exec ....

Code

설치하고 인증하기·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

최소 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를 만든 뒤, 실제 저장소에서 codex status를 실행해. 결과 화면을 설치 완료 기록으로 남겨.

Progress

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

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

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

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

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

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