Config 시스템과 프로파일

~14 min · codex, config, toml, profiles

Level 0🌱 입문자

0 XP0/70 lessons0/11 achievements

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

레이어된 TOML, 프로파일로 swap 가능 default

Codex 의 config 가 레이어드: ~/.codex/config.toml (user), repo 의 .codex/config.toml (project, 신뢰될 때만), /etc/codex/config.toml (system, 항상 신뢰). 우선순위: CLI flag + -c key=value override → profile (--profile NAME) → project 파일 → user 파일 → system 파일 → 빌트인 기본.

프로파일이 config.toml 안 named 설정 그룹. --profile secure 가 빡빡한 default swap; --profile fast 가 신뢰 자동화 위해 느슨한 거 swap. 같은 config 파일, 여러 운영 모드.

Code

Comprehensive ~/.codex/config.toml·toml

# Core
model           = "gpt-5-codex"
provider        = "openai"        # "openai" | "azure" | custom

# Approval + sandbox
approval_policy = "on-request"
sandbox_mode    = "workspace-write"

# Project doc discovery
project_doc_fallback_filenames = ["TEAM_GUIDE.md", ".agents.md"]
project_doc_max_bytes          = 65536

# History
[history]
persistence = "save-all"

# Logging
log_dir = "~/.codex/logs"

# Workspace-write specifics
[sandbox_workspace_write]
network_access  = false
writable_roots  = []

# Profiles — named overlays
[profiles.secure]
approval_policy = "untrusted"
sandbox_mode    = "read-only"

[profiles.fast]
approval_policy = "never"
sandbox_mode    = "workspace-write"
[profiles.fast.sandbox_workspace_write]
network_access = true

Use a profile·bash

# Cautious mode for first-time-on-this-repo work
codex --profile secure "explain the auth flow"

# Looser mode for batch automation
codex --profile fast --sandbox danger-full-access \
      "fix all eslint errors"

# One-off override without changing config file
codex -c sandbox_workspace_write.network_access=true \
      "fetch the API schema from docs.example.com"

External links

Codex config.toml reference

Exercise

config.toml 에 프로파일 3개 정의: secure, default, fast. 각자 진짜 작업에 사용. 각 프로파일이 맞았던 데와 방해됐던 데 적어.

Progress

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

← PreviousAGENTS.md — Codex 의 Project Memory Next →Slash Command + 커스텀

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

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

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

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