설정 체계와 프로필

~14 min · codex, config, toml, profiles

Level 0🌱 입문자

0 XP0/70 lessons0/11 achievements

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

설정은 계층으로 합치고 profile로 작업 모드를 바꿔

Codex 설정은 시스템, 사용자 ~/.codex/config.toml, 신뢰한 프로젝트의 .codex/config.toml, profile, 명령줄 옵션 순으로 덮어써. 저장소가 설정 파일을 갖고 있어도 사용자가 프로젝트를 신뢰하기 전에는 자동으로 sandbox를 느슨하게 만들지 않아.

profile은 한 파일 안에 여러 운영 모드를 묶는 방법이야. 낯선 코드용 secure, 일상 작업용 기본값, 격리된 반복 작업용 fast 정도면 대부분을 커버해. --profile 하나로 모델과 승인, sandbox 조합을 함께 바꿀 수 있어.

직접 확인할 항목: --profile NAME, --profile fast, --profile secure, -c key=value, /etc/codex/config.toml.

Code

실전 ~/.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

프로필 선택해서 실행하기·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 공식 참조

Exercise

config.toml에 secure, 기본, fast 프로필 3개를 정의해. 각 프로필로 실제 작업을 하나씩 수행하고, 어떤 상황에서 잘 맞았으며 어디에서 방해가 됐는지 적어.

Progress

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

← PreviousAGENTS.md — Codex에 프로젝트 규칙 알려 주기 Next →슬래시 명령과 사용자 정의 명령

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

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

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

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