Codex 고급 활용
시니어 개발자를 위한 Codex 운영·확장 가이드 (CLI 0.163.0 / GPT-6.1 Sol 기본값 / GPT-5.5 종료 일정 반영)
최근 수정된 챕터
프로젝트·사용자·시스템 설정 레이어 우선순위, 프로필 분리(0.134.0 마이그레이션), permission profile과 deny-read, requirements.toml 강제까지 config.toml 운영 전략
codex exec의 JSONL 스트림(--json)·스키마 강제(--output-schema)·resume, GitHub Action과 CODEX_API_KEY 스코프, app-server 스트리밍 실행과 hooks 엔진으로 CI를 자동화하는 패턴
read-only→workspace-write→CI→Cloud/MCP 단계적 롤아웃, requirements.toml 강제·SQLite 감사 로그·cloud-managed config·GPT-6 모델 거버넌스로 팀 도입을 통제하는 운영 원칙
GPT-6 Astra·GPT-6.1 Sol·GPT-6 Luna 기준 모델·reasoning 운영 전략과 GPT-5.6·GPT-5.5 전환 일정
default/worker/explorer/monitor 역할 분리, agents.max_threads/max_depth 설정, fork+steering과 spawn_agents_on_csv 배치, guardian 승인과 샌드박스 상속까지 멀티에이전트 병렬 워크플로우 운영
Codex를 이미 사용 중인 개발자를 위한 운영·확장 가이드입니다. 팀 설정, 권한과 샌드박스, 자동화, 멀티에이전트 운영에 집중합니다.
문서 기준: 2026-10-23
Codex CLI 0.163.0과 GPT-6.1 Sol 기본 모델을 반영했습니다. 버전별 변경, 근거, 반영 챕터는 업데이트 내역에서 확인할 수 있습니다.
관련 읽기
Codex가 잘 일하도록 작업 환경을 설계하는 방법은 하네스 엔지니어링을 함께 읽어보세요.
이 핸드북이 다루는 것
- 팀 표준화: config 레이어/프로필, Team Config, 관리자 강제 정책(requirements.toml)
- 안전장치: 승인(approvals)과 샌드박스(sandbox)를 "기본값"으로 고정하는 운영 패턴
- 자동화:
codex exec기반의 스크립트/CI 통합, GitHub Action - 멀티에이전트: sub-agent 역할 분리,
spawn_agents_on_csv배치 처리 - 확장: Codex App/IDE 워크플로우, MCP 연동, Skills 체계
- 변경 관리: Changelog/Feature Maturity 기반의 업그레이드·릴리즈 운영
핸드북 구성
목차
Ch1. 설치/로그인
설치/업데이트 표준화, 로그인/키 전략, 셸 완성
Ch2. config.toml 설계
레이어/프로필, 안전한 기본값, Team Config/관리자 정책
메모리 운영
memories 설정, stale fact 방지, clear/reset 기준
Ch3. 승인/샌드박스 전략
승인 정책, 샌드박스 모드, 안전한 자율성 설계
Ch4. 보안 가이드
네트워크/권한, 민감정보, 텔레메트리(OTel), 감사 가능성
Ch5. 슬래시 커맨드 운영
/status, /diff, /review, /model 등 세션 제어 루틴
Ch6. 프롬프트/스킬 설계
AGENTS.md, Skills 체계, 컨텍스트 절약
Ch7. exec/자동화
비대화형 실행, JSONL/스키마 출력, CI 패턴
스레드 라이프사이클
start/resume/fork/steer, 장시간 작업 재개 전략
Ch8. Cloud Tasks
원격 실행, best-of-N 시도, 결과 적용 워크플로우
Ch9. 멀티에이전트
sub-agent 역할, spawn_agents_on_csv, 병렬 워크플로우
Ch10. Codex App/IDE
데스크톱 앱, 워크트리, IDE Agent 모드, 컨텍스트 제어
Ch11. MCP 연동
MCP 서버 추가/관리, 툴 allowlist, OAuth/토큰
Ch12. 모델/추론 전략
GPT-6 Astra·Sol·Luna, reasoning effort, Ultra/Max, 비용-품질 트레이드오프
참고 문서
- Codex 문서 홈: https://learn.chatgpt.com/docs (영어)
- Codex CLI: https://learn.chatgpt.com/docs/codex/cli (영어)
- Codex App: https://learn.chatgpt.com/docs/app (영어)
- Changelog: https://learn.chatgpt.com/docs/changelog (영어)
- Models: https://learn.chatgpt.com/docs/models (영어)