For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to the page URL.
기본 탐색 메뉴
Theme

추천

맞춤 설정

설정 파일

에이전트 설정

ChatGPT와 Codex 확장하기

Linux

Windows

API 대시보드
ChatGPT 사용해 보기

설정 레퍼런스

Codex의 config.toml 및 requirements.toml 설정 전체 레퍼런스

이 페이지에서 Codex 설정 파일의 항목을 검색할 수 있습니다. 기본 개념과 예시는 기본 설정과 고급 설정에서 먼저 확인하세요.

Work 클라우드의 로컬 컴퓨터 액세스 설정

Work 클라우드에서 로컬 컴퓨터 액세스를 활성화하면 OpenAI 클라우드가 작업을 조율하고, 지원되는 도구는 클라우드 또는 연결된 컴퓨터에서 실행됩니다. 요구 사항은 허용 범위를 정하고 설정값은 기본값을 제공합니다.

전역 설정은 정책 API로 관리하세요. 로컬 또는 Codex Cloud 설정은 Agent Security UI에서 관리하세요. 마이그레이션 후에도 기존 전역 API 워크플로우를 사용할 수 있습니다. 스크립트와 Terraform 통합을 테스트하고 정책 할당과 적용 순서가 그대로인지 확인하세요. requirements.toml에서 필드를 지원한다는 사실만으로 API 호환성이 보장되지는 않습니다.

설정 또는 설정 그룹 Work 클라우드의 로컬 컴퓨터 액세스에서 적용되는 범위 지침
승인 정책 및 검토 요구 사항 관리형 정책이 활성화된 경우 전역 오케스트레이터 정책 승인 및 검토 설정은 전역 범위에 두세요. 환경별 재정의로 오케스트레이터 설정을 변경할 수 없습니다. 로컬 실행과 클라우드 컨테이너 실행에는 각각 별도의 정책 범위가 적용됩니다.
관리형 앱, MCP 서버, 플러그인, 마켓플레이스 및 명령어 규칙 전역 정책 이 설정들은 전역 범위에 두세요. 스키마에 필드가 있다고 해서 환경별로 편집할 수 있는 것은 아닙니다.
파일, 샌드박스 및 환경 간에 적용할 수 있는 네트워크 요구 사항 로컬 실행 로컬 실행에서는 MDM 및 기존 관리형 기기 요구 사항이 Agent Security보다 우선합니다. 기기의 시스템 요구 사항 파일은 Agent Security보다 우선순위가 낮습니다. 새 엔터프라이즈 requirements.toml 설정은 Work 클라우드 컨테이너에 적용되지 않습니다. 이 컨테이너에는 기존 Work 클라우드 정책이 계속 적용됩니다.
플랫폼별 실행기 설정 해당 단계를 실행하는 컴퓨터 지원 여부는 실행기와 플랫폼에 따라 다릅니다.
관리형 훅 활성화된 환경에서는 지원되는 수명 주기 이벤트와 도구 이벤트가 발생할 때 관리자가 정의한 MCP 훅이 클라우드 코디네이터(오케스트레이터)에서 실행됩니다. 이 훅에 의존하기 전에 콜백 연결을 테스트하고, 콜백이 수신하는 이벤트와 실패가 작업에 미치는 영향을 확인하세요. MCP 훅만으로는 완전한 Compliance API 감사 기록을 확보할 수 없습니다. 클라우드에서 작업을 조율할 때는 도구가 로컬에서 실행되더라도 명령어 훅, 로컬 설정 훅 및 플러그인 훅을 지원하지 않습니다. 조율과 실행이 모두 로컬에서 이루어지는 Work 및 Codex 스레드에는 기존에 지원되던 훅이 계속 적용됩니다.
프록시 리스너 주소, 포트 및 프로세스 설정 환경 간에 이식할 수 있는 정책이 아님 클라우드 런타임은 관리형 HTTP/SOCKS 리스너 포트와 비루프백 프록시 리스너를 지원하지 않습니다. 소켓 규칙 지원 여부는 실행 경로에 따라 다릅니다. 사용자 지정 프록시 설정은 지원되는 대상 제한과 별개입니다.
앱 전용 설정 및 일반 로컬 기본값 클라우드에서 작업을 조율할 때 사용하지 않을 수 있음 Work 클라우드의 로컬 컴퓨터 액세스 기능이 해당 설정을 사용하지 않더라도 앱에서 시행하는 제어는 계속 유효할 수 있습니다. 클라우드를 통한 정책 전달과 클라우드 브라우저 동작은 별도로 검증하세요.

Work 클라우드의 로컬 컴퓨터 액세스에 대한 Agent Security 요구 사항

로컬 액세스를 사용하는 Work와 dot에서는 관리형 정책을 활성화하면 지원되는 전역 정책이 공유 클라우드 오케스트레이터에 적용됩니다. 연결된 컴퓨터에는 로컬 실행 요구 사항이 적용됩니다. Work 클라우드 컨테이너와 dot 클라우드 컴퓨터는 자체 실행 설정과 요구 사항을 사용합니다. 로컬 및 클라우드 제어를 각각 테스트하세요.

Agent Security UI에서 제공하는 설정

  • 허용되는 승인 정책
  • 허용되는 웹 검색 모드

TOML에서 구성하는 설정

  • allowed_approvals_reviewers
  • auto_review
  • guardian_policy_config
  • apps
  • mcp_servers
  • plugins
  • rules

이 오케스트레이터 요구 사항은 전역 범위에만 적용됩니다. 공유 클라우드 기능의 권한을 설정하거나 로컬 실행 설정을 Work 클라우드 컨테이너 또는 dot 클라우드 컴퓨터에 적용하는 용도로는 사용할 수 없습니다.

Work 클라우드의 로컬 컴퓨터 액세스 호환성 제한

지원 여부는 필드, 정책 전달 방식, 작업 실행 위치에 따라 다릅니다. 동기화를 활성화하기 전에 구성원에게 실제로 적용되는 정책을 확인하세요. 아래 표에 표시된 일부 제어는 배포 환경에서 테스트해야 합니다.

한 정책 안에서 우선순위는 높은 순으로 OS별 환경 재정의 → 모든 OS에 대한 환경 재정의 → 전역 설정입니다. 우선순위가 낮은 정책이 더 구체적이더라도 우선순위가 높은 정책이 적용됩니다.

로컬 실행에서는 MDM 및 기존 관리형 기기 요구 사항이 Agent Security보다 우선하고, Agent Security는 기기의 시스템 요구 사항 파일보다 우선합니다. 네트워크 요구 사항을 비롯한 일부 요구 사항에는 필드별 병합 규칙과 런타임 제한이 있습니다. 예시는 관리형 설정을 참고하세요.

설정 또는 설정 그룹 Work 클라우드의 로컬 컴퓨터 액세스와의 호환성 관리자 지침
sqlite_home, log_dir, model_catalog_json 관리형 클라우드 재정의로는 지원되지 않습니다. 로컬 경로로 클라우드 저장소나 로그의 위치를 변경할 수 없습니다. 로컬 모델 카탈로그도 클라우드로 이전되지 않습니다.
model_provider, model_providers Work 클라우드의 로컬 컴퓨터 액세스에 대한 관리형 요구 사항이나 설정에서는 지원되지 않습니다. 이 필드로는 사용자 지정 추론 게이트웨이나 제공자 연결을 이전할 수 없습니다. 이는 모델 선택과 별개입니다.
enforce_residency 클라우드 정책 중 하나라도 이 설정을 활성화하면 Work 클라우드의 로컬 컴퓨터 액세스가 차단됩니다. 클라우드 정책 중 하나라도 enforce_residency를 활성화하면 Work와 dot 모두에서 로컬 컴퓨터 액세스 허용 설정이 비활성화됩니다. 이 보호 조치는 워크스페이스의 데이터 레지던시를 설정하지 않으며, 그 자체로 Work 클라우드나 dot을 비활성화하지도 않습니다.
application.network.enabled 및 application.network.domains Work 클라우드의 로컬 컴퓨터 액세스에서는 지원되지 않습니다. 이 앱 대상 제한을 Work 클라우드의 로컬 컴퓨터 액세스에서 명령어의 네트워크 통신을 제어하는 용도로 사용하지 마세요.
allow_browser_and_computer_use, in_app_browser, additional_developer_instructions 클라우드 정책 전달 여부를 검증해야 합니다. Work 클라우드의 로컬 컴퓨터 액세스는 이 관리형 요구 사항 키를 거부합니다. 앱에서 브라우저 제한을 검사하지만, 이것만으로 정책이 클라우드를 통해 전달되거나 클라우드 브라우저에서 시행된다고 볼 수는 없습니다. additional_developer_instructions에는 오케스트레이터 지원이 필요합니다.
experimental_network 및 permissions.<profile>.network 일부 지원됩니다. 지원되는 대상 및 실행기 제한은 사용자 지정 프록시 설정과 다릅니다. 클라우드 런타임은 관리형 HTTP/SOCKS 리스너 포트와 비루프백 프록시 리스너를 지원하지 않습니다. 소켓 규칙 지원 여부는 실행 경로에 따라 다릅니다. 로컬 실행 시의 병합 동작은 별개입니다. 명령어의 네트워크 제한은 호스팅된 검색, MCP 또는 앱 도구를 비활성화하지 않습니다.
기능 / feature_requirements, 모델, computer_use 일부 지원됩니다. 지원이 종료된 스위치 설정인 tool_search = false, tool_search_always_defer_mcp_tools = false, js_repl = true, remote_control = true 등은 거부됩니다. 일부 컴퓨터 사용 설정은 여전히 엔드투엔드 검증이 필요합니다.
browser_use, allow_appshots, 피드백, allow_remote_control, 마켓플레이스 소스 제한 일부 정책 전달 경로에서는 앱 또는 앱 서버가 이 제어를 시행합니다. Work 클라우드의 로컬 컴퓨터 액세스가 필드를 무시해도 앱 제어는 적용될 수 있습니다. 데스크톱 브라우저의 사이트 규칙은 Work 클라우드 컨테이너에 적용되지 않습니다. 실제 사용 환경과 정책 전달 경로에서 검증하세요.

설정 스키마에는 Work 클라우드의 로컬 컴퓨터 액세스에서 작동하지 않거나 환경별 재정의를 지원하지 않을 수 있는 키도 포함되어 있습니다. 전역 기준 설정과 우선순위는 관리형 설정을 참고하세요.

config.toml

사용자 수준 설정은 ~/.codex/config.toml에 저장됩니다. .codex/config.toml 파일에 프로젝트별 재정의도 추가할 수 있습니다. Codex는 사용자가 신뢰하는 프로젝트에서만 프로젝트별 설정 파일을 로드합니다.

프로젝트별 설정으로는 기기 로컬 제공자, 인증, 호스트가 관리하는 앱 요청 메타데이터, 알림, 설정 프로필 선택 또는 텔레메트리 라우팅 키를 재정의할 수 없습니다. Codex는 openai_base_url, chatgpt_base_url, apps_mcp_product_sku, model_provider, model_providers, notify, profile, profiles, experimental_realtime_ws_base_url, otel이 프로젝트의 .codex/config.toml에 있으면 무시합니다. 제공자, 알림 및 텔레메트리 키는 사용자 수준 설정에 넣으세요. 설정 프로필 파일은 config.toml과 같은 디렉터리에 $CODEX_HOME/profile-name.config.toml 형식으로 저장됩니다. --profile profile-name으로 프로필을 선택하세요.

샌드박스 및 승인 키(approval_policy, sandbox_mode, sandbox_workspace_write.*)는 이 레퍼런스와 함께 샌드박스 및 승인, 쓰기 가능한 루트의 보호 경로, 네트워크 액세스를 참고하세요. 베타 권한 프로필은 권한을 참고하세요.

Codex와 ChatGPT Work는 더 이상 approval_policy = "untrusted"를 지원하지 않습니다. 해당 설정을 제거하거나 지원되는 정책을 선택하세요. trust_level = "untrusted"가 지정된 프로젝트 항목은 사용자 수준 ~/.codex/config.toml에서 계속 지원됩니다. 예시와 승인 방식별 장단점은 지원이 종료된 untrusted 승인 정책에서 마이그레이션하기를 참고하세요.

model에는 로그인한 계정이나 워크스페이스에서 사용할 수 있는 모델을 지정하세요. 예시 값을 사용하기 전에 GPT-6.1 Sol 사용 가능 여부를 확인하세요.

Key
agents
Type / Values
table
Details
멀티 에이전트 설정 및 사용자 지정 역할 선언입니다. 스칼라 설정 이름은 예약되어 있어 사용자 지정 역할 이름으로 사용할 수 없습니다.
Key
agents.<name>.config_file
Type / Values
string (path)
Details
해당 역할의 TOML 설정 레이어 경로입니다. 상대 경로의 기준은 역할을 선언한 설정 파일의 위치입니다.
Key
agents.<name>.description
Type / Values
string
Details
Codex가 해당 유형의 에이전트를 선택하고 생성할 때 참고할 역할 지침입니다.
Key
agents.default_subagent_model
Type / Values
string
Details
새로 생성할 에이전트의 기본 모델입니다. 생성 시 명시한 모델이 우선합니다.
Key
agents.default_subagent_reasoning_effort
Type / Values
string
Details
새로 생성할 에이전트의 기본 추론 수준입니다. 생성 시 명시한 추론 수준이 우선합니다.
Key
agents.enabled
Type / Values
boolean
Details
멀티 에이전트 도구를 활성화하거나 비활성화합니다. 기본값은 true입니다.
Key
agents.interrupt_message
Type / Values
boolean
Details
에이전트 턴이 중단되면 모델이 볼 수 있는 메시지를 기록합니다. 기본값은 true입니다.
Key
agents.max_concurrent_threads_per_session
Type / Values
number
Details
기본 스레드를 제외하고 동시에 열어 둘 수 있는 하위 에이전트 스레드의 최대 개수입니다. 생략하면 Codex가 기본값을 정합니다.
Key
agents.max_threads
Type / Values
number
Details
agents.max_concurrent_threads_per_session의 기존 별칭입니다.
Key
allow_login_shell
Type / Values
boolean
Details
셸 기반 도구가 로그인 셸로 동작하도록 허용합니다. 기본값은 true입니다. false이면 login = true 요청을 거부하고 login을 생략한 경우 비로그인 셸을 사용합니다.
Key
allow_symlinked_codex_home
Type / Values
boolean
Details
macOS에서 $CODEX_HOME 자체 또는 그 아래에 있는 쓰기 가능한 샌드박스 루트가 심볼릭 링크를 따라가도록 허용합니다. Codex는 시작할 때 실행 호스트의 $CODEX_HOME/config.toml에서만 이 값을 읽습니다. 활성화하면 해당 디렉터리 밖의 링크 대상과 명령어 실행 사이에 변경되는 대상도 신뢰합니다. 쓰기 가능한 루트가 추가되지는 않습니다. 기본값은 false입니다.
Key
analytics.enabled
Type / Values
boolean
Details
이 기기 또는 프로필의 분석 기능을 켜거나 끕니다. false로 설정하면 기본 제공 Statsig 메트릭 내보내기 도구가 꺼집니다. 명시적으로 설정한 OTLP 메트릭 내보내기 도구는 계속 작동합니다. 생략하면 클라이언트 기본값이 적용됩니다.
Key
approval_policy
Type / Values
on-request | never | { granular = { sandbox_approval = bool, rules = bool, mcp_elicitations = bool, request_permissions = bool, skill_approval = bool } }
Details
Codex가 명령어를 실행하기 전에 멈추고 승인을 요청할 시점을 정합니다. approval_policy = { granular = { ... } }를 사용하면 특정 유형의 승인 요청은 표시를 허용하거나 자동 거부하고 나머지는 대화형으로 처리할 수 있습니다. untrusted는 지원되지 않으며 on-failure는 사용 중단 예정(deprecated)입니다. 대화형 실행에는 on-request, 비대화형 실행에는 never를 사용하세요.
Key
approval_policy.granular.mcp_elicitations
Type / Values
boolean
Details
true이면 MCP의 추가 입력 요청을 자동 거부하지 않고 표시할 수 있습니다.
Key
approval_policy.granular.request_permissions
Type / Values
boolean
Details
true이면 request_permissions 도구의 요청을 표시할 수 있습니다.
Key
approval_policy.granular.rules
Type / Values
boolean
Details
true이면 execpolicy의 prompt 규칙에 따른 승인 요청을 표시할 수 있습니다.
Key
approval_policy.granular.sandbox_approval
Type / Values
boolean
Details
true이면 샌드박스 권한 상승 승인 요청을 표시할 수 있습니다.
Key
approval_policy.granular.skill_approval
Type / Values
boolean
Details
true이면 스킬 스크립트 승인 요청을 표시할 수 있습니다.
Key
approvals_reviewer
Type / Values
user | auto_review
Details
on-request 또는 세분화된 승인 정책에서 검토 대상인 승인 요청을 누가 검토할지 지정합니다. 기본값은 user이며 auto_review는 검토용 하위 에이전트를 사용합니다. 이 설정은 샌드박스 동작을 바꾸거나 샌드박스 안에서 이미 허용된 작업을 검토하지 않습니다.
Key
apps._default.approvals_reviewer
Type / Values
user | auto_review
Details
앱별 재정의가 없을 때 앱 도구의 승인 요청을 검토할 기본 검토자입니다. 생략하면 앱이 최상위 approvals_reviewer 값을 상속합니다.
Key
apps._default.default_tools_approval_mode
Type / Values
auto | prompt | writes | approve
Details
앱별 또는 도구별 재정의가 없는 앱 도구의 기본 승인 방식입니다.
Key
apps._default.destructive_enabled
Type / Values
boolean
Details
destructive_hint = true인 앱 도구를 기본적으로 허용할지 거부할지 정합니다.
Key
apps._default.enabled
Type / Values
boolean
Details
앱별 재정의가 없을 때 모든 앱에 적용할 기본 활성화 상태입니다.
Key
apps._default.open_world_enabled
Type / Values
boolean
Details
open_world_hint = true인 앱 도구를 기본적으로 허용할지 거부할지 정합니다.
Key
apps.<id>.approvals_reviewer
Type / Values
user | auto_review
Details
이 앱의 도구 승인 요청을 검토할 검토자입니다. apps._default.approvals_reviewer를 재정의합니다.
Key
apps.<id>.default_tools_approval_mode
Type / Values
auto | prompt | writes | approve
Details
도구별 재정의가 없을 때 이 앱의 도구에 적용할 기본 승인 방식입니다.
Key
apps.<id>.default_tools_enabled
Type / Values
boolean
Details
도구별 재정의가 없을 때 이 앱의 도구에 적용할 기본 활성화 상태입니다.
Key
apps.<id>.destructive_enabled
Type / Values
boolean
Details
이 앱에서 destructive_hint = true를 선언한 도구를 허용하거나 차단합니다.
Key
apps.<id>.enabled
Type / Values
boolean
Details
ID로 지정한 앱 또는 커넥터를 활성화하거나 비활성화합니다. 기본값은 true입니다.
Key
apps.<id>.omit_tools_from
Type / Values
array<string>
Details
direct, deferred, code_mode 중 지정한 경로에서 이 앱의 도구를 제외합니다. 앱과 MCP 서버의 제외 설정은 함께 적용됩니다.
Key
apps.<id>.open_world_enabled
Type / Values
boolean
Details
이 앱에서 open_world_hint = true를 선언한 도구를 허용하거나 차단합니다.
Key
apps.<id>.tools.<tool>.approval_mode
Type / Values
auto | prompt | writes | approve
Details
개별 앱 도구의 승인 방식을 재정의합니다.
Key
apps.<id>.tools.<tool>.enabled
Type / Values
boolean
Details
개별 앱 도구(예: repos/list)의 활성화 상태를 재정의합니다.
Key
auto_review.policy
Type / Values
string
Details
기본 자동 검토 정책을 대체하는 Markdown 텍스트입니다. 관리형 guardian_policy_config가 우선하며 빈 값은 무시됩니다.
Key
background_terminal_max_timeout
Type / Values
number
Details
빈 write_stdin 폴링(백그라운드 터미널 폴링)의 최대 대기 시간(밀리초)입니다. 기본값은 300000(5분)입니다. 기존 background_terminal_timeout 키를 대체합니다.
Key
browser_use.allow_history_access
Type / Values
boolean
Details
false로 설정하면 브라우저 방문 기록에 대한 액세스를 제한합니다. 관리형 요구 사항으로 이 제한을 강제할 수 있습니다.
Key
browser_use.default_origin_policy
Type / Values
table
Details
출처별 규칙이 없을 때 적용할 브라우저 제한입니다. access, uploads, downloads, full_cdp_access를 지원하며 각각 allow 또는 deny로 설정합니다.
Key
browser_use.origins.<origin>
Type / Values
table
Details
출처별 브라우저 제한입니다. browser_use.default_origin_policy와 같은 필드를 사용합니다. HTTP 또는 HTTPS 스킴을 포함하고 필요하면 포트를 지정하세요. 경로, 쿼리, 프래그먼트는 생략하세요. 로컬 값으로 관리형 거부 규칙을 완화할 수 없습니다.
Key
chatgpt_base_url
Type / Values
string
Details
ChatGPT 로그인 플로우에 사용할 기본 URL을 재정의합니다.
Key
check_for_update_on_startup
Type / Values
boolean
Details
시작할 때 Codex 업데이트를 확인합니다. 업데이트를 중앙에서 관리할 때만 false로 설정하세요.
Key
cli_auth_credentials_store
Type / Values
file | keyring | auto | ephemeral
Details
CLI가 캐시된 자격 증명을 저장할 위치를 정합니다.
Key
compact_prompt
Type / Values
string
Details
대화 기록의 컨텍스트 압축에 사용할 프롬프트를 인라인으로 재정의합니다.
Key
computer_use.default_app_access
Type / Values
allow | deny
Details
컴퓨터 사용에서 네이티브 앱에 적용할 기본 액세스 정책입니다. 앱별 항목에서 정책을 지정할 수 있지만 로컬 설정으로 관리형 제한을 완화할 수 없습니다.
Key
computer_use.macos.bundle_ids
Type / Values
map<string, allow | deny>
Details
번들 식별자를 키로 사용하는 macOS 네이티브 앱 액세스 설정입니다.
Key
computer_use.windows.always_allowed_app_ids
Type / Values
array<string>
Details
컴퓨터 사용 기능이 승인 요청 없이 열 수 있는 Windows 앱의 식별자입니다. 목록에 없는 앱은 승인이 필요합니다. 저장된 항목은 ChatGPT 데스크톱 앱의 컴퓨터 사용 설정에서 삭제하세요.
Key
computer_use.windows.aumids
Type / Values
map<string, allow | deny>
Details
애플리케이션 사용자 모델 ID(AUMID)를 키로 사용하는 패키징된 Windows 앱 액세스 설정입니다.
Key
computer_use.windows.exes
Type / Values
array<table>
Details
Windows 실행 파일 액세스 규칙입니다. 각 규칙에 publisher_name, product_name, access(allow 또는 deny)가 필요합니다. binary_name은 선택 사항입니다.
Key
default_permissions
Type / Values
string
Details
샌드박스 도구 호출에 적용할 기본 권한 프로필 이름입니다. 기본 제공 프로필은 :read-only, :workspace, :danger-full-access입니다. 사용자 지정 프로필 이름에는 일치하는 [permissions.<name>] 테이블이 필요합니다. sandbox_mode 또는 [sandbox_workspace_write]와 함께 사용하지 마세요.
Key
desktop.custom_file_handlers.<id>
Type / Values
table
Details
사용자 수준에서만 설정할 수 있습니다. ChatGPT 데스크톱 앱의 다음으로 열기 메뉴에 대상을 추가합니다. 예시와 핸들러 ID 제약 조건은 사용자 지정 파일 핸들러 추가하기를 참고하세요.
Key
desktop.custom_file_handlers.<id>.args
Type / Values
array<string>
Details
명령어와 파일 입력 사이에 삽입할 인수입니다. 기본값은 []입니다.
Key
desktop.custom_file_handlers.<id>.command
Type / Values
string
Details
찾아서 실행할 실행 파일 경로 또는 명령어 이름입니다. 필수 항목입니다.
Key
desktop.custom_file_handlers.<id>.icon
Type / Values
string
Details
핸들러 아이콘의 번들 에셋 경로, Base64로 인코딩된 data:image/... URL, 파일 URI 또는 절대 로컬 경로입니다. 필수 항목이며 지원되지 않는 소스에는 기본 VS Code 아이콘을 사용합니다.
Key
desktop.custom_file_handlers.<id>.input
Type / Values
path | json_argument | json_stdin
Details
앱이 핸들러에 파일 입력을 전달하는 방식입니다. 기본값은 path입니다.
Key
desktop.custom_file_handlers.<id>.label
Type / Values
string
Details
다음으로 열기 메뉴에 표시할 이름입니다. 필수 항목입니다.
Key
desktop.custom_file_handlers.<id>.supports_ssh
Type / Values
boolean
Details
SSH 워크스페이스의 파일에도 이 핸들러를 제공합니다. 기본값은 false입니다.
Key
developer_instructions
Type / Values
string
Details
세션에 추가할 개발자 지침입니다(선택 사항).
Key
disable_paste_burst
Type / Values
boolean
Details
tui.disable_paste_burst가 없을 때 적용하는 기존 설정입니다. [tui] 아래의 설정을 사용하세요.
Key
experimental_compact_prompt_file
Type / Values
string (path)
Details
파일에서 컨텍스트 압축에 사용할 대체 프롬프트를 로드합니다(실험적 기능).
Key
experimental_use_unified_exec_tool
Type / Values
boolean
Details
통합 실행을 활성화하는 기존 이름입니다. [features].unified_exec 또는 codex --enable unified_exec를 사용하세요.
Key
features.apps
Type / Values
boolean
Details
앱(커넥터) 통합을 활성화합니다(안정 버전, 기본 활성화). 샌드박스 명령어용 네트워크 프록시와 해당 도메인 허용 목록은 앱 및 커넥터 트래픽을 제어하지 않습니다.
Key
features.code_mode.direct_only_tool_namespaces
Type / Values
array<string>
Details
코드 모드에서 직접 도구를 호출할 때만 사용할 수 있는 도구 네임스페이스입니다.
Key
features.code_mode.enabled
Type / Values
boolean
Details
코드 모드 기능 설정을 활성화합니다. 개발 중인 기능으로 기본적으로 꺼져 있습니다.
Key
features.code_mode.excluded_tool_namespaces
Type / Values
array<string>
Details
코드 모드가 중첩된 코드 모드 도구 지침에서 제외하고 실행기에도 노출하지 않을 도구 네임스페이스입니다.
Key
features.context_management.experimental_mode
Type / Values
boolean
Details
실험적 컨텍스트 관리 설정입니다. 현재는 이 기능을 사용할 수 없습니다.
Key
features.enable_request_compression
Type / Values
boolean
Details
지원되는 경우 스트리밍 요청 본문을 zstd로 압축합니다(안정 버전, 기본 활성화).
Key
features.fast_mode
Type / Values
boolean
Details
현재 모델이 제공하는 패스트 모드 설정을 활성화합니다(안정 버전, 기본 활성화). features.ultrafast_mode와는 독립적이며, 사용 가능 여부는 모델과 계정에 따라 다릅니다.
Key
features.goals
Type / Values
boolean
Details
목표 저장 및 자동 작업 계속하기를 활성화합니다(안정 버전, 기본 활성화).
Key
features.hooks
Type / Values
boolean
Details
hooks.json 또는 인라인 [hooks] 설정에서 로드한 수명 주기 훅을 활성화합니다. features.codex_hooks는 사용 중단 예정(deprecated)인 별칭입니다.
Key
features.memories
Type / Values
boolean
Details
메모리를 활성화합니다. 기본적으로 꺼져 있습니다.
Key
features.multi_agent
Type / Values
boolean
Details
멀티 에이전트 협업 도구(spawn_agent, send_input, resume_agent, wait_agent, close_agent)를 활성화합니다(안정 버전, 기본 활성화).
Key
features.network_proxy
Type / Values
boolean | table
Details
샌드박스 명령어용 네트워크 프록시를 시작합니다(실험적 기능, 기본 비활성화). 관리자가 활성화한 network_proxy 요구 사항이 프록시를 시작하는 경우를 제외하면 권한 프로필의 도메인 규칙을 시행하는 데 필요합니다. domains 같은 기능 수준 정책 옵션은 테이블로 설정하세요. 웹 검색, 앱, MCP 및 기타 호스팅 도구는 필터링하지 않습니다.
Key
features.network_proxy.allow_local_binding
Type / Values
boolean
Details
로컬 또는 사설 네트워크에 더 폭넓은 액세스를 허용합니다. 기본값은 false입니다. 이 경우에도 정확한 로컬 IP 리터럴이나 localhost를 지정한 허용 규칙으로 특정 로컬 대상을 허용할 수 있습니다.
Key
features.network_proxy.allow_upstream_proxy
Type / Values
boolean
Details
환경에서 제공하는 업스트림 프록시를 경유하도록 허용합니다. 기본값은 true입니다.
Key
features.network_proxy.dangerously_allow_all_unix_sockets
Type / Values
boolean
Details
허용 목록에 있는 소켓 외에 임의의 Unix 소켓 대상에도 액세스를 허용합니다. 기본값은 false입니다. 엄격하게 통제되는 환경에서만 사용하세요.
Key
features.network_proxy.dangerously_allow_non_loopback_proxy
Type / Values
boolean
Details
비루프백 리스너 주소를 허용합니다. 기본값은 false입니다. 활성화하면 프록시 리스너가 로컬호스트 외부에 노출될 수 있습니다.
Key
features.network_proxy.domains
Type / Values
map<string, allow | deny>
Details
샌드박스 네트워크 통신에 적용할 도메인 정책입니다. 기본적으로 설정되지 않으므로 allow 규칙을 추가하기 전까지 외부 대상은 허용되지 않습니다. 정확한 호스트, 하위 도메인만 지정하는 *.example.com, 기본 도메인과 하위 도메인을 지정하는 **.example.com, 전역 * 허용 규칙을 지원합니다. *는 공용 네트워크로의 아웃바운드 액세스를 광범위하게 허용하므로 범위가 제한된 규칙을 권장합니다. 차단할 대상에는 deny 규칙을 추가하세요. 충돌하면 deny가 우선합니다.
Key
features.network_proxy.enable_socks5
Type / Values
boolean
Details
SOCKS5 지원을 활성화합니다. 기본값은 true입니다.
Key
features.network_proxy.enable_socks5_udp
Type / Values
boolean
Details
SOCKS5를 통한 UDP를 허용합니다. 기본값은 true입니다.
Key
features.network_proxy.enabled
Type / Values
boolean
Details
명령어의 네트워크 액세스가 활성화되면 샌드박스 명령어용 네트워크 프록시를 시작합니다. 기본값은 false입니다. 프록시가 꺼져 있으면 권한 프로필의 도메인 규칙이 시행되지 않습니다.
Key
features.network_proxy.proxy_url
Type / Values
string
Details
샌드박스 네트워크 통신용 HTTP 리스너 URL입니다. 기본값은 "http://127.0.0.1:3128"입니다.
Key
features.network_proxy.socks_url
Type / Values
string
Details
SOCKS5 리스너 URL입니다. 기본값은 "http://127.0.0.1:8081"입니다.
Key
features.network_proxy.unix_sockets
Type / Values
map<string, allow | deny>
Details
샌드박스 네트워크 통신에 적용할 Unix 소켓 정책입니다. 기본적으로 설정되지 않습니다. 허용할 소켓에 allow 항목을 추가하세요.
Key
features.personality
Type / Values
boolean
Details
삭제된 기능 플래그입니다. 호환성을 위해 입력을 허용하지만 값은 무시합니다.
Key
features.prefer_mxc
Type / Values
boolean
Details
네이티브 기능과 정책이 허용하면 Windows 로컬 실행에 MXC를 우선 사용합니다. 그렇지 않으면 설정된 기존 샌드박스와 구성을 유지합니다. 독립 실행형 CLI에서는 기본적으로 꺼져 있고 데스크톱 앱에서는 롤아웃 설정으로 켤 수 있습니다. 명령어 실패 시에는 기존 구현으로 전환하지 않습니다.
Key
features.prevent_idle_sleep
Type / Values
boolean
Details
턴이 실행되는 동안 기기가 절전 모드로 전환되지 않도록 합니다(실험적 기능, 기본 비활성화).
Key
features.remote_plugin
Type / Values
boolean
Details
원격 플러그인 카탈로그를 활성화합니다(안정 버전, 기본 활성화).
Key
features.rollout_budget.enabled
Type / Values
boolean
Details
롤아웃 예산 추적을 활성화합니다. 개발 중인 기능으로 기본적으로 꺼져 있습니다. 활성화할 때는 limit_tokens와 reminder_at_remaining_tokens를 모두 설정하세요.
Key
features.rollout_budget.limit_tokens
Type / Values
integer
Details
롤아웃 예산 추적에 사용할 토큰 한도입니다. 양수여야 하며 롤아웃 예산을 활성화할 때 필수입니다.
Key
features.rollout_budget.prefill_token_weight
Type / Values
number
Details
롤아웃 예산 계산 시 프리필 토큰에 곱할 0 이상의 유한한 값입니다. 기본값은 1.0입니다.
Key
features.rollout_budget.reminder_at_remaining_tokens
Type / Values
array<integer>
Details
가중치를 적용한 남은 토큰 예산이 각 임계값을 지날 때마다 알림을 보냅니다. 롤아웃 예산 추적을 활성화할 때 이 목록을 지정하세요. 각 값은 양수이고 limit_tokens보다 작아야 합니다.
Key
features.rollout_budget.sampling_token_weight
Type / Values
number
Details
롤아웃 예산 계산 시 샘플링된 토큰에 곱할 0 이상의 유한한 값입니다. 기본값은 1.0입니다.
Key
features.shell_snapshot
Type / Values
boolean
Details
셸 환경의 스냅샷을 만들어 반복 실행하는 명령어의 속도를 높입니다(안정 버전, 기본 활성화).
Key
features.shell_tool
Type / Values
boolean
Details
명령어 실행 도구를 활성화합니다(안정 버전, 기본 활성화).
Key
features.skill_mcp_dependency_install
Type / Values
boolean
Details
스킬에 필요한 MCP 종속성이 없을 때 설치 여부를 묻고 설치할 수 있게 합니다(안정 버전, 기본 활성화).
Key
features.ultrafast_mode
Type / Values
boolean
Details
울트라패스트 모드 설정을 활성화합니다(안정 버전, 기본 활성화). features.fast_mode와는 독립적이며, 사용 가능 여부는 모델과 계정에 따라 다릅니다.
Key
features.unified_exec
Type / Values
boolean
Details
재개 가능한 명령어 실행을 사용합니다(안정 버전, 모든 플랫폼에서 활성화). 사용자의 비활성화 설정은 무시됩니다. 관리형 요구 사항으로 재개 가능한 프로세스와 write_stdin을 비활성화할 수 있으며, 이때도 일회성 exec_command는 사용할 수 있습니다.
Key
features.view_image
Type / Values
boolean
Details
로컬 이미지를 여는 기본 제공 도구 view_image를 활성화합니다. 기본값은 true입니다.
Key
features.web_search
Type / Values
boolean
Details
사용 중단 예정(deprecated)인 기존 스위치입니다. 최상위 web_search 설정을 사용하세요.
Key
features.web_search_cached
Type / Values
boolean
Details
사용 중단 예정(deprecated)인 기존 스위치입니다. web_search를 설정하지 않은 경우 true는 web_search = "cached"에 해당합니다.
Key
features.web_search_request
Type / Values
boolean
Details
사용 중단 예정(deprecated)인 기존 스위치입니다. web_search를 설정하지 않은 경우 true는 web_search = "live"에 해당합니다.
Key
feedback.enabled
Type / Values
boolean
Details
모든 로컬 클라이언트에서 /feedback으로 피드백을 제출할 수 있게 합니다. 기본값은 true입니다.
Key
file_opener
Type / Values
vscode | vscode-insiders | windsurf | cursor | none
Details
Codex 출력의 인용 출처를 열 때 사용할 URI 스킴입니다. 기본값은 vscode입니다.
Key
forced_chatgpt_workspace_id
Type / Values
string (uuid)
Details
ChatGPT 로그인을 특정 워크스페이스 식별자로 제한합니다.
Key
forced_login_method
Type / Values
chatgpt | api
Details
Codex에서 특정 인증 방식만 사용하도록 제한합니다.
Key
goals.max_goal_token_budget
Type / Values
integer (positive)
Details
새 목표의 기본 토큰 예산과 목표가 요청할 수 있는 최대 예산을 설정합니다. 목표에 한도를 설정하지 않으려면 생략하세요.
Key
hide_agent_reasoning
Type / Values
boolean
Details
TUI와 codex exec 출력 모두에서 추론 이벤트를 숨깁니다.
Key
history.max_bytes
Type / Values
number
Details
설정하면 가장 오래된 항목부터 삭제하여 기록 파일 크기를 지정한 바이트 수로 제한합니다.
Key
history.persistence
Type / Values
save-all | none
Details
Codex가 세션 기록을 history.jsonl에 저장할지 정합니다.
Key
hooks
Type / Values
table
Details
config.toml에 인라인으로 설정하는 수명 주기 훅입니다. hooks.json과 같은 이벤트 스키마를 사용합니다. 예시와 지원 이벤트는 훅 가이드를 참고하세요.
Key
hooks.<Event>
Type / Values
array<table>
Details
PreModelRequest, PostModelRequest, PreToolUse, PermissionRequest, PostToolUse, PreCompact, PostCompact, SessionStart, SessionEnd, SubagentStart, SubagentStop, UserPromptSubmit, Stop, Interrupt 등의 훅 이벤트에 대한 매처 그룹입니다.
Key
hooks.<Event>[].hooks
Type / Values
array<table>
Details
매처 그룹의 훅 핸들러입니다. 명령어 훅과 MCP 도구 훅을 지원합니다. 프롬프트 및 에이전트 훅 핸들러는 파싱하지만 실행하지 않습니다.
Key
hooks.<Event>[].hooks[].additionalContextLimit
Type / Values
integer
Details
큰 additionalContext를 디스크에 저장하고 모델에는 짧은 미리보기를 제공할 때 기준으로 삼는 핸들러별 대략적인 토큰 수입니다. 기본값은 2500이며 0이면 전체 컨텍스트를 모델에 직접 전달합니다. 대용량 훅 출력을 참고하세요.
Key
hooks.<Event>[].hooks[].async
Type / Values
boolean
Details
훅을 호출한 작업을 지연시키지 않고 명령어 훅을 백그라운드에서 실행합니다. 기본값은 false입니다. SessionEnd는 항상 동기적으로 실행됩니다. 백그라운드에서 훅 실행하기를 참고하세요.
Key
hooks.<Event>[].hooks[].commandWindows
Type / Values
string
Details
Windows에서만 명령어 훅의 명령어를 재정의합니다. TOML 별칭 command_windows도 사용할 수 있습니다.
Key
instructions
Type / Values
string
Details
향후 사용을 위해 예약되어 있습니다. model_instructions_file 또는 AGENTS.md를 사용하세요.
Key
log_dir
Type / Values
string (path)
Details
Codex가 로그 파일을 쓰는 디렉터리입니다. 기본값은 $CODEX_HOME/log입니다. 명시적으로 설정하면 해당 디렉터리에 평문 TUI 로그 파일 codex-tui.log도 기록합니다.
Key
marketplaces.<name>.ref
Type / Values
string
Details
마켓플레이스에 사용할 Git 브랜치, 태그 또는 커밋입니다(선택 사항).
Key
marketplaces.<name>.source
Type / Values
string
Details
Git 리포지터리 위치 또는 로컬 마켓플레이스 루트 디렉터리입니다. 로컬 소스에는 절대 경로를 사용하세요. 해당 디렉터리에는 .agents/plugins/marketplace.json이 있습니다.
Key
marketplaces.<name>.source_type
Type / Values
git | local
Details
설정한 플러그인 마켓플레이스의 소스 유형입니다. 마켓플레이스는 시스템, 클라우드 관리형, 사용자 또는 신뢰하는 프로젝트의 config.toml에 정의할 수 있습니다.
Key
marketplaces.<name>.sparse_paths
Type / Values
array<string>
Details
Git 마켓플레이스에서 선택적으로 체크아웃할 경로입니다. 마켓플레이스 카탈로그와 여기서 참조하는 로컬 플러그인 디렉터리를 포함하세요.
Key
mcp_oauth_callback_port
Type / Values
integer
Details
MCP OAuth 로그인에 사용하는 로컬 HTTP 콜백 서버의 전역 고정 포트입니다(선택 사항). 서버별 oauth.callback_port가 우선합니다. 둘 다 생략하면 Codex는 OS가 선택한 임시 포트에 바인딩합니다.
Key
mcp_oauth_callback_url
Type / Values
string
Details
MCP OAuth 로그인용 기본 콜백 URL입니다(선택 사항). 예를 들어 devbox 인그레스 URL을 사용할 수 있습니다. 인가 서버가 발급자 식별을 지원하면 새로 추가한 사전 등록 클라이언트는 이 URL을 그대로 사용하고, 저장된 콜백이 없는 기존 클라이언트는 서버별 콜백 ID를 덧붙입니다. 발급자 식별을 지원하지 않고 사전 등록된 MCP 서버의 콜백에 필수 ID가 없으면 이 URL에 ID를 붙여 사용합니다. 콜백 URL의 포트는 리스너 포트를 결정하지 않습니다.
Key
mcp_oauth_credentials_store
Type / Values
auto | file | keyring
Details
MCP OAuth 자격 증명에 우선 사용할 저장소입니다.
Key
mcp_optional_startup_grace_ms
Type / Values
integer (milliseconds)
Details
초기 도구 카탈로그를 구성할 때 선택적 MCP 서버들을 함께 기다리는 시간입니다. 기본값은 1000입니다. 0으로 설정하면 대신 각 서버의 startup_timeout_sec만큼 기다립니다.
Key
mcp_servers.<id>.args
Type / Values
array<string>
Details
MCP stdio 서버 명령어에 전달할 인수입니다.
Key
mcp_servers.<id>.auth
Type / Values
oauth | chatgpt
Details
설정된 Bearer 토큰과 인증 헤더를 사용할 수 없을 때 MCP HTTP 서버에 적용할 인증 방식입니다. oauth(기본값)는 저장된 MCP OAuth 자격 증명이 있으면 사용합니다. chatgpt는 신뢰할 수 있는 자사 ChatGPT 출처에 현재 ChatGPT 세션을 사용하고, 사용할 수 없으면 저장된 OAuth 자격 증명을 사용합니다. 어느 소스에서도 자격 증명을 가져올 수 없으면 두 모드 모두 인증 없이 연결할 수 있습니다.
Key
mcp_servers.<id>.bearer_token_env_var
Type / Values
string
Details
MCP HTTP 서버의 Bearer 토큰을 제공하는 환경 변수입니다.
Key
mcp_servers.<id>.command
Type / Values
string
Details
MCP stdio 서버를 시작할 명령어입니다.
Key
mcp_servers.<id>.cwd
Type / Values
string
Details
MCP stdio 서버 프로세스의 작업 디렉터리입니다.
Key
mcp_servers.<id>.default_tools_approval_mode
Type / Values
auto | prompt | writes | approve
Details
도구별 재정의가 없을 때 이 서버의 MCP 도구에 적용할 기본 승인 방식입니다.
Key
mcp_servers.<id>.disabled_tools
Type / Values
array<string>
Details
MCP 서버에서 enabled_tools 적용 후 사용할 거부 목록입니다.
Key
mcp_servers.<id>.enabled
Type / Values
boolean
Details
설정을 삭제하지 않고 MCP 서버를 비활성화할 수 있습니다.
Key
mcp_servers.<id>.enabled_tools
Type / Values
array<string>
Details
MCP 서버가 제공할 도구 이름의 허용 목록입니다.
Key
mcp_servers.<id>.env
Type / Values
map<string,string>
Details
MCP stdio 서버로 전달할 환경 변수입니다.
Key
mcp_servers.<id>.env_http_headers
Type / Values
map<string,string>
Details
MCP HTTP 서버에 사용할 HTTP 헤더의 값을 환경 변수에서 가져옵니다.
Key
mcp_servers.<id>.env_vars
Type / Values
array<string | { name = string, source = "local" | "remote" }>
Details
MCP stdio 서버에 추가로 전달을 허용할 환경 변수입니다. 문자열 항목의 기본값은 source = "local"입니다. source = "remote"는 실행기가 제공하는 원격 stdio에서만 사용하세요.
Key
mcp_servers.<id>.environment_id
Type / Values
string
Details
MCP 서버의 실행 환경입니다. 기본값은 local입니다. 설정된 실행기의 ID를 지정하면 해당 환경에서 stdio 서버를 실행하거나 스트리밍 가능한 HTTP 서버에 연결할 수 있습니다.
Key
mcp_servers.<id>.http_headers
Type / Values
map<string,string>
Details
각 MCP HTTP 요청에 포함할 고정 HTTP 헤더입니다.
Key
mcp_servers.<id>.http_headers_helper
Type / Values
string (command)
Details
HTTP 헤더 이름과 값을 JSON 객체로 출력하는 로컬 명령어입니다. 로컬에서 연결하는 HTTP MCP 서버에서만 지원됩니다. 명시적인 Bearer 토큰과 OAuth 자격 증명이 이 명령어가 제공하는 Authorization 헤더보다 우선합니다.
Key
mcp_servers.<id>.oauth_resource
Type / Values
string
Details
MCP 로그인 시 포함할 선택적 RFC 8707 OAuth 리소스 매개변수입니다.
Key
mcp_servers.<id>.oauth.callback_port
Type / Values
integer
Details
이 MCP 서버의 고정 OAuth 콜백 리스너 포트입니다. mcp_oauth_callback_port를 재정의합니다. 직접 루프백 콜백의 URL에 포트를 명시한 경우 리스너 포트도 동일하게 설정하세요.
Key
mcp_servers.<id>.oauth.callback_url
Type / Values
string
Details
서버별 OAuth 콜백입니다. 발급자 식별을 지원하거나 URL이 이미 서버별 콜백 ID로 끝나면 사전 등록된 클라이언트가 이 콜백을 재사용합니다. 그렇지 않으면 Codex가 전역 또는 기본 콜백에 해당 ID를 붙여 사용합니다. 사전 등록된 ID가 없는 클라이언트는 클라이언트 등록 시 이 콜백을 사용합니다.
Key
mcp_servers.<id>.oauth.client_id
Type / Values
string
Details
이 MCP 서버에서 권한 부여 및 토큰 교환에 사용할 사전 등록된 OAuth 클라이언트 ID입니다.
Key
mcp_servers.<id>.oauth.client_secret
Type / Values
string
Details
사전 등록된 클라이언트로 토큰을 교환할 때 사용할 OAuth 클라이언트 시크릿입니다. oauth.client_id와 시크릿 모두 비어 있으면 안 됩니다. 시크릿은 설정에 저장됩니다.
Key
mcp_servers.<id>.omit_tools_from
Type / Values
array<string>
Details
모델에 도구를 제공하는 경로 중 지정한 경로에서 이 서버의 도구를 제외합니다. direct(초기 도구), deferred(도구 검색), code_mode(코드 모드 스크립트) 중에서 선택하세요. 도구를 차단하려면 disabled_tools를 사용하세요. 빈 목록은 상속된 제외 설정을 해제합니다.
Key
mcp_servers.<id>.required
Type / Values
boolean
Details
활성화된 이 서버가 시작 시 준비되어 있어야 합니다. startup_readiness = "catalog"이면 유효한 캐시 카탈로그로 이 조건을 충족할 수 있습니다.
Key
mcp_servers.<id>.scopes
Type / Values
array<string>
Details
로그인 시 요청할 OAuth 범위입니다. 생략하면 Codex는 최초 인증 챌린지에서 지정한 범위를 사용하며, 해당 범위가 없으면 보호된 리소스의 메타데이터를 사용합니다.
Key
mcp_servers.<id>.startup_readiness
Type / Values
connection | catalog
Details
실제 연결이 성립해야 시작 준비가 완료된 것으로 판단하거나(connection, 기본값), 연결을 여는 동안 유효한 도구 카탈로그 캐시로 시작 조건을 충족하도록 합니다(catalog). 도구를 호출하려면 실제 연결이 필요합니다.
Key
mcp_servers.<id>.startup_timeout_ms
Type / Values
number
Details
startup_timeout_sec를 밀리초 단위로 지정하는 별칭입니다.
Key
mcp_servers.<id>.startup_timeout_sec
Type / Values
number
Details
MCP 서버의 기본 시작 제한 시간인 10초를 재정의합니다.
Key
mcp_servers.<id>.supports_parallel_tool_calls
Type / Values
boolean
Details
이 서버의 모든 도구를 병렬로 실행해도 안전하다고 표시합니다. 서버가 모든 도구에 대한 동시 호출을 처리할 수 있을 때만 활성화하세요. 기본값은 false입니다.
Key
mcp_servers.<id>.tool_input_schema_max_bytes
Type / Values
integer (positive)
Details
일반 MCP 도구의 입력 스키마가 지정한 UTF-8 바이트 수를 초과하면 해당 스키마를 압축합니다. 기본값은 5,000바이트입니다. 값을 명시하면 코드 모드에서 도구 입력 타입을 표시할 때도 사용합니다.
Key
mcp_servers.<id>.tool_timeout_sec
Type / Values
number
Details
MCP 서버의 기본 도구별 제한 시간인 60초를 재정의합니다.
Key
mcp_servers.<id>.tools.<tool>.approval_mode
Type / Values
auto | prompt | writes | approve
Details
이 서버의 개별 MCP 도구에 적용할 승인 방식을 재정의합니다.
Key
mcp_servers.<id>.tools.<tool>.output_token_limit
Type / Values
integer (positive)
Details
개별 MCP 도구의 출력에 사용할 토큰 예산입니다. 직렬화에 허용되는 표준 여유분 20%를 더하기 전의 값이며, 해당 도구의 출력을 잘라낼 때 적용하는 모델 기본 예산을 재정의합니다.
Key
mcp_servers.<id>.url
Type / Values
string
Details
스트리밍 가능한 HTTP를 사용하는 MCP 서버의 엔드포인트입니다.
Key
memories.consolidation_model
Type / Values
string
Details
전체 메모리 통합에 사용할 모델을 별도로 지정합니다(선택 사항).
Key
memories.consolidation_service_tier
Type / Values
string
Details
전체 메모리 통합에 사용할 서비스 등급입니다. 기본값은 default(표준)입니다.
Key
memories.disable_on_external_context
Type / Values
boolean
Details
true이면 MCP 도구 호출, 웹 검색, 도구 검색 등 외부 컨텍스트를 사용한 스레드를 메모리 생성에서 제외합니다. 기본값은 false입니다. 기존 별칭은 memories.no_memories_if_mcp_or_web_search입니다.
Key
memories.dual_write
Type / Values
boolean
Details
v1을 선택한 상태에서 true로 설정하면 두 저장소를 모두 생성하고 읽기에는 계속 v1을 사용합니다. v2를 선택하면 Codex는 v2에만 기록합니다.
Key
memories.extract_model
Type / Values
string
Details
스레드별 메모리 추출에 사용할 모델을 별도로 지정합니다(선택 사항).
Key
memories.generate_memories
Type / Values
boolean
Details
false이면 새로 생성한 스레드를 메모리 생성 입력으로 저장하지 않습니다. 기본값은 true입니다.
Key
memories.max_raw_memories_for_consolidation
Type / Values
number
Details
전체 메모리 통합을 위해 보관할 최근 원본 메모리의 최대 개수입니다. 기본값은 256이고 상한은 4096입니다.
Key
memories.max_rollout_age_days
Type / Values
number
Details
메모리 생성 대상으로 고려할 스레드의 최대 경과 일수입니다. 기본값은 30이며 0~`90` 범위로 제한됩니다.
Key
memories.max_rollouts_per_startup
Type / Values
number
Details
시작 시 한 번에 처리할 최대 롤아웃 후보 수입니다. 기본값은 16이고 상한은 128입니다.
Key
memories.max_unused_days
Type / Values
number
Details
메모리가 마지막으로 사용된 후 통합 대상에 포함될 수 있는 최대 일수입니다. 기본값은 30이며 0~`365` 범위로 제한됩니다.
Key
memories.min_rate_limit_remaining_percent
Type / Values
number
Details
메모리 생성을 시작하려면 Codex 요청 한도 구간에 남아 있어야 하는 최소 비율입니다. 기본값은 25이며 0~`100`% 범위로 제한됩니다.
Key
memories.min_rollout_idle_hours
Type / Values
number
Details
스레드를 메모리 생성 대상으로 고려하기 전에 필요한 최소 유휴 시간입니다. 기본값은 6시간이며 1~`48`시간 범위로 제한됩니다.
Key
memories.use_memories
Type / Values
boolean
Details
false이면 Codex가 이후 세션에 기존 메모리를 추가하지 않습니다. 기본값은 true입니다.
Key
memories.version
Type / Values
v1 | v2
Details
로컬 메모리 저장소를 선택합니다. 메모리를 활성화한 경우 새 홈 디렉터리에서는 v2가 기본값이며 $CODEX_HOME/memories/가 있으면 v1이 기본값입니다. dual_write = false를 명시하면 기본값은 v1로 유지됩니다.
Key
model
Type / Values
string
Details
사용할 모델입니다(예: gpt-6.1-sol).
Key
model_auto_compact_token_limit
Type / Values
number
Details
대화 기록의 자동 컨텍스트 압축을 시작하는 토큰 임계값입니다. 생략하면 모델 기본값을 사용합니다.
Key
model_auto_compact_token_limit_scope
Type / Values
total | body_after_prefix
Details
자동 컨텍스트 압축 임계값을 계산할 때 활성 컨텍스트 전체를 셀지(total, 기본값), 이전 압축에서 이어받은 접두부 이후에 늘어난 토큰만 셀지(body_after_prefix) 정합니다.
Key
model_catalog_json
Type / Values
string (path)
Details
시작할 때 로드할 JSON 모델 카탈로그 경로입니다(선택 사항). 선택한 $CODEX_HOME/profile-name.config.toml 파일에서 프로필별로 재정의할 수 있습니다.
Key
model_context_window
Type / Values
number
Details
현재 모델의 컨텍스트 윈도우에서 사용할 수 있는 토큰 수입니다.
Key
model_instructions_file
Type / Values
string (path)
Details
AGENTS.md 대신 기본 제공 지침을 대체하는 데 사용할 파일입니다.
Key
model_post_turn_compact_threshold_percent
Type / Values
integer (0–100)
Details
활성 컨텍스트가 사용 가능한 컨텍스트 윈도우의 지정된 비율에 도달하면 최종 응답 후 대화 기록을 압축합니다. 생략하거나 0으로 설정하면 턴 종료 시의 컨텍스트 압축을 끕니다. 일반 자동 컨텍스트 압축 한도는 계속 적용됩니다.
Key
model_provider
Type / Values
string
Details
model_providers에 정의된 제공자 ID입니다. 기본값은 openai입니다.
Key
model_providers.<id>
Type / Values
table
Details
사용자 지정 제공자 정의입니다. 기본 제공 ID(openai, ollama, lmstudio)는 예약되어 있어 재정의할 수 없습니다.
Key
model_providers.<id>.auth
Type / Values
table
Details
사용자 지정 제공자의 Bearer 토큰을 명령어로 가져오기 위한 설정입니다. env_key, experimental_bearer_token, requires_openai_auth와 함께 사용하지 마세요.
Key
model_providers.<id>.auth.args
Type / Values
array<string>
Details
토큰 명령어에 전달할 인수입니다.
Key
model_providers.<id>.auth.command
Type / Values
string
Details
Codex에 Bearer 토큰이 필요할 때 실행할 명령어입니다. 명령어는 토큰을 표준 출력에 써야 합니다.
Key
model_providers.<id>.auth.cwd
Type / Values
string (path)
Details
토큰 명령어의 작업 디렉터리입니다.
Key
model_providers.<id>.auth.refresh_interval_ms
Type / Values
number
Details
Codex가 토큰을 미리 갱신하는 주기(밀리초)입니다. 기본값은 300000입니다. 0으로 설정하면 인증 재시도 후에만 갱신합니다.
Key
model_providers.<id>.auth.timeout_ms
Type / Values
number
Details
토큰 명령어의 최대 실행 시간(밀리초)입니다. 기본값은 5000입니다.
Key
model_providers.<id>.base_url
Type / Values
string
Details
모델 제공자의 API 기본 URL입니다.
Key
model_providers.<id>.capabilities.external_web_access
Type / Values
boolean
Details
제공자가 호스팅하는 웹 검색에서 실시간 웹에 액세스할 수 있는지 지정합니다. 생략하면 제공자 기본값을 유지합니다. 모델 및 턴 설정에서 액세스를 추가로 제한할 수 있습니다.
Key
model_providers.<id>.capabilities.remote_compaction
Type / Values
unsupported | v2
Details
제공자의 컨텍스트 압축 프로토콜입니다. unsupported는 로컬에서 컨텍스트를 압축하고 v2는 Responses를 통해 압축 트리거를 전송합니다. 생략하면 제공자 기본값을 유지합니다. 모델 및 턴 설정에서 지원 범위를 추가로 제한할 수 있습니다.
Key
model_providers.<id>.env_http_headers
Type / Values
map<string,string>
Details
환경 변수가 있으면 해당 값으로 채울 HTTP 헤더입니다.
Key
model_providers.<id>.env_key
Type / Values
string
Details
제공자의 API 키를 제공하는 환경 변수입니다.
Key
model_providers.<id>.env_key_instructions
Type / Values
string
Details
제공자의 API 키 설정 지침입니다(선택 사항).
Key
model_providers.<id>.experimental_bearer_token
Type / Values
string
Details
제공자에 직접 지정하는 Bearer 토큰입니다. 이 방식은 권장하지 않으므로 env_key를 사용하세요.
Key
model_providers.<id>.http_headers
Type / Values
map<string,string>
Details
제공자 요청에 추가할 고정 HTTP 헤더입니다.
Key
model_providers.<id>.model_catalog_url
Type / Values
string
Details
Codex 네이티브 모델 카탈로그의 전체 URL입니다. 제공자의 기본 모델 검색 방식을 유지하려면 생략하세요.
Key
model_providers.<id>.name
Type / Values
string
Details
사용자 지정 모델 제공자의 표시 이름입니다.
Key
model_providers.<id>.query_params
Type / Values
map<string,string>
Details
제공자 요청에 추가할 쿼리 매개변수입니다.
Key
model_providers.<id>.request_max_retries
Type / Values
number
Details
제공자에 보내는 HTTP 요청의 재시도 횟수입니다. 기본값은 4입니다.
Key
model_providers.<id>.requires_openai_auth
Type / Values
boolean
Details
제공자가 OpenAI 인증을 사용하는지 지정합니다. 기본값은 false입니다.
Key
model_providers.<id>.stream_idle_timeout_ms
Type / Values
number
Details
SSE 스트림의 유휴 제한 시간(밀리초)입니다. 기본값은 300000입니다.
Key
model_providers.<id>.stream_max_retries
Type / Values
number
Details
SSE 스트리밍 중단 시 재시도 횟수입니다. 기본값은 5입니다.
Key
model_providers.<id>.supports_standalone_web_search
Type / Values
boolean
Details
호환되는 독립형 웹 검색 엔드포인트를 지원한다고 알립니다. 기본값은 false입니다. 독립형 검색은 개발 중이며 기본적으로 꺼져 있습니다. 제공자가 호환된다는 이유만으로 활성화되지는 않습니다.
Key
model_providers.<id>.supports_websockets
Type / Values
boolean
Details
해당 제공자가 Responses API의 WebSocket 전송 방식을 지원하는지 지정합니다.
Key
model_providers.<id>.wire_api
Type / Values
responses
Details
제공자가 사용하는 프로토콜입니다. 지원되는 값은 responses뿐이며 생략하면 이 값을 사용합니다.
Key
model_providers.amazon-bedrock.aws.profile
Type / Values
string
Details
기본 제공 amazon-bedrock 제공자가 사용할 AWS 프로필 이름입니다.
Key
model_providers.amazon-bedrock.aws.region
Type / Values
string
Details
기본 제공 amazon-bedrock 제공자가 사용할 AWS 리전입니다.
Key
model_providers.gcp.base_url
Type / Values
string
Details
기본 제공 Google Cloud Vertex AI 엔드포인트를 재정의합니다. 생략하면 Codex가 프로젝트 ID와 위치를 바탕으로 엔드포인트를 구성합니다.
Key
model_providers.gcp.credential_file
Type / Values
string (absolute path)
Details
Google 애플리케이션 기본 자격 증명(ADC) 파일 경로입니다. 제공자의 인증 명령어에서만 GOOGLE_APPLICATION_CREDENTIALS를 재정의합니다.
Key
model_providers.gcp.location
Type / Values
string
Details
Vertex AI 엔드포인트에 사용할 Google Cloud 위치입니다. GOOGLE_CLOUD_LOCATION보다 우선합니다. 기본값은 global입니다.
Key
model_providers.gcp.project_id
Type / Values
string
Details
Vertex AI 엔드포인트에 사용할 Google Cloud 프로젝트 ID입니다. GOOGLE_CLOUD_PROJECT보다 우선합니다.
Key
model_reasoning_effort
Type / Values
string
Details
선택한 모델이 지원하는 추론 수준입니다. 예를 들어 low, medium, high, xhigh, max, ultra가 있습니다. 사용 가능한 수준은 모델과 클라이언트에 따라 다릅니다.
Key
model_reasoning_summary
Type / Values
auto | concise | detailed | none
Details
추론 요약의 상세 수준을 선택하거나 요약을 완전히 끕니다.
Key
model_verbosity
Type / Values
low | medium | high
Details
GPT-5 Responses API의 응답 상세도를 재정의합니다(선택 사항). 생략하면 선택한 모델 또는 프리셋의 기본값을 사용합니다.
Key
notice.hide_full_access_warning
Type / Values
boolean
Details
전체 권한 경고 메시지를 확인했는지 기록합니다.
Key
notice.hide_gpt-5.1-codex-max_migration_prompt
Type / Values
boolean
Details
gpt-5.1-codex-max 마이그레이션 안내를 확인했는지 기록합니다.
Key
notice.hide_gpt5_1_migration_prompt
Type / Values
boolean
Details
GPT-5.1 마이그레이션 안내를 확인했는지 기록합니다.
Key
notice.hide_rate_limit_model_nudge
Type / Values
boolean
Details
요청 한도에 따른 모델 전환 알림을 받지 않기로 했는지 기록합니다.
Key
notice.hide_world_writable_warning
Type / Values
boolean
Details
모든 사용자가 쓸 수 있는 Windows 디렉터리에 대한 경고를 확인했는지 기록합니다.
Key
notice.model_migrations
Type / Values
map<string,string>
Details
확인한 모델 마이그레이션을 이전 모델에서 새 모델로의 매핑으로 기록합니다.
Key
notify
Type / Values
array<string>
Details
알림을 보낼 때 호출할 명령어입니다. Codex에서 JSON 페이로드를 받습니다.
Key
openai_base_url
Type / Values
string
Details
기본 제공 openai 모델 제공자의 기본 URL을 재정의합니다.
Key
oss_provider
Type / Values
lmstudio | ollama
Details
--oss로 실행할 때 사용할 기본 로컬 제공자입니다. 생략하면 제공자를 선택하라는 메시지가 표시됩니다.
Key
otel.environment
Type / Values
string
Details
내보내는 OpenTelemetry 이벤트에 적용할 환경 태그입니다. 기본값은 dev입니다.
Key
otel.exporter
Type / Values
none | otlp-http | otlp-grpc
Details
OpenTelemetry 내보내기 도구를 선택하고 필요한 엔드포인트 메타데이터를 지정합니다.
Key
otel.exporter.<id>.endpoint
Type / Values
string
Details
OTEL 로그 내보내기 엔드포인트입니다.
Key
otel.exporter.<id>.headers
Type / Values
map<string,string>
Details
OTEL 내보내기 요청에 포함할 고정 헤더입니다.
Key
otel.exporter.<id>.protocol
Type / Values
binary | json
Details
OTLP/HTTP 내보내기 도구에서 사용할 프로토콜입니다.
Key
otel.exporter.<id>.tls.ca-certificate
Type / Values
string
Details
OTEL 내보내기 도구의 TLS에 사용할 CA 인증서 경로입니다.
Key
otel.exporter.<id>.tls.client-certificate
Type / Values
string
Details
OTEL 내보내기 도구의 TLS에 사용할 클라이언트 인증서 경로입니다.
Key
otel.exporter.<id>.tls.client-private-key
Type / Values
string
Details
OTEL 내보내기 도구의 TLS에 사용할 클라이언트 개인 키 경로입니다.
Key
otel.log_agent_responses
Type / Values
boolean
Details
기본 에이전트와 생성된 하위 에이전트의 최종 응답 텍스트를 설정된 OTLP 로그 내보내기 도구로 전송합니다. 기본값은 false입니다. 응답 텍스트에는 민감한 데이터가 포함될 수 있으며 응답당 최대 64 KiB까지 전송합니다.
Key
otel.log_guardian_assessments
Type / Values
boolean
Details
완료된 자동 승인 검토 결과를 설정된 OTLP 로그 내보내기 도구로 전송합니다. 기본값은 false입니다. 검토 사유에는 민감한 데이터가 포함될 수 있으며 사유당 최대 64 KiB까지 전송합니다.
Key
otel.log_user_prompt
Type / Values
boolean
Details
OpenTelemetry 로그와 함께 사용자 프롬프트 원문을 내보내도록 설정합니다.
Key
otel.metrics_exporter
Type / Values
none | statsig | otlp-http | otlp-grpc
Details
OpenTelemetry 메트릭 내보내기 도구를 선택합니다. 기본값인 statsig는 analytics.enabled 설정을 따릅니다. 명시적으로 설정한 OTLP 내보내기 도구는 이 설정과 독립적으로 작동합니다. 메트릭 내보내기를 끄려면 none으로 설정하세요.
Key
otel.span_attributes
Type / Values
map<string,string>
Details
내보내는 모든 트레이스 스팬에 문자열 속성을 추가합니다.
Key
otel.tool_result.max_bytes
Type / Values
integer (nonnegative)
Details
도구 결과마다 잘림 안내 앞에 로그로 기록할 최대 UTF-8 바이트 수입니다. 기본값은 2048입니다. 로그에 기록되는 출력에만 적용됩니다.
Key
otel.trace_exporter
Type / Values
none | otlp-http | otlp-grpc
Details
OpenTelemetry 트레이스 내보내기 도구를 선택하고 필요한 엔드포인트 메타데이터를 지정합니다.
Key
otel.trace_exporter.<id>.endpoint
Type / Values
string
Details
OTEL 로그의 트레이스 내보내기 엔드포인트입니다.
Key
otel.trace_exporter.<id>.headers
Type / Values
map<string,string>
Details
OTEL 트레이스 내보내기 요청에 포함할 고정 헤더입니다.
Key
otel.trace_exporter.<id>.protocol
Type / Values
binary | json
Details
OTLP/HTTP 트레이스 내보내기 도구에서 사용할 프로토콜입니다.
Key
otel.trace_exporter.<id>.tls.ca-certificate
Type / Values
string
Details
OTEL 트레이스 내보내기 도구의 TLS에 사용할 CA 인증서 경로입니다.
Key
otel.trace_exporter.<id>.tls.client-certificate
Type / Values
string
Details
OTEL 트레이스 내보내기 도구의 TLS에 사용할 클라이언트 인증서 경로입니다.
Key
otel.trace_exporter.<id>.tls.client-private-key
Type / Values
string
Details
OTEL 트레이스 내보내기 도구의 TLS에 사용할 클라이언트 개인 키 경로입니다.
Key
otel.tracestate
Type / Values
map<string,map<string,string>>
Details
트레이스 컨텍스트를 전파할 때 W3C tracestate 멤버의 필드를 설정합니다. 각 멤버는 필드 이름을 문자열 값에 매핑합니다.
Key
permissions.<name>.description
Type / Values
string
Details
이 프로필의 용도를 설명하는 텍스트입니다. 프로필은 extends를 통해 상위 프로필의 설명을 상속하지 않습니다.
Key
permissions.<name>.extends
Type / Values
string
Details
이 프로필보다 먼저 적용할 상위 프로필입니다(선택 사항). 이름이 있는 다른 프로필, :read-only 또는 :workspace를 지정하세요. :danger-full-access, 정의되지 않은 상위 프로필 및 순환 참조는 거부됩니다.
Key
permissions.<name>.filesystem
Type / Values
table
Details
이름이 있는 파일 시스템 권한 프로필입니다. 각 키는 절대 경로 또는 :minimal, :workspace_roots 같은 특수 토큰입니다.
Key
permissions.<name>.filesystem.":workspace_roots".<subpath-or-glob>
Type / Values
"read" | "write" | "deny"
Details
실제 적용되는 각 워크스페이스 루트를 기준으로 파일 시스템 액세스 범위를 정합니다. 루트 자체에는 "."을 사용하세요. "**/*.env" 같은 glob 하위 경로에는 "deny"로 읽기를 거부할 수 있습니다.
Key
permissions.<name>.filesystem.<path-or-glob>
Type / Values
"read" | "write" | "deny" | table
Details
경로, glob 패턴 또는 특수 토큰에 직접 액세스를 부여하거나 해당 루트 아래로 중첩 항목의 범위를 제한합니다. 일치하는 경로의 읽기를 거부하려면 "deny"를 사용하세요.
Key
permissions.<name>.filesystem.glob_scan_max_depth
Type / Values
number
Details
샌드박스 시작 전에 일치 항목의 스냅샷을 만드는 플랫폼에서 읽기 거부 glob 패턴을 확장할 최대 깊이입니다. 지정하는 경우 1 이상이어야 합니다.
Key
permissions.<name>.network.allow_local_binding
Type / Values
boolean
Details
샌드박스 네트워크 통신을 통해 로컬 또는 사설 네트워크에 더 폭넓은 액세스를 허용합니다. 정확한 로컬 IP 리터럴이나 localhost 허용 규칙이 있으면 이 값이 false여도 특정 로컬 대상을 허용할 수 있습니다.
Key
permissions.<name>.network.allow_upstream_proxy
Type / Values
boolean
Details
샌드박스 네트워크 통신이 다른 업스트림 프록시를 경유하도록 허용합니다.
Key
permissions.<name>.network.dangerously_allow_all_unix_sockets
Type / Values
boolean
Details
기본적으로 허용되는 제한된 집합 외에 임의의 Unix 소켓 대상도 허용합니다. 엄격하게 통제되는 환경에서만 사용하세요.
Key
permissions.<name>.network.dangerously_allow_non_loopback_proxy
Type / Values
boolean
Details
샌드박스 네트워크 리스너에 비루프백 바인딩 주소를 허용합니다. 활성화하면 리스너가 로컬호스트 외부에 노출될 수 있습니다.
Key
permissions.<name>.network.domains
Type / Values
table
Details
샌드박스 명령어에 적용할 도메인 규칙입니다. features.network_proxy 또는 활성화된 관리자 네트워크 요구 사항이 프록시를 켤 때만 시행됩니다. 정확한 호스트, *.example.com, **.example.com, 전역 * 허용 규칙을 지원하며 deny가 우선합니다. 웹 검색, 앱 또는 MCP 서버는 제한하지 않습니다.
Key
permissions.<name>.network.domains.<pattern>
Type / Values
allow | deny
Details
정확한 호스트나 *.example.com, **.example.com처럼 범위가 제한된 와일드카드 패턴을 허용하거나 거부합니다.
Key
permissions.<name>.network.enable_socks5
Type / Values
boolean
Details
이 권한 프로필에서 샌드박스 네트워크 통신을 활성화할 때 SOCKS5 지원을 제공합니다.
Key
permissions.<name>.network.enable_socks5_udp
Type / Values
boolean
Details
활성화하면 SOCKS5 리스너를 통한 UDP를 허용합니다.
Key
permissions.<name>.network.enabled
Type / Values
boolean
Details
이 권한 프로필의 명령어에 네트워크 액세스를 허용합니다. 이 설정이 네트워크 프록시를 시작하지는 않습니다. features.network_proxy나 활성화된 관리자 네트워크 요구 사항이 없으면 명령어는 네트워크에 직접 액세스하며 프로필의 도메인 규칙은 시행되지 않습니다.
Key
permissions.<name>.network.mode
Type / Values
limited | full
Details
하위 프로세스 트래픽에 사용할 네트워크 프록시 모드입니다.
Key
permissions.<name>.network.proxy_url
Type / Values
string
Details
이 권한 프로필에서 샌드박스 네트워크 통신을 활성화할 때 사용할 HTTP 리스너 URL입니다.
Key
permissions.<name>.network.socks_url
Type / Values
string
Details
이 권한 프로필에서 사용할 SOCKS5 프록시 엔드포인트입니다.
Key
permissions.<name>.network.unix_sockets
Type / Values
table
Details
샌드박스 네트워크 통신용 Unix 소켓 허용 목록을 재정의합니다. 소켓 경로를 키로 사용하세요. allow는 경로를 추가하고 deny는 거부합니다.
Key
permissions.<name>.network.unix_sockets.<path>
Type / Values
allow | deny
Details
allow로 Unix 소켓 절대 경로를 실제 허용 목록에 추가하거나 deny로 거부합니다. 거부된 항목은 실제 허용 목록에서 제외됩니다.
Key
permissions.<name>.workspace_roots
Type / Values
table
Details
프로필에서 정의하는 워크스페이스 루트입니다. 세션의 런타임 워크스페이스 루트와 함께 :workspace_roots 파일 시스템 규칙을 적용받습니다.
Key
permissions.<name>.workspace_roots.<path>
Type / Values
boolean
Details
true이면 해당 경로를 프로필의 워크스페이스 루트 집합에 포함합니다. 비활성화한 항목은 적용되지 않습니다.
Key
personality
Type / Values
none | friendly | pragmatic
Details
사용 중단 예정(deprecated)인 호환성 설정입니다. friendly와 pragmatic은 더 이상 스타일을 선택하지 않습니다. none은 모델 지침에서 기본 제공 성격 섹션을 생략합니다. 명시적으로 재정의한 지침에는 영향을 주지 않습니다.
Key
plan_mode_reasoning_effort
Type / Values
string
Details
선택한 모델이 지원하는 수준으로 계획 수립 모드의 추론 수준을 재정의합니다. 생략하면 계획 수립 모드의 기본 프리셋을 사용합니다.
Key
plugins._default.enabled
Type / Values
boolean
Details
설치된 플러그인의 기본 활성화 상태를 설정합니다. 소스에서 활성화한 플러그인은 plugins.<plugin>.enabled를 명시해 이 기본값을 재정의할 수 있습니다. 소스 또는 계정의 활성화 설정을 유지하려면 테이블을 생략하세요.
Key
plugins.<plugin>.enabled
Type / Values
boolean
Details
plugin-name@marketplace-name 키로 로컬 마켓플레이스 플러그인을 활성화하거나 비활성화합니다. 병합 후 실제 적용되는 설정에서 값을 읽으며, 신뢰하는 프로젝트의 설정이 사용자, 클라우드 관리형 및 시스템 기본값을 재정의할 수 있습니다. 마켓플레이스를 새로 고치면 비활성화된 플러그인도 설정에 따라 설치하거나 갱신할 수 있습니다. 워크스페이스에서 관리하는 활성화 상태는 재정의하지 않습니다.
Key
plugins.<plugin>.mcp_servers.<server>.default_tools_approval_mode
Type / Values
auto | prompt | writes | approve
Details
플러그인이 제공하는 MCP 서버 도구의 기본 승인 방식입니다.
Key
plugins.<plugin>.mcp_servers.<server>.disabled_tools
Type / Values
array<string>
Details
플러그인이 제공하는 MCP 서버에서 enabled_tools 적용 후 사용할 거부 목록입니다.
Key
plugins.<plugin>.mcp_servers.<server>.enabled
Type / Values
boolean
Details
플러그인 매니페스트를 변경하지 않고 설치된 플러그인에 포함된 MCP 서버를 활성화하거나 비활성화합니다.
Key
plugins.<plugin>.mcp_servers.<server>.enabled_tools
Type / Values
array<string>
Details
플러그인이 제공하는 MCP 서버에서 노출할 도구의 허용 목록입니다.
Key
plugins.<plugin>.mcp_servers.<server>.tools.<tool>.approval_mode
Type / Values
auto | prompt | writes | approve
Details
플러그인이 제공하는 개별 MCP 도구의 승인 방식을 재정의합니다.
Key
project_doc_fallback_filenames
Type / Values
array<string>
Details
AGENTS.md가 없을 때 추가로 확인할 파일 이름입니다.
Key
project_doc_max_bytes
Type / Values
number
Details
프로젝트 지침을 구성할 때 AGENTS.md에서 읽을 최대 바이트 수입니다.
Key
project_root_markers
Type / Values
array<string>
Details
상위 디렉터리에서 프로젝트 루트를 찾을 때 표식으로 사용할 파일 이름 목록입니다.
Key
projects.<path>.trust_level
Type / Values
string
Details
프로젝트 또는 작업 트리를 신뢰하거나 신뢰하지 않는 것으로 표시합니다("trusted" | "untrusted"). 신뢰하지 않는 프로젝트에서는 프로젝트 로컬 설정, 훅, 규칙을 비롯한 프로젝트별 .codex/ 레이어를 건너뜁니다.
Key
review_model
Type / Values
string
Details
/review에서 사용할 모델을 별도로 지정합니다. 생략하면 현재 세션의 모델을 사용합니다.
Key
sandbox_mode
Type / Values
read-only | workspace-write | danger-full-access
Details
명령어 실행 시 파일 시스템 및 네트워크 액세스에 적용할 샌드박스 정책입니다.
Key
sandbox_workspace_write.exclude_slash_tmp
Type / Values
boolean
Details
workspace-write 모드에서 /tmp를 쓰기 가능한 루트에서 제외합니다.
Key
sandbox_workspace_write.exclude_tmpdir_env_var
Type / Values
boolean
Details
workspace-write 모드에서 $TMPDIR을 쓰기 가능한 루트에서 제외합니다.
Key
sandbox_workspace_write.network_access
Type / Values
boolean
Details
workspace-write 샌드박스 안에서 아웃바운드 네트워크 액세스를 허용합니다.
Key
sandbox_workspace_write.writable_roots
Type / Values
array<string>
Details
sandbox_mode = "workspace-write"일 때 쓰기를 허용할 추가 루트입니다.
Key
service_tier
Type / Values
string
Details
새 턴에 사용할 기본 서비스 등급입니다. fast 또는 현재 모델이 지원한다고 명시한 다른 등급을 사용하세요. fast는 요청 값 priority에 해당합니다.
Key
shell_environment_policy.exclude
Type / Values
array<string>
Details
기존 환경 변수 제외 패턴입니다. 새 설정에는 shell_environment_policy.filters를 사용하고 같은 레이어에서 두 형식을 함께 사용하지 마세요.
Key
shell_environment_policy.experimental_use_profile
Type / Values
boolean
Details
하위 프로세스를 생성할 때 사용자의 셸 프로필을 사용합니다.
Key
shell_environment_policy.filters
Type / Values
map<string, include | exclude>
Details
대소문자를 구분하지 않는 표준 환경 변수 패턴 필터입니다. 포함 항목은 허용 목록을 만들며 이미 제외된 값은 복원하지 못합니다. 명시적인 set 값은 제외 처리 후에 적용됩니다. 같은 레이어에서 필터와 기존 exclude 또는 include_only 배열을 함께 사용하지 마세요.
Key
shell_environment_policy.ignore_default_excludes
Type / Values
boolean
Details
다른 필터를 적용하기 전에 이름에 KEY, SECRET 또는 TOKEN이 포함된 변수를 유지합니다. 기본값은 true입니다. 시크릿 관련 이름을 자동으로 제외하려면 false로 설정하세요.
Key
shell_environment_policy.include_only
Type / Values
array<string>
Details
기존 환경 변수 패턴 허용 목록입니다. 새 설정에는 shell_environment_policy.filters를 사용하고 같은 레이어에서 두 형식을 함께 사용하지 마세요.
Key
shell_environment_policy.inherit
Type / Values
all | core | none
Details
하위 프로세스를 생성할 때 적용할 기본 환경 상속 정책입니다.
Key
shell_environment_policy.set
Type / Values
map<string,string>
Details
제외 처리 후에 추가할 명시적 환경 변수 값입니다. 포함 필터에서 이 값들이 제거될 수 있습니다.
Key
show_raw_agent_reasoning
Type / Values
boolean
Details
현재 모델이 추론 원문을 출력하면 이를 표시합니다.
Key
skills.bundled.enabled
Type / Values
boolean
Details
Codex에 포함된 시스템 스킬을 로드합니다. 기본값은 true입니다. 신뢰하는 프로젝트의 설정에서 false로 지정하면 해당 프로젝트에서 번들 스킬을 비활성화합니다.
Key
skills.config
Type / Values
array<object>
Details
이름이나 경로로 스킬을 활성화하거나 비활성화합니다. 한 스킬에 여러 규칙이 일치하면 마지막 규칙이 우선합니다.
Key
skills.config.<index>.enabled
Type / Values
boolean
Details
지정한 스킬을 활성화하거나 비활성화합니다.
Key
skills.config.<index>.name
Type / Values
string
Details
이름이 정확히 일치하는 모든 스킬에 적용됩니다. 각 항목에는 name 또는 path 중 하나를 지정하세요.
Key
skills.config.<index>.path
Type / Values
string (path)
Details
개별 SKILL.md 파일의 절대 경로입니다.
Key
skills.include_instructions
Type / Values
boolean
Details
스킬 지침을 모델 컨텍스트에 자동으로 포함합니다. 기본값은 true입니다.
Key
skills.max_context_tokens
Type / Values
integer (positive)
Details
사용 가능한 스킬 카탈로그의 토큰 예산입니다. 기본값은 모델 컨텍스트 윈도우의 2%입니다. 명시적으로 지정한 값은 최대 10000토큰으로 제한됩니다.
Key
sqlite_home
Type / Values
string (path)
Details
Codex가 에이전트 작업 및 재개 가능한 기타 런타임 상태에 사용하는 SQLite 기반 상태 DB를 저장하는 디렉터리입니다.
Key
suppress_unstable_features_warning
Type / Values
boolean
Details
개발 중인 기능 플래그를 활성화할 때 표시되는 경고를 숨깁니다.
Key
thread_unload_delay_secs
Type / Values
integer (nonnegative)
Details
스레드가 비활성 상태이고 구독자가 없을 때 앱 서버가 해당 스레드를 메모리에서 해제하기까지 기다리는 시간(초)입니다. 0으로 설정하면 두 조건을 모두 충족하는 즉시 해제합니다. 기본값은 60초입니다.
Key
tool_output_token_limit
Type / Values
number
Details
개별 도구 또는 함수의 출력을 기록에 저장할 때 사용할 토큰 예산입니다.
Key
tool_suggest.disabled_tools
Type / Values
array<table>
Details
검색 가능한 특정 커넥터나 플러그인의 추천을 끕니다. 각 항목에 type = "connector" 또는 "plugin"과 id를 지정합니다.
Key
tool_suggest.discoverables
Type / Values
array<table>
Details
추가로 검색 가능한 커넥터나 플러그인을 도구로 추천하도록 허용합니다. 각 항목에 type = "connector" 또는 "plugin"과 id를 지정합니다.
Key
tools.web_search
Type / Values
boolean | { context_size = "low|medium|high", allowed_domains = [string], location = { country, region, city, timezone } }
Details
선택적 웹 검색 도구 설정입니다. 객체 형식으로 검색 컨텍스트 크기, 허용할 검색 도메인 및 대략적인 사용자 위치를 지정할 수 있습니다. 검색 도메인 필터는 샌드박스 명령어용 네트워크 도메인 규칙과 별개이며 커넥터나 MCP 서버를 제한하지 않습니다.
Key
tui
Type / Values
table
Details
인라인 데스크톱 알림 활성화 등 TUI 전용 옵션입니다.
Key
tui.alternate_screen
Type / Values
auto | always | never
Details
TUI의 대체 화면 사용 여부를 정합니다. 기본값은 auto이며, auto는 Zellij에서 스크롤 기록을 보존하기 위해 대체 화면을 사용하지 않습니다.
Key
tui.animations
Type / Values
boolean
Details
터미널 애니메이션(시작 화면, 반짝임 효과, 스피너)을 활성화합니다. 기본값은 true입니다.
Key
tui.auto_recap
Type / Values
boolean
Details
터미널에 포커스가 없을 때 대화 요약을 자동 생성합니다. 기본값은 true입니다. false로 설정하면 자동 요약을 끄지만 /recap은 계속 사용할 수 있습니다.
Key
tui.disable_paste_burst
Type / Values
boolean
Details
TUI에서 한꺼번에 붙여넣은 입력의 감지를 끕니다. 기본값은 false이며 기존 최상위 disable_paste_burst 설정보다 우선합니다.
Key
tui.keymap.<context>.<action>
Type / Values
string | array<string>
Details
TUI 동작에 할당할 키보드 단축키입니다. 지원되는 컨텍스트에는 global, chat, composer, editor, vim_normal, vim_operator, vim_text_object, pager, list, approval이 있습니다. 일부 Composer 동작은 별도 바인딩이 없으면 일치하는 tui.keymap.global 바인딩을 사용합니다. 컨텍스트별 바인딩을 지원하는 경우 해당 바인딩이 우선합니다.
Key
tui.keymap.<context>.<action> = []
Type / Values
empty array
Details
해당 키맵 컨텍스트에서 동작의 키 바인딩을 해제합니다. 키 이름에는 ctrl-a, shift-enter, page-down, minus처럼 정규화된 문자열을 사용합니다.
Key
tui.model_availability_nux.<model>
Type / Values
integer
Details
모델 슬러그를 키로 사용하는 시작 툴팁의 내부 상태입니다.
Key
tui.notification_condition
Type / Values
unfocused | always
Details
터미널에 포커스가 없을 때만 TUI 알림을 보낼지, 포커스와 관계없이 보낼지 정합니다. 기본값은 unfocused입니다.
Key
tui.notification_method
Type / Values
auto | osc9 | bel
Details
터미널 알림 방식입니다. 기본값은 auto입니다.
Key
tui.notifications
Type / Values
boolean | array<string>
Details
TUI 알림을 활성화합니다. 필요하면 특정 이벤트 유형으로 제한할 수 있습니다.
Key
tui.presets.<digit>.input
Type / Values
string
Details
번호가 0~`9인 슬롯 10개 중 하나에 프롬프트나 슬래시 명령어를 저장합니다. 슬롯은 /presets로 확인할 수 있습니다. 텍스트는 비어 있으면 안 되며 UTF-8 기준 최대 8,000바이트입니다. !`로 시작하는 셸 명령어는 지원되지 않습니다.
Key
tui.presets.<digit>.label
Type / Values
string
Details
선택 메뉴와 단축키 안내에 표시할 프리셋 이름입니다(선택 사항).
Key
tui.raw_output_mode
Type / Values
boolean
Details
터미널에서 텍스트를 선택하고 복사하기 쉬운 원본 스크롤 기록 모드로 TUI를 시작합니다. 기본값은 false입니다. /raw 또는 기본 단축키 alt-r로 전환할 수 있습니다.
Key
tui.resume_cwd
Type / Values
current | session
Details
세션을 재개하거나 포크할 때 사용할 작업 디렉터리입니다. 생략하면 현재 디렉터리와 세션에 저장된 디렉터리가 다를 때 Codex가 사용자에게 선택을 요청합니다.
Key
tui.show_server_version_notice
Type / Values
boolean
Details
연결된 앱 서버의 버전 차이에 대한 안내를 표시합니다. 기본값은 true입니다. 호환성 오류나 버전 상태는 숨기지 않습니다.
Key
tui.show_tooltips
Type / Values
boolean
Details
TUI 시작 화면에 사용 안내 툴팁을 표시합니다. 기본값은 true입니다.
Key
tui.status_line
Type / Values
array<string> | null
Details
TUI 하단 상태 줄에 표시할 항목 식별자를 순서대로 나열합니다. null이면 상태 줄을 끕니다.
Key
tui.terminal_title
Type / Values
array<string> | null
Details
터미널 창 또는 탭 제목에 표시할 항목 식별자를 순서대로 나열합니다. 기본값은 ["spinner", "project"]이며 null이면 제목 갱신을 끕니다.
Key
tui.theme
Type / Values
string
Details
구문 강조 테마를 재정의합니다. 테마 이름은 케밥 케이스로 지정합니다.
Key
tui.vim_mode_default
Type / Values
boolean
Details
Composer를 Vim 삽입 모드 대신 일반 모드로 시작합니다. 기본값은 false입니다. 세션마다 /vim으로 전환할 수 있습니다.
Key
web_search
Type / Values
disabled | cached | indexed | live
Details
웹 검색 모드입니다. 기본값은 "cached"입니다. cached는 외부 웹에 액세스하지 않고 OpenAI가 관리하는 인덱스를 사용합니다. indexed는 검색 인덱스가 허용하는 경우에만 외부에 액세스합니다. --yolo 또는 다른 전체 권한 샌드박스 설정을 사용하면 기본값은 "live"입니다. 제한 없는 실시간 조회에는 "live"를 사용하고 도구를 제거하려면 "disabled"를 사용하세요.
Key
windows.sandbox
Type / Values
mxc | elevated | unelevated
Details
네이티브 Windows 샌드박스 구현입니다. MXC를 사용할 수 없거나 관리형 요구 사항에서 금지하면 명시적인 mxc 선택은 실패합니다. 기존 구현을 선택하고 features.prefer_mxc를 함께 사용하면 MXC를 자동으로 선택하되 필요할 때 기존 구현으로 대체합니다.

config.toml의 최신 JSON 스키마는 여기에서 확인할 수 있습니다.

VS Code나 Cursor에서 config.toml을 편집할 때 자동 완성과 진단 기능을 사용하려면 Even Better TOML 확장 프로그램을 설치하고 config.toml 맨 위에 다음 줄을 추가하세요.

#:schema https://developers.openai.com/codex/config-schema.json

참고: experimental_instructions_file의 이름을 model_instructions_file로 변경하세요. Codex에서 이전 키는 사용 중단 예정(deprecated)이므로 기존 설정에서도 새 이름을 사용하세요.

requirements.toml

requirements.toml은 관리자가 보안에 민감한 설정에 제한을 두는 파일입니다. 사용자는 이 제한을 재정의할 수 없습니다. 자세한 내용, 파일 위치 및 예시는 관리자가 시행하는 요구 사항을 참고하세요.

ChatGPT Business 및 Enterprise 사용자의 경우 Codex는 클라우드에서 가져온 요구 사항도 적용할 수 있습니다. 우선순위는 보안 페이지를 참고하세요. 자체 HTTPS 엔드포인트에서 CLI 정책을 제공하는 방법은 팀의 Codex 설정을 자체 호스팅하기를 참고하세요.

[features]를 requirements.toml에 추가하면 config.toml에서 사용하는 것과 같은 정식 키로 런타임 기능 플래그 값을 고정할 수 있습니다. 요구 사항에는 문서에 명시된 앱 전용 키도 포함할 수 있습니다. 이 키는 config.toml에 넣지 않습니다. 생략한 키에는 제한이 적용되지 않습니다.

일부 관리형 요구 사항은 허용 목록 대신 특정 설정값을 강제합니다. 사용자는 이렇게 지정된 경로, 업데이트 환경설정, 로그인 셸 정책 또는 피드백 설정을 재정의할 수 없습니다.

관리형 권한 프로필 허용 목록을 사용하려면 Codex 0.138.0 이상이 필요합니다. Codex 0.137.0 이하에서는 allowed_permission_profiles와 관리형 default_permissions를 무시합니다.

allowed_sandbox_modes는 sandbox_mode와 함께 사용하세요. 권한 프로필을 배포하는 경우 allowed_permission_profiles를 관리형 default_permissions와 함께 사용하세요.

untrusted는 allowed_approval_policies의 항목으로 여전히 유효합니다. 프로젝트가 trust_level = "untrusted"를 사용하면 Codex가 이에 따라 더 엄격한 승인 정책을 적용할 수 있습니다. 이 항목이 있어도 approval_policy = "untrusted"를 명시적으로 설정할 수는 없습니다.

[models.new_thread] 테이블은 관리형 기본값을 제공하며 해당 값을 강제하지 않습니다. --model, --config 또는 --profile로 모델이나 추론 수준 중 하나라도 명시적으로 재정의하면 Codex는 model과 model_reasoning_effort를 모두 [models.new_thread]에서 무시합니다. service_tier는 독립적으로 적용됩니다.

브라우저 관련 요구 사항은 세 가지 사용 환경에 각각 적용됩니다. in_app_browser는 사용자가 직접 열고 조작하는 브라우저 창을 제어합니다. browser_use는 에이전트가 브라우저에서 수행하는 작업을, computer_use는 에이전트가 네이티브 데스크톱 앱에서 수행하는 작업을 제어합니다.

브라우저 및 컴퓨터 사용 정책의 하위 설정값만으로는 액세스 권한이 부여되지 않습니다. 특정 출처나 앱에 지정한 allow는 같은 정책 소스의 기본값을 재정의할 수 있지만, 일반적인 기능 검사, 승인 및 기타 정책 검사는 계속 적용됩니다. 관리형 요구 사항과 config.toml이 모두 적용되는 경우 어느 한쪽이라도 deny를 지정하면 액세스가 거부됩니다.

Key
additional_developer_instructions
Type / Values
string
Details
별도의 개발자 메시지로 추가할 관리형 개발자 지침입니다. 컨텍스트 마커를 포함한 추정 토큰 수가 10,000개를 초과하면 Codex는 지침을 거부합니다.
Key
allow_appshots
Type / Values
boolean
Details
false로 설정하면 관리 대상 사용자의 Appshots를 비활성화합니다. 생략하면 요구 사항에서 Appshots를 제한하지 않으며 일반적인 제품 제공 조건이 적용됩니다.
Key
allow_browser_and_computer_use
Type / Values
boolean
Details
false로 설정하면 에이전트가 브라우저를 조작하는 기능과 네이티브 앱에서 컴퓨터 사용 기능을 모두 차단합니다. true로 설정하거나 생략해도 두 기능이 활성화되지는 않습니다. 나머지 기능, 정책 및 승인 검사가 계속 적용됩니다.
Key
allow_login_shell
Type / Values
boolean
Details
셸 도구의 로그인 셸 시작 허용 여부를 강제합니다.
Key
allow_managed_hooks_only
Type / Values
boolean
Details
true이면 Codex가 사용자, 프로젝트, 세션 및 플러그인 훅을 건너뜁니다. requirements.toml 및 다른 관리형 설정 레이어의 관리형 훅은 계속 허용합니다.
Key
allow_remote_control
Type / Values
boolean
Details
false로 설정하면 관리 대상 사용자의 기기 원격 제어를 비활성화합니다. 생략하면 요구 사항에서 기기 원격 제어를 제한하지 않으며 일반적인 제품 제공 조건이 적용됩니다.
Key
allowed_approval_policies
Type / Values
array<string>
Details
on-request, never, granular 등 허용할 승인 정책입니다. 신뢰하지 않는 프로젝트에서 파생되는 더 엄격한 정책을 허용하려면 untrusted를 포함하세요. 이 정책은 approval_policy로 직접 선택할 수 없습니다.
Key
allowed_approvals_reviewers
Type / Values
array<string>
Details
approvals_reviewer에 허용할 값입니다. 예를 들어 user와 auto_review가 있습니다.
Key
allowed_chatgpt_workspaces
Type / Values
array<string>
Details
Codex 액세스 토큰을 포함해 ChatGPT 로그인을 목록의 워크스페이스 ID로 제한합니다. 빈 목록은 ChatGPT 로그인을 비활성화합니다. API 인증이 허용되어 있으면 계속 사용할 수 있습니다. 로컬 시스템 요구 사항 파일 또는 macOS MDM에서 설정하세요. 클라우드 관리형 값은 무시됩니다.
Key
allowed_login_methods
Type / Values
array<string>
Details
chatgpt, api 또는 둘 다 허용합니다. 생략하면 로그인 방식을 제한하지 않습니다. 지정하면 목록에 하나 이상의 방식이 있어야 합니다. api는 Amazon Bedrock을 포함한 API 인증을 허용합니다. 로컬 시스템 요구 사항 파일 또는 macOS MDM에서 설정하세요. 클라우드 관리형 값은 무시됩니다.
Key
allowed_permission_profiles
Type / Values
table<boolean>
Details
허용할 권한 프로필의 전체 목록입니다. true로 설정한 프로필만 허용됩니다. 생략하거나 false로 설정한 프로필은 거부되며, 이후 버전에서 추가되는 프로필도 마찬가지입니다. 요구 사항 소스를 병합할 때는 프로필 이름으로 항목을 대조합니다.
Key
allowed_permission_profiles.<name>
Type / Values
boolean
Details
로드된 설정이나 요구 사항 소스에 정의된 기본 제공 또는 사용자 지정 권한 프로필을 허용하거나 거부합니다. 나중에 적용되는 우선순위가 높은 요구 사항 소스에서 false를 지정하면 앞서 우선순위가 낮은 소스가 허용한 프로필을 끌 수 있습니다.
Key
allowed_sandbox_modes
Type / Values
array<string>
Details
sandbox_mode에 허용할 값입니다.
Key
allowed_web_search_modes
Type / Values
array<string>
Details
web_search에 허용할 값(disabled, cached, indexed, live)입니다. disabled는 항상 허용되며 빈 목록은 사실상 disabled만 허용합니다.
Key
application
Type / Values
table
Details
데스크톱 앱의 관리형 요구 사항입니다.
Key
application.network
Type / Values
table
Details
데스크톱 앱 네트워크 요청의 대상 제한입니다. 명령어 네트워크 통신 및 브라우저 출처 규칙과 별개입니다. 네이티브 모듈이나 생성된 프로세스의 대상은 제한하지 않습니다.
Key
application.network.domains
Type / Values
table<allow | deny>
Details
데스크톱 앱 요청에 적용할 정확한 도메인 일치 규칙입니다. 정책을 활성화하면 명시적으로 허용된 도메인에만 HTTPS 및 WSS 요청을 허용합니다. 하위 도메인은 자동으로 허용되지 않습니다.
Key
application.network.domains.<domain>
Type / Values
allow | deny
Details
정확히 일치하는 도메인을 허용하거나 거부합니다. URL 스킴, 포트, 와일드카드 없이 도메인 이름만 사용하세요.
Key
application.network.enabled
Type / Values
boolean
Details
테이블이 있으면 기본값은 true입니다. true이면 데스크톱 앱의 외부 요청은 명시적으로 허용된 도메인에만 보낼 수 있습니다. 도메인 맵이 비어 있으면 외부 대상을 하나도 허용하지 않습니다. 앱 네트워크 정책이 없거나 값이 false이면 이 정책을 통한 대상 제한은 적용되지 않습니다.
Key
application.storage
Type / Values
table
Details
관리형 저장소를 지원하는 데스크톱 빌드에서 새로 만드는 작업의 저장 위치를 고정합니다. 각 경로는 해당 로컬 환경설정을 개별적으로 재정의합니다. 저장 위치 설정은 파일 시스템 액세스를 제한하지 않습니다.
Key
application.storage.default_project_parent
Type / Values
string (absolute path)
Details
처음부터 시작으로 새 로컬 프로젝트를 만들 때 사용할 상위 디렉터리입니다.
Key
application.storage.projectless_workspace_root
Type / Values
string (absolute path)
Details
프로젝트 없이 새로 만든 채팅의 루트 디렉터리입니다.
Key
apps
Type / Values
table
Details
앱 식별자를 키로 사용하는 관리형 앱 요구 사항입니다. 앱을 비활성화하거나 개별 도구의 승인 방식을 제한할 수 있습니다.
Key
apps.<id>.enabled
Type / Values
boolean
Details
false로 설정하면 앱을 비활성화합니다. 여러 요구 사항 소스를 병합해도 비활성화를 요구하는 제한은 유지됩니다.
Key
apps.<id>.tools.<tool>.approval_mode
Type / Values
auto | prompt | writes | approve
Details
개별 앱 도구의 관리형 승인 모드를 설정합니다.
Key
auto_review
Type / Values
table
Details
관리형 자동 검토 요구 사항입니다.
Key
auto_review.ignore_rules
Type / Values
array<string>
Details
Codex가 명령어 실행 정책의 allow 접두사 규칙을 무시할 모델의 전체 슬러그입니다. 제공자 네임스페이스가 있으면 이를 포함해 슬러그가 정확히 일치해야 합니다. required_on_models와 달리 네임스페이스를 뺀 별칭은 허용하지 않습니다. 거부 규칙과 네트워크 규칙은 계속 적용됩니다.
Key
auto_review.required_on_models
Type / Values
array<string>
Details
자동 검토를 반드시 사용해야 하는 모델의 슬러그입니다. 슬러그는 비어 있으면 안 되며 제공자 네임스페이스와 앞뒤 공백을 제외해야 합니다. 여러 요구 사항 소스의 목록은 합쳐집니다.
Key
browser_use
Type / Values
table
Details
에이전트가 브라우저를 조작할 때 적용할 관리형 요구 사항입니다.
Key
browser_use.allow_global_persistent_approval
Type / Values
boolean
Details
false로 설정하면 브라우저 기능이 모든 사이트에서의 다운로드 허용처럼 모든 사이트에 적용되는 Always allow 승인을 만들거나 적용하지 못합니다. 기존에 저장된 승인은 삭제하지 않고 무시합니다. true로 설정하거나 생략해도 승인이 생성되지는 않습니다.
Key
browser_use.allow_history_access
Type / Values
boolean
Details
false로 설정하면 브라우저 기능이 방문 기록을 읽지 못합니다. true로 설정하거나 생략하면 일반적인 방문 기록 설정 및 사용 가능 여부 검사가 적용됩니다.
Key
browser_use.allow_webmcp
Type / Values
boolean
Details
지원되는 관리형 플랜에서 워크스페이스 정책을 통해 사이트 도구(WebMCP)를 허용합니다. true로 설정하거나 값을 생략하면 이 정책을 통한 액세스가 허용됩니다. false로 설정하면 이 경로가 비활성화됩니다. 계정에 기능이 배포된 사용자는 여전히 액세스할 수 있습니다. 브라우저 설정과 사이트 권한이 적용됩니다.
Key
browser_use.default_origin_policy
Type / Values
table
Details
browser_use.origins 아래에서 일치하는 항목이 특정 브라우저 설정을 정의하지 않을 때 적용할 기본값입니다. 일치하는 출처 규칙이 있으면 해당 소스의 기본값을 대체합니다. 이후 Codex는 관리형 요구 사항과 사용자 설정 중 더 엄격한 결과를 적용합니다.
Key
browser_use.default_origin_policy.access
Type / Values
allow | deny
Details
deny를 사용하면 기본값이 적용되는 출처에서 브라우저 기능을 차단합니다. 해당 출처에서는 업로드, 다운로드, 브라우저 디버깅 전체 액세스 및 자동 검토도 차단됩니다. allow는 일반 승인 및 정책 검사를 계속 진행하도록 할 뿐입니다.
Key
browser_use.default_origin_policy.access_approval_lifetime
Type / Values
turn | thread
Details
영구 저장하지 않는 사이트 액세스 승인의 유효 기간을 정합니다. turn은 현재 턴으로 제한하고 thread는 현재 스레드가 끝날 때까지 유지합니다. persistent_approval은 Always allow 사용 가능 여부를 별도로 제어합니다. 제품 기본값은 thread입니다.
Key
browser_use.default_origin_policy.auto_review
Type / Values
allow | deny
Details
deny를 사용하면 기본값이 적용되는 출처에서 자동 검토를 건너뛰고 사용자에게 승인을 요청합니다. allow이면 다른 설정에서 허용할 때 자동 검토를 사용할 수 있습니다.
Key
browser_use.default_origin_policy.downloads
Type / Values
allow | deny
Details
deny를 사용하면 기본값이 적용되는 출처에서 브라우저 기능의 다운로드를 차단합니다. allow는 일반 승인 및 정책 검사를 계속 진행하도록 할 뿐입니다.
Key
browser_use.default_origin_policy.full_cdp_access
Type / Values
allow | deny
Details
deny를 사용하면 기본값이 적용되는 출처에서 Chrome DevTools Protocol(CDP) 전체 액세스를 차단합니다. allow는 일반적인 사용 동의 및 승인 검사를 계속 진행하도록 할 뿐입니다.
Key
browser_use.default_origin_policy.persistent_approval
Type / Values
boolean
Details
false로 설정하면 기본값이 적용되는 출처에서 브라우저 기능이 Always allow 승인을 저장하거나 적용하지 못합니다. 현재 턴 또는 스레드의 승인은 계속 적용될 수 있습니다. true이면 다른 조건이 허용할 때 Always allow를 선택할 수 있지만 승인이 생성되지는 않습니다.
Key
browser_use.default_origin_policy.uploads
Type / Values
allow | deny
Details
deny를 사용하면 기본값이 적용되는 출처에서 브라우저 기능의 업로드를 차단합니다. allow는 일반 승인 및 정책 검사를 계속 진행하도록 할 뿐입니다.
Key
browser_use.disable_auto_review
Type / Values
boolean
Details
true로 설정하면 브라우저 기능의 자동 검토를 건너뛰고 사용자에게 승인을 요청합니다. false로 설정하거나 생략하면 다른 설정에서 허용할 때 자동 검토를 사용할 수 있습니다.
Key
browser_use.extension
Type / Values
table
Details
지원되는 Chromium 브라우저 확장 프로그램에서 에이전트가 브라우저를 조작할 때 적용할 관리형 설정입니다.
Key
browser_use.extension.request_headers
Type / Values
array<table>
Details
지원되는 Chromium 확장 프로그램에서 에이전트가 제어하는 탭의 요청에 HTTP 헤더를 최대 16개 추가합니다. 관리형 헤더를 보내지 않으려면 빈 목록을 사용하세요.
Key
browser_use.extension.request_headers[].name
Type / Values
string
Details
헤더 이름입니다. Authorization, Cookie를 비롯한 예약된 이름은 사용할 수 없습니다. 이름과 값에서 사용할 수 있는 치환 변수는 {{session_id}}뿐입니다.
Key
browser_use.extension.request_headers[].value
Type / Values
string
Details
조건에 맞는 브라우저 요청에 포함할 헤더 값입니다.
Key
browser_use.origins
Type / Values
map<string, table>
Details
출처별 브라우저 정책입니다. 키는 <scheme>://<host-pattern>[:<port>] 형식이며 스킴은 http 또는 https입니다. 정확한 호스트를 지정하거나, 하위 도메인만 지정하려면 *.example.com, 기본 도메인과 하위 도메인을 지정하려면 **.example.com을 사용하세요. 그 밖의 * 와일드카드는 점을 포함한 문자열과 일치할 수 있으므로 region*.example.com은 region.api.example.com과도 일치합니다. 호스트가 *이면 해당 스킴의 모든 호스트와 일치합니다. 스킴과 기본값이 아닌 포트는 구분하며 명시한 기본 포트는 정규화할 때 제거합니다. 경로, 쿼리, 내장된 사용자 이름이나 비밀번호, 스킴 또는 포트의 와일드카드는 유효하지 않습니다. TOML에서는 [browser_use.origins."https://**.example.com"]처럼 패턴을 따옴표로 감싸세요.
Key
browser_use.origins.<pattern>
Type / Values
table
Details
이 패턴과 일치하는 출처에 적용할 정책입니다. 여러 패턴이 일치하면 Codex는 각 기능에 가장 제한적인 값을 사용합니다. deny가 allow보다, false가 true보다, turn이 thread보다 우선합니다.
Key
browser_use.origins.<pattern>.access
Type / Values
allow | deny
Details
deny를 사용하면 일치하는 출처에서 브라우저 기능을 차단합니다. 해당 출처에서는 업로드, 다운로드, 브라우저 디버깅 전체 액세스 및 자동 검토도 차단됩니다. allow는 일반 승인 및 정책 검사를 계속 진행하도록 할 뿐입니다.
Key
browser_use.origins.<pattern>.access_approval_lifetime
Type / Values
turn | thread
Details
일치하는 출처에서 영구 저장하지 않는 사이트 액세스 승인의 유효 기간을 정합니다. turn은 현재 턴으로 제한하고 thread는 현재 스레드가 끝날 때까지 유지합니다. persistent_approval은 Always allow 사용 가능 여부를 별도로 제어합니다.
Key
browser_use.origins.<pattern>.auto_review
Type / Values
allow | deny
Details
deny를 사용하면 일치하는 출처에서 자동 검토를 건너뛰고 사용자에게 승인을 요청합니다. allow이면 다른 설정에서 허용할 때 자동 검토를 사용할 수 있습니다.
Key
browser_use.origins.<pattern>.downloads
Type / Values
allow | deny
Details
deny를 사용하면 일치하는 출처에서 브라우저 기능의 다운로드를 차단합니다. allow는 일반 승인 및 정책 검사를 계속 진행하도록 할 뿐입니다.
Key
browser_use.origins.<pattern>.full_cdp_access
Type / Values
allow | deny
Details
deny를 사용하면 일치하는 출처에서 Chrome DevTools Protocol(CDP) 전체 액세스를 차단합니다. allow는 일반적인 사용 동의 및 승인 검사를 계속 진행하도록 할 뿐입니다.
Key
browser_use.origins.<pattern>.persistent_approval
Type / Values
boolean
Details
false로 설정하면 일치하는 출처에서 브라우저 기능이 Always allow 승인을 저장하거나 적용하지 못합니다. 현재 턴 또는 스레드의 승인은 계속 적용될 수 있습니다. true이면 다른 조건이 허용할 때 Always allow를 선택할 수 있지만 승인이 생성되지는 않습니다.
Key
browser_use.origins.<pattern>.uploads
Type / Values
allow | deny
Details
deny를 사용하면 일치하는 출처에서 브라우저 기능의 업로드를 차단합니다. allow는 일반 승인 및 정책 검사를 계속 진행하도록 할 뿐입니다.
Key
chatgpt_base_url
Type / Values
string
Details
인증 및 클라우드 정책 조회 전에 ChatGPT 서비스의 기본 URL을 강제합니다. 모든 Codex 네트워크 대상을 설정하는 것은 아닙니다. 로컬 시스템 요구 사항 파일 또는 macOS MDM에서 설정하세요. 클라우드 관리형 값은 무시됩니다.
Key
check_for_update_on_startup
Type / Values
boolean
Details
Codex가 시작할 때 업데이트를 확인할지 여부를 강제합니다.
Key
cli_auth_credentials_store
Type / Values
file | keyring | auto | ephemeral
Details
인증 정보를 로드하기 전에 CLI 자격 증명 저장소를 강제합니다. file은 CODEX_HOME/auth.json을 사용합니다. keyring에는 OS 자격 증명 저장소가 필요합니다. auto는 자격 증명 저장소를 사용할 수 없으면 파일을 사용합니다. ephemeral은 현재 프로세스의 메모리에 자격 증명을 보관합니다. 로컬 시스템 요구 사항 파일 또는 macOS MDM에서 설정하세요. 클라우드 관리형 값은 무시됩니다.
Key
computer_use
Type / Values
table
Details
에이전트가 네이티브 데스크톱 앱에서 작업할 때 적용할 관리형 요구 사항입니다. 관리형 앱 규칙과 config.toml의 앱 규칙을 모두 시행하므로 각 정책 소스에서 앱을 허용해야 합니다.
Key
computer_use.allow_locked_computer_use
Type / Values
boolean
Details
false로 설정하면 관리 대상 macOS 기기에서 사용자가 잠금 상태 사용을 활성화할 수 없습니다. 활성화 설정만 제거하므로 이미 켜져 있는 잠금 상태 사용은 꺼지지 않습니다. 생략하면 일반적인 제품 제공 조건이 적용됩니다.
Key
computer_use.allow_persistent_approval
Type / Values
boolean
Details
false로 설정하면 앱 승인을 저장하여 다른 세션에서도 사용하는 옵션이 사라집니다. 현재 세션의 승인은 계속 사용할 수 있습니다. true로 설정하거나 생략해도 앱이 승인되지는 않습니다.
Key
computer_use.default_app_access
Type / Values
allow | deny
Details
플랫폼별 규칙과 일치하지 않는 네이티브 앱에 적용할 기본 액세스 정책입니다. deny는 액세스를 차단합니다. allow는 일반 승인 및 정책 검사를 계속 진행하도록 할 뿐입니다. 제품 기본값은 allow입니다.
Key
computer_use.macos
Type / Values
table
Details
macOS에서 컴퓨터 사용에 적용할 앱 규칙입니다.
Key
computer_use.macos.bundle_ids
Type / Values
map<string, allow | deny>
Details
정확한 macOS 번들 식별자를 allow 또는 deny에 매핑합니다. 일치하는 규칙이 있으면 같은 정책 소스의 computer_use.default_app_access를 대체합니다. 관리형 요구 사항과 사용자 설정 중 어느 한쪽이라도 거부하면 액세스가 차단됩니다.
Key
computer_use.macos.bundle_ids.<bundle-id>
Type / Values
allow | deny
Details
deny를 사용하면 정확히 일치하는 번들 식별자를 차단합니다. allow는 이 정책 소스의 기본값만 재정의합니다. 다른 정책 소스와 일반 승인 플로우에서도 앱을 허용해야 합니다.
Key
computer_use.windows
Type / Values
table
Details
패키징된 Windows 앱과 패키징되지 않은 Windows 앱에 적용할 컴퓨터 사용 규칙입니다.
Key
computer_use.windows.aumids
Type / Values
map<string, allow | deny>
Details
서명된 패키지 앱의 등록된 애플리케이션 사용자 모델 ID(AUMID)를 정확히 지정하여 allow 또는 deny에 매핑합니다. 일치하는 규칙은 같은 정책 소스의 computer_use.default_app_access를 대체합니다.
Key
computer_use.windows.aumids.<aumid>
Type / Values
allow | deny
Details
deny를 사용하면 정확히 일치하는 패키지 앱 ID를 차단합니다. allow는 이 정책 소스의 기본값만 재정의합니다. 다른 정책 소스와 일반 승인 플로우에서도 앱을 허용해야 합니다.
Key
computer_use.windows.exes
Type / Values
array<table>
Details
서명되었지만 패키징되지 않은 Windows 실행 파일의 규칙입니다. 규칙은 실행 파일의 경로나 현재 파일 이름 대신 검증된 게시자와 서명된 버전 정보를 대조합니다. 거부 및 허용 규칙이 모두 일치하면 거부가 우선합니다. 서명되지 않은 실행 파일에는 computer_use.default_app_access를 적용합니다. 서명된 실행 파일의 신원을 명확히 검증할 수 없으면 차단합니다.
Key
computer_use.windows.exes[].access
Type / Values
allow | deny
Details
일치하는 실행 파일에 적용할 필수 액세스 결정입니다. deny는 액세스를 차단합니다. allow는 이 정책 소스의 기본값만 재정의합니다. 다른 정책 소스와 일반 승인 플로우에서도 앱을 허용해야 합니다.
Key
computer_use.windows.exes[].binary_name
Type / Values
string
Details
실행 파일의 서명된 버전 정보에 있는 OriginalFilename입니다(선택 사항). 대소문자를 구분하지 않습니다. 게시자 및 제품이 일치하는 규칙에서 이 값을 요구하지만 실행 파일이 제공하지 않으면 컴퓨터 사용 기능이 실행 파일을 차단합니다.
Key
computer_use.windows.exes[].product_name
Type / Values
string
Details
실행 파일의 서명된 버전 정보에 있는 정확한 ProductName입니다. 필수 항목입니다.
Key
computer_use.windows.exes[].publisher_name
Type / Values
string
Details
실행 파일의 신뢰할 수 있는 서명 인증서에 기재된 정확한 게시자 이름입니다. Windows X.500 고유 이름 형식으로 지정해야 하는 필수 항목입니다.
Key
config_server
Type / Values
table
Details
Codex를 설정 서버에 등록합니다. 로컬 관리자가 제어하는 요구 사항에서 설정하세요.
Key
config_server
Type / Values
table
Details
로컬 관리형 요구 사항을 통해 Codex를 설정 서버에 등록합니다. Codex는 이 서버에서 정책 번들을 가져옵니다. 클라우드 정책은 자체 설정 서버를 지정할 수 없습니다.
Key
config_server.base_url
Type / Values
string (HTTPS URL)
Details
관리자가 등록한 설정 서버의 기본 URL입니다. Codex는 이 URL 뒤에 /codex/config/bundle을 붙입니다.
Key
config_server.base_url
Type / Values
string
Details
필수 HTTPS 기본 URL입니다. Codex가 뒤에 /codex/config/bundle을 붙입니다. 기본 URL에 자격 증명, 쿼리 매개변수, 프래그먼트를 포함하지 마세요.
Key
config_server.oauth
Type / Values
table
Details
회사 계정 로그인 설정입니다(선택 사항). 자격 증명 없이 번들을 가져오려면 이 테이블을 생략하세요.
Key
config_server.oauth
Type / Values
table
Details
설정 서버 로그인용 OAuth 설정입니다. authorization_url, token_url 및 비어 있지 않은 client_id가 필요합니다. 선택 필드는 device_authorization_url, resource, scopes(기본값은 빈 목록), redirect_port(0 이외의 값)입니다. 모든 엔드포인트 URL은 HTTPS를 사용해야 합니다.
Key
config_server.oauth.authorization_url
Type / Values
string (HTTPS URL)
Details
브라우저에서 회사 계정으로 로그인할 때 사용할 인가 엔드포인트입니다. OAuth를 설정하면 필수입니다.
Key
config_server.oauth.client_id
Type / Values
string
Details
Codex용으로 등록한 공개 OAuth 클라이언트 ID입니다. OAuth를 설정하면 필수입니다.
Key
config_server.oauth.redirect_port
Type / Values
number
Details
127.0.0.1에서 브라우저 콜백을 받을 포트입니다(선택 사항). 기본적으로 Codex가 사용 가능한 포트를 선택합니다.
Key
config_server.oauth.resource
Type / Values
string
Details
ID 제공자가 요구하는 OAuth 리소스 식별자입니다(선택 사항).
Key
config_server.oauth.scopes
Type / Values
array<string>
Details
ID 제공자에게 요청할 OAuth 권한입니다(선택 사항).
Key
config_server.oauth.token_url
Type / Values
string (HTTPS URL)
Details
회사 계정 로그인 및 토큰 갱신에 사용할 토큰 엔드포인트입니다. OAuth를 설정하면 필수입니다.
Key
default_permissions
Type / Values
string
Details
관리형 기본 권한 프로필입니다. allowed_permission_profiles에서 허용한 프로필이어야 합니다. 동작을 예측할 수 있도록 명시적으로 설정하세요. 생략하면 :workspace를 기본값으로 사용하는 경우는 :workspace와 :read-only가 모두 명시적으로 허용되었을 때뿐입니다.
Key
enforce_residency
Type / Values
string
Details
Codex 서비스 트래픽에 지원되는 데이터 레지던시를 적용하도록 강제합니다. 현재 허용되는 값은 us입니다.
Key
features
Type / Values
table
Details
고정할 기능 값입니다. 런타임 기능에는 config.toml의 정식 이름을 사용하세요. 문서에 명시된 앱 전용 요구 사항 키도 지원합니다.
Key
features.<name>
Type / Values
boolean
Details
문서에 명시된 런타임 또는 앱 기능이 활성화 또는 비활성화 상태를 유지하도록 강제합니다.
Key
features.api_key_cyber_access_programs
Type / Values
boolean
Details
API 키로 인증할 때 Codex가 기본 제공 OpenAI 제공자에게 보내는 요청에 명시적으로 선택한 사이버 액세스 프로그램을 포함하도록 허용합니다. 계정과 모델 모두 이미 해당 프로그램에 액세스할 수 있어야 합니다.
Key
features.apps
Type / Values
boolean
Details
관리 대상 사용자의 앱 통합 사용 여부를 고정합니다.
Key
features.browser_annotation_api
Type / Values
boolean
Details
false로 설정하면 내장 브라우저에서 웹사이트가 주석 기능을 맞춤 설정하지 못합니다. 사용자는 계속 페이지에 직접 주석을 달 수 있습니다. 앱과 계정에서 지원하는 경우 웹사이트의 맞춤 설정을 허용하려면 true로 설정하세요.
Key
features.browser_use
Type / Values
boolean
Details
false를 requirements.toml에 설정하면 에이전트가 브라우저를 조작하는 기능을 비활성화합니다.
Key
features.browser_use_external
Type / Values
boolean
Details
false를 requirements.toml에 설정하면 Codex가 ChatGPT 브라우저 확장 프로그램을 통해 지원되는 브라우저를 조작하지 못합니다. 기존 탭과 로그인된 세션에도 적용됩니다.
Key
features.browser_use_full_cdp_access
Type / Values
boolean
Details
false를 requirements.toml에 설정하면 브라우저 개발자 모드를 포함해 로컬 런타임의 Chrome DevTools Protocol 전체 액세스를 비활성화하고 ChatGPT 데스크톱 앱에서 해당 설정을 켜지 못하게 합니다. 생략하면 일반적인 제품 제공 조건이 적용됩니다.
Key
features.computer_use
Type / Values
boolean
Details
false를 requirements.toml에 설정하면 컴퓨터 사용, 녹화 및 재생, 관련 설치 또는 활성화 플로우를 비활성화합니다.
Key
features.fast_mode
Type / Values
boolean
Details
관리 대상 사용자의 패스트 모드 사용을 허용하거나 차단합니다. 이전 버전의 앱 서버는 이 설정으로 울트라패스트 모드도 제어합니다.
Key
features.guardian_approval
Type / Values
boolean
Details
관리 대상 사용자의 Guardian 승인 사용 여부를 고정합니다.
Key
features.in_app_browser
Type / Values
boolean
Details
false를 requirements.toml에 설정하면 사용자가 직접 열고 조작하는 내장 브라우저 창을 비활성화합니다.
Key
features.in_app_chat
Type / Values
boolean
Details
false로 설정하면 ChatGPT 데스크톱 앱에서 ChatGPT 및 ChatGPT Work 대화 화면과 관련 클라우드 자동화 UI를 숨깁니다. ChatGPT 보이스를 차단하거나 기존 클라우드 작업을 중지하지는 않습니다. true로 설정해도 계정, 워크스페이스 권한 또는 롤아웃 검사를 우회하지 않습니다.
Key
features.in_app_dictation
Type / Values
boolean
Details
false로 설정하면 데스크톱 앱의 받아쓰기를 비활성화합니다. true로 설정해도 다른 사용 가능 여부 검사를 우회하지 않습니다.
Key
features.in_app_local_automation
Type / Values
boolean
Details
false로 설정하면 데스크톱 앱의 로컬 예약 작업을 비활성화합니다. true로 설정해도 다른 사용 가능 여부 검사를 우회하지 않습니다.
Key
features.in_app_updates
Type / Values
boolean
Details
false를 requirements.toml에 설정하면 앱 내 업데이트를 비활성화합니다. 생략하면 기본적으로 업데이트가 활성화됩니다.
Key
features.in_app_voice
Type / Values
boolean
Details
false로 설정하면 데스크톱 앱에서 Codex 실시간 음성 기능을 비활성화합니다. 받아쓰기는 features.in_app_dictation으로 별도 관리하세요.
Key
features.memories
Type / Values
boolean
Details
관리 대상 사용자의 메모리 사용 여부를 고정합니다.
Key
features.multi_agent
Type / Values
boolean
Details
관리 대상 사용자의 멀티 에이전트 사용 여부를 고정합니다.
Key
features.plugin_sharing
Type / Values
boolean
Details
false를 클라우드 관리형 requirements.toml에 설정하면 로컬에서 빌드한 플러그인의 워크스페이스 공유를 비활성화합니다.
Key
features.plugins
Type / Values
boolean
Details
관리 대상 사용자의 플러그인 사용 여부를 고정합니다.
Key
features.realtime_conversation
Type / Values
boolean
Details
false로 설정하면 Codex CLI의 실험적 /voice 명령어를 비활성화합니다. 데스크톱 앱의 ChatGPT 보이스 또는 앱 서버의 음성 세션을 차단하는 용도로 이 설정에 의존하지 마세요. true로 설정해도 클라이언트 또는 롤아웃 검사를 우회하지 않습니다.
Key
features.remote_plugin
Type / Values
boolean
Details
관리 대상 사용자의 원격 플러그인 카탈로그 사용 여부를 고정합니다.
Key
features.standalone_web_search
Type / Values
boolean
Details
실험적 기능입니다. true로 설정하면 MCP를 통한 호스팅 검색을 사용할 수 있는 경우에도 데스크톱 앱의 네이티브 웹 검색 설정을 유지합니다.
Key
features.ultrafast_mode
Type / Values
boolean
Details
관리 대상 사용자의 울트라패스트 모드 사용을 허용하거나 차단합니다. 속도를 각각 설정할 수 있는 앱 서버에서는 패스트 모드가 꺼져 있어도 이 설정이 적용됩니다. 사용 가능 여부는 모델과 계정에 따라 다릅니다.
Key
features.workspace_dependencies
Type / Values
boolean
Details
관리 대상 사용자의 번들 워크스페이스 종속성 런타임 사용 여부를 고정합니다.
Key
feedback
Type / Values
table
Details
관리형 피드백 설정입니다.
Key
feedback.enabled
Type / Values
boolean
Details
모든 Codex 클라이언트에서 사용자의 피드백 제출 허용 여부를 강제합니다.
Key
guardian_policy_config
Type / Values
string
Details
기본 자동 검토 정책을 대체하는 관리형 Markdown 텍스트입니다. 로컬 [auto_review].policy보다 우선합니다. 빈 값은 무시됩니다.
Key
hooks
Type / Values
table
Details
관리자가 강제하는 관리형 수명 주기 훅입니다. 관리형 훅 디렉터리가 필요하며 인라인 [hooks]를 config.toml에 정의할 때와 같은 이벤트 스키마를 사용합니다.
Key
hooks.<Event>
Type / Values
array<table>
Details
PreModelRequest, PostModelRequest, PreToolUse, PermissionRequest, PostToolUse, PreCompact, PostCompact, SessionStart, SessionEnd, SubagentStart, SubagentStop, UserPromptSubmit, Stop 등의 훅 이벤트에 대한 매처 그룹입니다.
Key
hooks.<Event>[].hooks
Type / Values
array<table>
Details
매처 그룹의 훅 핸들러입니다. 명령어 훅과 MCP 도구 훅을 지원합니다. 프롬프트 및 에이전트 훅 핸들러는 파싱하지만 실행하지 않습니다.
Key
hooks.<Event>[].hooks[].additionalContextLimit
Type / Values
integer
Details
큰 additionalContext를 디스크에 저장하고 모델에는 짧은 미리보기를 제공할 때 기준으로 삼는 핸들러별 대략적인 토큰 수입니다. 기본값은 2500이며 0이면 전체 컨텍스트를 모델에 직접 전달합니다. 대용량 훅 출력을 참고하세요.
Key
hooks.<Event>[].hooks[].async
Type / Values
boolean
Details
훅을 호출한 작업을 지연시키지 않고 명령어 훅을 백그라운드에서 실행합니다. 기본값은 false입니다. SessionEnd는 항상 동기적으로 실행됩니다. 백그라운드에서 훅 실행하기를 참고하세요.
Key
hooks.<Event>[].hooks[].commandWindows
Type / Values
string
Details
Windows에서만 명령어 훅의 명령어를 재정의합니다. TOML 별칭 command_windows도 사용할 수 있습니다.
Key
hooks.managed_dir
Type / Values
string (absolute path)
Details
macOS 및 Linux에서 관리형 훅 스크립트를 보관하는 디렉터리입니다. Codex는 관리형 훅을 로드하기 전에 경로가 절대 경로이며 실제로 존재하는지 확인합니다.
Key
hooks.windows_managed_dir
Type / Values
string (absolute path)
Details
Windows에서 관리형 훅 스크립트를 보관하는 디렉터리입니다. Codex는 관리형 훅을 로드하기 전에 경로가 절대 경로이며 실제로 존재하는지 확인합니다.
Key
in_app_browser
Type / Values
table
Details
내장 브라우저 창에 적용할 요구 사항입니다. 에이전트가 브라우저를 조작하는 기능은 제어하지 않습니다.
Key
in_app_browser.allow_external_browser_settings_import
Type / Values
boolean
Details
false로 설정하면 사용자가 외부 브라우저의 설정이나 탐색 데이터를 내장 브라우저로 가져올 수 없습니다. true로 설정하거나 생략하면 다른 제품 검사에서 허용하는 경우 가져올 수 있습니다. 관리형 전용 설정으로 config.toml에서 재정의할 수 없습니다.
Key
log_dir
Type / Values
string (path)
Details
Codex가 로컬 로그 파일을 쓸 디렉터리를 강제합니다.
Key
marketplaces
Type / Values
table
Details
플러그인 마켓플레이스 소스에 대한 관리자 요구 사항입니다. restrict_to_allowed_sources가 true일 때 규칙이 적용됩니다.
Key
marketplaces.allowed_sources
Type / Values
table
Details
관리자가 선택한 규칙 이름을 키로 사용하는 마켓플레이스 소스 허용 목록입니다. 서로 다른 이름의 규칙은 요구 사항 레이어 전반에 걸쳐 누적되며, 같은 이름 아래의 필드에는 일반적인 레이어 우선순위가 적용됩니다.
Key
marketplaces.allowed_sources.<name>
Type / Values
table
Details
개별 소스 허용 규칙입니다. 요구 사항을 병합한 후의 최종 source 값에 따라 Codex가 같은 수준의 필드 중 어떤 필드를 해석할지 결정합니다.
Key
marketplaces.allowed_sources.<name>.host_pattern
Type / Values
string
Details
source = "host_pattern"일 때 필요한 정규식입니다. Codex는 HTTPS, SSH 또는 SCP 형식의 Git 소스에서 추출한 소문자 호스트 이름과 이 정규식을 대조합니다. 호스트 이름 전체가 일치해야 한다면 ^와 $를 사용하세요.
Key
marketplaces.allowed_sources.<name>.path
Type / Values
string (absolute path)
Details
source = "local"일 때 필요한 로컬 마켓플레이스 디렉터리입니다. Codex는 절대 경로를 요구하며 경로를 정규화한 후 비교합니다.
Key
marketplaces.allowed_sources.<name>.ref
Type / Values
string
Details
git 규칙에서 정확히 일치해야 하는 Git ref입니다(선택 사항). 생략하면 일치하는 리포지터리의 모든 ref를 허용합니다.
Key
marketplaces.allowed_sources.<name>.source
Type / Values
git | host_pattern | local
Details
마켓플레이스 소스 매처 유형입니다. 단일 리포지터리에는 git, 정규식과 일치하는 Git 호스트에는 host_pattern, 단일 디렉터리에는 local을 사용하세요.
Key
marketplaces.allowed_sources.<name>.url
Type / Values
string
Details
source = "git"일 때 필요한 Git 리포지터리 URL입니다. Codex는 설정된 URL과 허용된 URL을 정규화한 후 리포지터리가 정확히 일치하는지 확인합니다.
Key
marketplaces.restrict_to_allowed_sources
Type / Values
boolean
Details
true이면 마켓플레이스 추가, 플러그인 설치, 새로 고침 및 런타임 로드 시 설정된 마켓플레이스 소스가 allowed_sources와 일치해야 합니다. API 키 카탈로그를 비롯해 OpenAI가 선별한 Git 카탈로그도 허용 목록과 일치해야 합니다. 번들 또는 원격 설치된 워크스페이스 플러그인은 이 선별된 Git 소스 정책과 별개입니다.
Key
mcp_servers
Type / Values
table
Details
활성화할 수 있는 MCP 서버의 허용 목록입니다. MCP 서버를 활성화하려면 서버 이름(<id>)과 식별 정보가 모두 일치해야 합니다. 설정된 MCP 서버가 목록에 없거나 식별 정보가 일치하지 않으면 비활성화됩니다.
Key
mcp_servers.<id>.identity
Type / Values
table
Details
개별 MCP 서버의 식별 규칙입니다. command(stdio) 또는 url(스트리밍 가능한 HTTP) 중 하나를 설정하세요.
Key
mcp_servers.<id>.identity.command
Type / Values
string | table
Details
정확한 명령어 문자열로 MCP stdio 서버를 허용하거나 매처 테이블로 실행 파일의 정확한 일치와 순서에 따른 인수 일치를 요구합니다. 문자열 형식은 인수, cwd, env, env_vars를 검사하지 않습니다.
Key
mcp_servers.<id>.identity.command.args
Type / Values
array<table>
Details
stdio 서버의 인수를 순서대로 대조할 매처입니다. 설정된 인수 목록의 길이가 같고 모든 위치에서 일치해야 합니다. 명령어 매처는 cwd, env, env_vars를 검사하지 않습니다.
Key
mcp_servers.<id>.identity.command.args[].expression
Type / Values
string
Details
regex 인수 매처에서 사용할 정규식입니다. 유효한 정규식이어야 하며 인수 값 전체와 일치해야 합니다.
Key
mcp_servers.<id>.identity.command.args[].match
Type / Values
exact | prefix | regex
Details
이 위치의 인수를 대조할 방식입니다.
Key
mcp_servers.<id>.identity.command.args[].value
Type / Values
string
Details
exact 또는 prefix 인수 매처에서 사용할 값입니다.
Key
mcp_servers.<id>.identity.command.executable
Type / Values
string
Details
stdio 서버에 설정된 command가 정확히 일치해야 하는 실행 파일입니다.
Key
mcp_servers.<id>.identity.url
Type / Values
string | table
Details
정확한 URL 문자열로 스트리밍 가능한 HTTP MCP 서버를 허용하거나 exact, prefix, regex 값 매처 테이블을 사용합니다.
Key
mcp_servers.<id>.identity.url.expression
Type / Values
string
Details
regex URL 매처에서 사용할 정규식입니다. 유효한 정규식이어야 하며 URL 값 전체와 일치해야 합니다.
Key
mcp_servers.<id>.identity.url.match
Type / Values
exact | prefix | regex
Details
설정된 MCP 서버 URL을 대조할 방식입니다.
Key
mcp_servers.<id>.identity.url.value
Type / Values
string
Details
exact 또는 prefix URL 매처에서 사용할 값입니다.
Key
model_catalog_json
Type / Values
string (path)
Details
Codex가 시작 시 사용할 JSON 모델 카탈로그를 강제합니다.
Key
model_provider
Type / Values
string
Details
모델 제공자 ID를 강제하여 로컬 및 세션 설정을 재정의합니다.
Key
model_providers
Type / Values
map<string, table>
Details
관리형 모델 제공자 정의입니다. 각 항목은 ID가 같은 기존 제공자 정의 전체를 대체합니다. 사용자 정의와 필드별로 병합하지 않습니다. ID가 다른 제공자는 계속 사용할 수 있습니다.
Key
model_providers.<id>
Type / Values
table
Details
관리형 제공자의 전체 정의입니다. config.toml과 같은 제공자 필드를 사용하며 여기에는 name, base_url, 인증 및 전송 설정이 포함됩니다.
Key
models
Type / Values
table
Details
[models.new_thread] 테이블을 포함합니다.
Key
models.new_thread
Type / Values
table
Details
새 로컬 스레드를 시작할 때 적용할 선택적 기본값입니다. 사용자 및 프로젝트 기본값보다 우선하지만 명시적으로 재정의할 수 있습니다.
Key
models.new_thread.model
Type / Values
string
Details
새 스레드의 기본 모델입니다. 모델이나 추론 수준 중 하나라도 명시적으로 재정의하면 두 필드 모두 무시됩니다.
Key
models.new_thread.model_reasoning_effort
Type / Values
string
Details
새 스레드의 기본 추론 수준입니다. 모델이나 추론 수준 중 하나라도 명시적으로 재정의하면 두 필드 모두 무시됩니다.
Key
models.new_thread.service_tier
Type / Values
string
Details
새 스레드의 기본 서비스 등급입니다. 서비스 등급을 명시적으로 재정의하면 이 필드는 무시됩니다.
Key
network_proxy
Type / Values
table
Details
샌드박스에서 실행되는 로컬 명령어에 적용할 관리자 네트워크 요구 사항입니다. Codex 0.166.0은 [network_proxy]와 그 별칭인 [experimental_network]를 지원합니다. 요구 사항 레이어마다 둘 중 한 이름만 사용하세요. 모든 클라이언트와 정책 검증기가 새 이름을 지원할 때까지 게시된 정책에는 별칭을 유지하세요. 활성화하면 features.network_proxy 없이도 명령어용 네트워크 프록시를 시작할 수 있습니다. 브라우저 도구는 관리형 네트워크 거부 규칙과 허용 목록 전용 제한을 별도로 확인합니다. 이 요구 사항은 브라우저 트래픽을 프록시로 라우팅하지 않으며 웹 검색, 앱, MCP 서버, 네이티브 앱 트래픽 및 기타 기능별 트래픽을 제어하지 않습니다. 지원되는 관리형 Codex Cloud 경로에서는 별도의 클라우드 환경 인터넷 설정과 함께 명령어의 네트워크 통신을 제한합니다. 정책이 허용하면 승인된 샌드박스 전체 권한 상승으로 명령어 프록시를 우회할 수 있습니다. Work 클라우드는 이 요구 사항을 상속하지 않습니다.
Key
network_proxy.allow_local_binding
Type / Values
boolean
Details
샌드박스 네트워크 통신에서 로컬 또는 사설 네트워크에 더 폭넓은 액세스를 허용합니다. 지원되는 Codex Cloud 프록시 경로에서는 false를 명시하면 도메인이 허용되어도 업스트림 프록시 액세스가 차단될 수 있습니다. 적용 가능한 요구 사항, 선택한 네트워크 프로필 및 프록시 기능 설정 어디에도 값이 없을 때만 기본값이 true입니다. 상속된 false도 명시적인 값으로 취급합니다. 지원되는 상위 우선순위 클라우드 재정의로 이 값을 변경할 수 있으며, 이때 로컬에 적용되는 전역 정책 범위를 넓히거나 도메인 허용 항목을 추가할 필요가 없습니다. 실행기의 지원 여부를 확인하세요. 이 클라우드 기본값을 로컬에 적용하지 마세요.
Key
network_proxy.allow_upstream_proxy
Type / Values
boolean
Details
샌드박스 네트워크 통신이 환경에서 제공하는 업스트림 프록시를 경유하도록 허용합니다.
Key
network_proxy.allowed_domains
Type / Values
array<string>
Details
관리형 네트워크 프록시가 활성화되어 있을 때 샌드박스 명령어의 네트워크 통신에 적용할 관리자 허용 규칙입니다. 웹 검색, 앱 또는 MCP 서버에는 적용되지 않습니다. network_proxy.domains와 함께 사용하지 마세요.
Key
network_proxy.dangerously_allow_all_unix_sockets
Type / Values
boolean
Details
허용 목록에 있는 소켓 외에 임의의 Unix 소켓 대상에도 액세스를 허용합니다. 엄격하게 통제되는 환경에서만 사용하세요.
Key
network_proxy.dangerously_allow_non_loopback_proxy
Type / Values
boolean
Details
[network_proxy] 요구 사항에 비루프백 리스너 주소를 허용합니다. 활성화하면 리스너가 로컬호스트 외부에 노출될 수 있습니다.
Key
network_proxy.denied_domains
Type / Values
array<string>
Details
샌드박스 네트워크 통신에 적용할 목록 형식의 관리자 거부 규칙입니다. network_proxy.domains와 함께 사용하지 마세요.
Key
network_proxy.domains
Type / Values
map<string, allow | deny>
Details
샌드박스 네트워크 통신에 적용할 맵 형식의 관리자 도메인 정책입니다. 정확한 호스트, 하위 도메인만 지정하는 *.example.com, 기본 도메인과 하위 도메인을 지정하는 **.example.com, 전역 * 허용 규칙을 지원합니다. *는 공용 네트워크로의 아웃바운드 액세스를 광범위하게 허용하므로 범위가 제한된 규칙을 권장합니다. 한 정책 안에서는 환경 규칙이 동일한 전역 도메인 키의 값을 대체할 수 있습니다. 우선순위가 높은 값은 같은 키의 값만 대체하고 상속된 다른 키는 유지됩니다. 병합 후에도 상속된 와일드카드를 비롯해 요청과 일치하는 다른 deny 규칙이 있으면 요청이 차단됩니다. 빈 환경 맵은 전역 규칙을 지우지 않습니다. 실행기의 지원 여부를 확인하세요. network_proxy.allowed_domains 또는 network_proxy.denied_domains와 함께 사용하지 마세요.
Key
network_proxy.domains.<pattern>
Type / Values
allow | deny
Details
도메인 패턴과 일치하는 대상에 대한 샌드박스 네트워크 액세스를 허용하거나 거부합니다. 여러 패턴이 일치하면 거부 규칙이 우선합니다.
Key
network_proxy.enabled
Type / Values
boolean
Details
샌드박스 네트워크 요구 사항을 활성화합니다. 현재 샌드박스에서 명령어의 네트워크 통신이 꺼져 있으면 이 설정이 네트워크 액세스를 부여하지 않습니다.
Key
network_proxy.http_port
Type / Values
integer
Details
[network_proxy] 요구 사항에 사용할 루프백 HTTP 리스너 포트입니다.
Key
network_proxy.managed_allowed_domains_only
Type / Values
boolean
Details
네트워크 요구 사항이 활성화되고 이 값이 true이면 일반 사용자 설정과 도메인별 승인으로 관리형 프록시 허용 목록을 확장할 수 없습니다. 설정하거나 상속한 허용 항목 중 실제 적용되는 항목이 없으면 일반 관리형 명령어에 허용되는 대상도 없습니다. 거부 규칙만 있는 정책이 나머지 인터넷을 허용하지는 않습니다. 이 제한은 모든 도구나 승인된 샌드박스 전체 권한 상승에 적용되지는 않습니다.
Key
network_proxy.review_domains
Type / Values
array<string>
Details
일치하는 호스트에 대한 요청은 허용 규칙과 일치해도 네트워크 승인을 거치도록 합니다. 명시적인 거부 규칙이 우선합니다. 승인된 요청도 DNS 검사와 사설 주소 검사를 거칩니다. 기본값은 빈 목록입니다.
Key
network_proxy.socks_port
Type / Values
integer
Details
[network_proxy] 요구 사항에 사용할 루프백 SOCKS5 리스너 포트입니다.
Key
network_proxy.unix_sockets
Type / Values
map<string, allow | deny>
Details
macOS의 샌드박스 네트워크 통신에 적용할 관리형 Unix 소켓 허용 목록입니다. 절대 경로를 사용해야 합니다.
Key
network_proxy.unix_sockets.<path>
Type / Values
allow | deny
Details
macOS에서 allow는 Unix 소켓 절대 경로를 허용 목록에 추가하고 deny는 제외합니다. 모든 Unix 소켓 허용이 활성화되어 있으면 deny 항목으로 소켓을 차단할 수 없습니다.
Key
otel
Type / Values
table
Details
지정한 OpenTelemetry 설정을 강제합니다. 각 내보내기 도구 설정은 기존의 해당 도구 정의 전체를 대체합니다. 스팬 속성과 tracestate 필드는 일치하는 항목만 재정의합니다.
Key
otel.environment
Type / Values
string
Details
텔레메트리에 적용할 환경 레이블을 강제합니다.
Key
otel.exporter
Type / Values
none | otlp-http | otlp-grpc
Details
엔드포인트, 헤더, TLS 설정을 포함해 로그 내보내기 도구를 강제합니다.
Key
otel.log_agent_responses
Type / Values
boolean
Details
기본 에이전트와 생성된 하위 에이전트의 최종 응답 텍스트를 OTLP 로그에 포함할지 정합니다.
Key
otel.log_guardian_assessments
Type / Values
boolean
Details
완료된 자동 승인 검토의 결과와 판단 근거를 OTLP 로그에 포함할지 정합니다.
Key
otel.log_user_prompt
Type / Values
boolean
Details
내보내는 로그에 사용자 프롬프트 텍스트를 포함할지 정합니다.
Key
otel.metrics_exporter
Type / Values
none | statsig | otlp-http | otlp-grpc
Details
메트릭 내보내기 도구를 강제합니다. Statsig 내보내기 도구는 analytics.enabled 설정을 따릅니다. 명시적으로 설정한 OTLP 메트릭 내보내기 도구는 이 설정과 독립적으로 작동합니다.
Key
otel.span_attributes
Type / Values
map<string,string>
Details
내보내는 스팬의 문자열 속성을 개별적으로 강제합니다. 같은 속성에는 우선순위가 높은 요구 사항이 적용됩니다.
Key
otel.tool_result
Type / Values
table
Details
도구 결과 로그 설정을 하나의 단위로 강제합니다. 빈 테이블은 기본 바이트 한도를 강제합니다.
Key
otel.tool_result.max_bytes
Type / Values
integer (nonnegative)
Details
로그의 잘림 안내 앞에 기록할 도구 결과 텍스트의 최대 UTF-8 바이트 수입니다. 관리형 테이블이 있으면 기본값은 2048입니다.
Key
otel.trace_exporter
Type / Values
none | otlp-http | otlp-grpc
Details
엔드포인트, 헤더, TLS 설정을 포함해 트레이스 내보내기 도구를 강제합니다.
Key
otel.tracestate
Type / Values
map<string,map<string,string>>
Details
W3C tracestate 멤버 내의 필드를 개별적으로 강제합니다. 멤버와 필드가 모두 같으면 우선순위가 높은 요구 사항이 적용됩니다.
Key
permissions
Type / Values
table
Details
프로필 이름을 키로 사용하여 관리자가 정의한 권한 프로필입니다. config.toml과 같은 프로필 필드를 사용합니다.
Key
permissions.<name>
Type / Values
table
Details
관리자가 정의한 권한 프로필입니다. 이름은 :로 시작할 수 없고 예약어 filesystem 또는 로드된 설정의 기존 프로필 이름과 같을 수 없습니다. config.toml과 같은 프로필 필드를 사용합니다. 전체 프로필 스키마는 권한 가이드를 참고하세요.
Key
permissions.filesystem.deny_read
Type / Values
array<string>
Details
관리자가 강제하는 파일 시스템 읽기 거부 규칙입니다. 항목에 경로나 glob 패턴을 사용할 수 있으며 사용자는 로컬 설정으로 이를 완화할 수 없습니다.
Key
plugins
Type / Values
table
Details
플러그인 식별자를 키로 사용하는 플러그인별 MCP 서버 허용 목록입니다. 이 테이블이 있으면 일치하는 플러그인 및 서버 항목이 없는 번들 서버는 비활성화됩니다.
Key
plugins.<plugin>.mcp_servers
Type / Values
table
Details
한 플러그인에 포함된 MCP 서버의 허용 목록입니다. 플러그인 서버 요구 사항은 최상위 mcp_servers 요구 사항과 같은 정확한 식별 정보 및 매처 형식을 사용합니다.
Key
plugins.<plugin>.mcp_servers.<server>.identity
Type / Values
table
Details
플러그인에 포함된 개별 MCP 서버의 식별 규칙입니다. command(stdio) 또는 url(스트리밍 가능한 HTTP) 중 하나를 설정하세요.
Key
plugins.<plugin>.mcp_servers.<server>.identity.command
Type / Values
string | table
Details
정확한 명령어 문자열로 플러그인의 stdio MCP 서버를 허용하거나 매처 테이블로 실행 파일의 정확한 일치와 순서에 따른 인수 일치를 요구합니다.
Key
plugins.<plugin>.mcp_servers.<server>.identity.command.args
Type / Values
array<table>
Details
플러그인에 포함된 stdio 서버의 인수를 순서대로 대조할 매처입니다. 설정된 인수 목록의 길이가 같고 모든 위치에서 일치해야 합니다.
Key
plugins.<plugin>.mcp_servers.<server>.identity.command.args[].expression
Type / Values
string
Details
regex 인수 매처에서 사용할 정규식입니다. 인수 값 전체와 일치해야 합니다.
Key
plugins.<plugin>.mcp_servers.<server>.identity.command.args[].match
Type / Values
exact | prefix | regex
Details
이 위치의 인수를 대조할 방식입니다.
Key
plugins.<plugin>.mcp_servers.<server>.identity.command.args[].value
Type / Values
string
Details
exact 또는 prefix 인수 매처에서 사용할 값입니다.
Key
plugins.<plugin>.mcp_servers.<server>.identity.command.executable
Type / Values
string
Details
플러그인에 포함된 stdio 서버의 설정된 명령어가 정확히 일치해야 하는 실행 파일입니다.
Key
plugins.<plugin>.mcp_servers.<server>.identity.url
Type / Values
string | table
Details
정확한 URL 문자열로 플러그인의 스트리밍 가능한 HTTP MCP 서버를 허용하거나 exact, prefix, regex 값 매처 테이블을 사용합니다.
Key
plugins.<plugin>.mcp_servers.<server>.identity.url.expression
Type / Values
string
Details
regex URL 매처에서 사용할 정규식입니다. URL 값 전체와 일치해야 합니다.
Key
plugins.<plugin>.mcp_servers.<server>.identity.url.match
Type / Values
exact | prefix | regex
Details
플러그인에 포함된 MCP 서버의 URL을 대조할 방식입니다.
Key
plugins.<plugin>.mcp_servers.<server>.identity.url.value
Type / Values
string
Details
exact 또는 prefix URL 매처에서 사용할 값입니다.
Key
remote_sandbox_config
Type / Values
array<table>
Details
호스트별 샌드박스 요구 사항입니다. 확인된 호스트 이름과 hostname_patterns가 일치하는 첫 항목이 해당 요구 사항 소스의 최상위 allowed_sandbox_modes를 재정의합니다. 현재 호스트별 항목은 샌드박스 모드만 재정의합니다.
Key
remote_sandbox_config[].allowed_sandbox_modes
Type / Values
array<string>
Details
이 호스트별 항목이 일치할 때 허용할 샌드박스 모드입니다.
Key
remote_sandbox_config[].hostname_patterns
Type / Values
array<string>
Details
대소문자를 구분하지 않는 호스트 이름 패턴입니다. 임의의 문자열에는 *, 문자 하나에는 ?를 사용할 수 있습니다.
Key
rules
Type / Values
table
Details
.rules 파일과 병합되는 관리자 강제 명령어 규칙입니다. 요구 사항 규칙은 제한을 부과해야 합니다.
Key
rules.prefix_rules
Type / Values
array<table>
Details
강제할 접두사 규칙 목록입니다. 각 규칙에 pattern과 decision이 필요합니다.
Key
rules.prefix_rules[].decision
Type / Values
prompt | forbidden
Details
필수 항목입니다. 요구 사항 규칙은 승인 요청 또는 금지만 지정할 수 있으며 허용은 지정할 수 없습니다.
Key
rules.prefix_rules[].justification
Type / Values
string
Details
승인 요청이나 거부 메시지에 표시할 사유입니다. 선택 사항이며 지정할 경우 비어 있으면 안 됩니다.
Key
rules.prefix_rules[].pattern
Type / Values
array<table>
Details
패턴 토큰으로 표현한 명령어 접두사입니다. 각 토큰에는 token 또는 any_of 중 하나를 지정합니다.
Key
rules.prefix_rules[].pattern[].any_of
Type / Values
array<string>
Details
이 위치에서 대안으로 허용할 토큰 목록입니다.
Key
rules.prefix_rules[].pattern[].token
Type / Values
string
Details
이 위치에서 일치해야 하는 단일 리터럴 토큰입니다.
Key
sqlite_home
Type / Values
string (path)
Details
Codex가 SQLite 기반 런타임 상태를 저장할 디렉터리를 강제합니다.
Key
unsafe_enforce_sqlite_journal_mode
Type / Values
boolean
Details
Linux에서 true로 설정하면 NFS에 있는 기존 SQLite 데이터베이스를 쓰기용으로 열기 전에 저널링 모드를 WAL에서 DELETE로 전환합니다. 기본값은 false입니다. 마운트가 호스트 간 POSIX 잠금을 지원해야 합니다. 마이그레이션이 성공할 때까지 모든 호스트에서 해당 데이터베이스를 사용하는 다른 SQLite 클라이언트를 모두 중지한 상태로 두세요. 교체된 파일은 기존 파일의 모드 비트를 유지하지만 소유자는 마이그레이션을 실행한 사용자가 됩니다. 원래 소유자, 그룹 및 확장 ACL은 복사되지 않습니다.
Key
windows
Type / Values
table
Details
네이티브 Windows 샌드박스 요구 사항입니다.
Key
windows.allow_mxc
Type / Values
boolean
Details
false로 설정하면 명시적인 MXC 선택과 features.prefer_mxc를 통한 자동 선택을 모두 금지합니다. 생략하거나 true로 설정하면 MXC가 허용되지만 활성화되거나 필수가 되지는 않습니다. 대체 구현을 사용할 때는 기존 구현에 대한 제한이 계속 적용됩니다.
Key
windows.allowed_sandbox_implementations
Type / Values
array<string>
Details
허용할 기존 네이티브 Windows 샌드박스 구현(elevated, unelevated)입니다. 목록은 비어 있으면 안 됩니다. 둘 다 허용되고 모드를 선택하지 않으면 Codex는 elevated를 우선 사용합니다. 사용 가능한 mxc 샌드박스는 이 목록으로 제한되지 않습니다.
Key
windows.require_mxc
Type / Values
boolean
Details
Windows에서 true로 설정하면 실제 적용되는 샌드박스 구현으로 MXC만 허용합니다. MXC 선택은 별도로 설정하세요. Codex가 MXC를 사용할 수 없으면 기존 샌드박스로 전환하지 않고 설정에 실패합니다.