Tài liệu ChatGPT
Tiếng Việt
Liên hệ goolvyouyou@gmail.com

Tham chiếu cấu hình

Tài liệu tham chiếu đầy đủ về config.toml và requirements.toml của Codex

Hãy dùng trang này làm tài liệu tham chiếu có thể tìm kiếm cho các tệp cấu hình Codex. Để xem hướng dẫn về khái niệm và các ví dụ, hãy bắt đầu với Kiến thức cơ bản về cấu hình và Cấu hình nâng cao.

Thiết lập cho quyền truy cập máy tính cục bộ với Work Cloud

Khi bật quyền truy cập máy tính cục bộ với Work Cloud, đám mây của OpenAI điều phối tác vụ, còn các công cụ được hỗ trợ chạy trên đám mây hoặc trên máy tính được kết nối. Các yêu cầu đặt ra giới hạn; các giá trị cấu hình cung cấp giá trị mặc định.

Sử dụng API chính sách để quản lý các thiết lập Global. Để quản lý các thiết lập Local hoặc Codex Cloud, hãy sử dụng giao diện Agent Security. Các quy trình Global API hiện có vẫn khả dụng sau khi di chuyển. Hãy kiểm thử các tập lệnh và tích hợp Terraform của bạn, đồng thời xác nhận rằng việc gán chính sách và thứ tự chính sách không thay đổi. Việc hỗ trợ một trường trong requirements.toml tự nó không đảm bảo khả năng tương thích API.

Thiết lập hoặc nhóm thiết lập Phạm vi khi truy cập máy tính cục bộ với Work Cloud Hướng dẫn
Chính sách phê duyệt và yêu cầu xét duyệt Chính sách Global của bộ điều phối khi bật chính sách được quản lý Giữ các biện pháp kiểm soát phê duyệt và xét duyệt trong Global. Các giá trị ghi đè theo môi trường không thể thay đổi biện pháp kiểm soát của bộ điều phối. Thực thi cục bộ và thực thi trong container đám mây có phạm vi chính sách riêng.
Ứng dụng được quản lý, MCP server, plugin, kho tiện ích và quy tắc lệnh Chính sách Global Giữ các biện pháp kiểm soát này ở phạm vi Global. Không coi sự hiện diện của một trường trong lược đồ là bằng chứng cho thấy trường đó có thể được chỉnh sửa theo từng môi trường.
Yêu cầu về tệp, môi trường cô lập và mạng có thể áp dụng trên nhiều môi trường Thực thi cục bộ Đối với thực thi cục bộ, các yêu cầu của MDM và các yêu cầu quản lý thiết bị kiểu cũ có mức ưu tiên cao hơn Agent Security. Tệp yêu cầu hệ thống của thiết bị có mức ưu tiên thấp hơn Agent Security. Cấu hình requirements.toml mới dành cho doanh nghiệp không áp dụng cho các container đám mây của Work; các container này tiếp tục áp dụng các chính sách Work Cloud hiện có.
Biện pháp kiểm soát trình thực thi riêng cho từng nền tảng Máy tính chạy bước đó Khả năng hỗ trợ phụ thuộc vào trình thực thi và nền tảng.
Hook được quản lý Khi được bật, các hook MCP do quản trị viên định nghĩa chạy trên bộ điều phối đám mây (orchestrator) cho các sự kiện vòng đời và công cụ được hỗ trợ. Trước khi dựa vào các hook này, hãy kiểm tra kết nối callback, xác nhận các sự kiện mà kết nối nhận được và kiểm tra ảnh hưởng của lỗi đến tác vụ. Các hook MCP không cung cấp nhật ký kiểm toán Compliance API đầy đủ. Các hook lệnh, hook từ cấu hình cục bộ và hook từ plugin không được hỗ trợ khi điều phối trên đám mây, ngay cả khi công cụ thực thi cục bộ. Các hook hiện được hỗ trợ vẫn áp dụng cho các luồng Work và Codex chỉ chạy cục bộ, trong đó cả điều phối lẫn thực thi đều diễn ra cục bộ.
Địa chỉ lắng nghe proxy, cổng và thiết lập tiến trình Không phải chính sách môi trường có thể áp dụng trên nhiều môi trường Môi trường chạy đám mây không hỗ trợ các cổng lắng nghe HTTP/SOCKS được quản lý và trình lắng nghe proxy dùng địa chỉ ngoài loopback; khả năng hỗ trợ quy tắc socket phụ thuộc vào luồng thực thi. Cấu hình proxy tùy chỉnh tách biệt với các hạn chế đích kết nối được hỗ trợ.
Thiết lập chỉ dành cho ứng dụng và giá trị mặc định cục bộ thông thường Không nhất thiết được bộ điều phối đám mây sử dụng Các biện pháp kiểm soát do ứng dụng thực thi có thể vẫn có hiệu lực ngay cả khi quyền truy cập máy tính cục bộ với Work Cloud không sử dụng chúng. Cần xác minh riêng việc phân phối qua đám mây và hành vi của trình duyệt đám mây.

Yêu cầu Agent Security cho quyền truy cập máy tính cục bộ với Work Cloud

Đối với Work có quyền truy cập cục bộ và dots, chính sách Global được hỗ trợ áp dụng cho bộ điều phối đám mây dùng chung khi bật chính sách được quản lý. Các yêu cầu thực thi cục bộ chi phối máy tính được kết nối. Các container đám mây của Work và máy tính đám mây của dots sử dụng cấu hình và yêu cầu thực thi riêng. Hãy kiểm thử riêng các biện pháp kiểm soát cục bộ và trên đám mây.

Có trong giao diện Agent Security

  • Các chính sách phê duyệt được phép
  • Các chế độ tìm kiếm web được phép

Được cấu hình qua TOML

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

Các yêu cầu này của bộ điều phối vẫn nằm trong Global. Chúng không cấu hình quyền sử dụng các chức năng đám mây dùng chung, cũng không khiến các thiết lập thực thi cục bộ có thể được áp dụng cho container đám mây của Work hoặc máy tính đám mây của dots.

Giới hạn tương thích của quyền truy cập máy tính cục bộ với Work Cloud

Khả năng hỗ trợ phụ thuộc vào trường, cách phân phối chính sách và nơi tác vụ chạy. Hãy kiểm tra chính sách có hiệu lực của thành viên trước khi bật đồng bộ hóa. Một số biện pháp kiểm soát cần được kiểm thử trong môi trường triển khai của bạn, như ghi chú trong bảng.

Trong một chính sách, thứ tự ưu tiên từ cao xuống thấp là giá trị ghi đè theo môi trường dành riêng cho từng hệ điều hành → giá trị ghi đè theo môi trường áp dụng cho mọi hệ điều hành → Global. Chính sách có mức ưu tiên cao hơn được áp dụng ngay cả khi chính sách có mức ưu tiên thấp hơn cụ thể hơn.

Đối với việc thực thi cục bộ, các yêu cầu từ MDM và cơ chế quản lý thiết bị cũ được ưu tiên hơn Agent Security, còn Agent Security được ưu tiên hơn tệp yêu cầu hệ thống của thiết bị. Một số yêu cầu, bao gồm yêu cầu về mạng, có quy tắc hợp nhất riêng cho từng trường và giới hạn khi chạy. Xem ví dụ trong Cấu hình được quản lý.

Thiết lập hoặc nhóm thiết lập Khả năng tương thích với quyền truy cập máy tính cục bộ qua Work Cloud Hướng dẫn dành cho quản trị viên
sqlite_home, log_dir, model_catalog_json Không hỗ trợ dùng làm giá trị ghi đè được quản lý trên đám mây. Đường dẫn cục bộ không thể thay đổi vị trí lưu trữ hoặc nhật ký trên đám mây. Danh mục mô hình cục bộ không được chuyển sang.
model_provider, model_providers Không được hỗ trợ trong các yêu cầu hoặc cấu hình được quản lý cho quyền truy cập máy tính cục bộ qua Work Cloud. Các cổng suy luận tùy chỉnh và kết nối với nhà cung cấp không được chuyển sang thông qua các trường này. Điều này độc lập với việc chọn mô hình.
enforce_residency Chặn quyền truy cập máy tính cục bộ qua Work Cloud khi được bật trong bất kỳ chính sách đám mây nào. Nếu enforce_residency được bật trong bất kỳ chính sách đám mây nào, Cho phép truy cập máy tính cục bộ sẽ bị vô hiệu hóa cho cả Work và dots. Biện pháp bảo vệ này không cấu hình nơi lưu trú dữ liệu của không gian làm việc và cũng không tự vô hiệu hóa Work Cloud hay dots.
application.network.enabled và application.network.domains Không được hỗ trợ khi truy cập máy tính cục bộ qua Work Cloud. Không sử dụng các hạn chế về đích kết nối của ứng dụng này để kiểm soát kết nối mạng của lệnh khi truy cập máy tính cục bộ qua Work Cloud.
allow_browser_and_computer_use, in_app_browser, additional_developer_instructions Cần xác minh việc phân phối chính sách đám mây. Quyền truy cập máy tính cục bộ qua Work Cloud từ chối các khóa yêu cầu được quản lý này. Các hạn chế đối với trình duyệt có cơ chế kiểm tra phía ứng dụng. Điều đó không chứng minh rằng chính sách được phân phối qua đám mây hay được thực thi trên trình duyệt đám mây. additional_developer_instructions cần sự hỗ trợ của bộ điều phối.
experimental_network và permissions.<profile>.network Hỗ trợ một phần. Các hạn chế được hỗ trợ về đích kết nối và bộ thực thi khác với cấu hình proxy tùy chỉnh. Môi trường chạy trên đám mây không hỗ trợ các cổng lắng nghe HTTP/SOCKS được quản lý và bộ lắng nghe proxy ngoài giao diện loopback; khả năng hỗ trợ quy tắc socket phụ thuộc vào luồng thực thi. Cơ chế hợp nhất khi thực thi cục bộ là riêng biệt. Các hạn chế về mạng của lệnh không vô hiệu hóa tính năng tìm kiếm được lưu trữ trên máy chủ, MCP hoặc công cụ ứng dụng.
tính năng / feature_requirements, mô hình, computer_use Hỗ trợ một phần. Các tùy chọn đã ngừng hỗ trợ như tool_search = false, tool_search_always_defer_mcp_tools = false, js_repl = true và remote_control = true bị từ chối. Một số thiết lập sử dụng máy tính vẫn cần được xác minh từ đầu đến cuối.
browser_use, allow_appshots, phản hồi, allow_remote_control, hạn chế về nguồn trên marketplace Ứng dụng hoặc app-server thực thi các biện pháp kiểm soát này trên một số luồng phân phối chính sách. Các biện pháp kiểm soát của ứng dụng vẫn có thể áp dụng khi quyền truy cập máy tính cục bộ qua Work Cloud bỏ qua một trường. Quy tắc về trang web của trình duyệt trên máy tính không áp dụng cho các container đám mây của Work. Hãy xác minh trên giao diện thực tế và luồng phân phối chính sách thực tế.

Lược đồ cấu hình bao gồm các khóa có thể không hoạt động khi truy cập máy tính cục bộ qua Work Cloud hoặc không hỗ trợ giá trị ghi đè theo môi trường. Xem Cấu hình được quản lý để biết cấu hình cơ sở toàn cục và thứ tự ưu tiên.

config.toml

Cấu hình cấp người dùng nằm trong ~/.codex/config.toml. Bạn cũng có thể thêm các giá trị ghi đè theo phạm vi dự án trong các tệp .codex/config.toml. Codex chỉ tải các tệp cấu hình theo phạm vi dự án khi bạn tin cậy dự án đó.

Cấu hình theo phạm vi dự án không thể ghi đè nhà cung cấp cục bộ trên máy, thông tin xác thực, siêu dữ liệu yêu cầu ứng dụng do máy chủ sở hữu, thông báo, lựa chọn hồ sơ cấu hình hoặc các khóa định tuyến dữ liệu đo từ xa. Codex bỏ qua openai_base_url, chatgpt_base_url, apps_mcp_product_sku, model_provider, model_providers, notify, profile, profiles, experimental_realtime_ws_base_url và otel khi chúng xuất hiện trong một .codex/config.toml cục bộ của dự án; thay vào đó, hãy đặt các khóa về nhà cung cấp, thông báo và dữ liệu đo từ xa trong cấu hình cấp người dùng. Các tệp hồ sơ cấu hình nằm cạnh config.toml dưới dạng $CODEX_HOME/profile-name.config.toml; chọn một tệp bằng --profile profile-name.

Đối với các khóa môi trường cô lập và phê duyệt (approval_policy, sandbox_mode và sandbox_workspace_write.*), hãy sử dụng tài liệu tham chiếu này cùng với Môi trường cô lập và phê duyệt, Các đường dẫn được bảo vệ trong thư mục gốc có thể ghi và Quyền truy cập mạng. Đối với hồ sơ quyền đang ở giai đoạn beta, hãy xem Quyền.

Codex và ChatGPT Work không còn hỗ trợ approval_policy = "untrusted". Hãy xóa thiết lập này hoặc chọn một chính sách được hỗ trợ. Các mục dự án có trust_level = "untrusted" trong ~/.codex/config.toml ở cấp người dùng vẫn được hỗ trợ. Xem Chuyển đổi từ chính sách phê duyệt untrusted đã ngừng hỗ trợ để tham khảo ví dụ và những đánh đổi khi lựa chọn cách phê duyệt.

Đặt model thành một mô hình khả dụng cho tài khoản đã đăng nhập hoặc không gian làm việc của bạn. Xem Khả năng cung cấp GPT-6.1 Sol trước khi sử dụng giá trị trong ví dụ.

Khóa Loại / giá trị Chi tiết
agents table Thiết lập đa tác nhân và khai báo vai trò tùy chỉnh. Tên của các thiết lập vô hướng được dành riêng và không thể dùng làm tên vai trò tùy chỉnh.
agents.<name>.config_file string (path) Đường dẫn đến lớp cấu hình TOML cho vai trò đó; đường dẫn tương đối được phân giải từ tệp cấu hình khai báo vai trò.
agents.<name>.description string Hướng dẫn vai trò được hiển thị cho Codex khi lựa chọn và tạo loại tác nhân đó.
agents.default_subagent_model string Mô hình mặc định cho các tác nhân được tạo. Mô hình được chỉ định rõ khi tạo tác nhân được ưu tiên.
agents.default_subagent_reasoning_effort string Mức độ suy luận mặc định cho các tác nhân được tạo. Mức độ được chỉ định rõ khi tạo tác nhân được ưu tiên.
agents.enabled boolean Bật hoặc tắt các công cụ đa tác nhân (mặc định: true).
agents.interrupt_message boolean Ghi lại thông báo mà mô hình có thể đọc khi một lượt của tác nhân bị gián đoạn (mặc định: true).
agents.max_concurrent_threads_per_session number Số luồng tác nhân được tạo tối đa có thể mở đồng thời, không tính luồng chính. Nếu không đặt, Codex chọn giá trị mặc định.
agents.max_threads number Bí danh cũ cho agents.max_concurrent_threads_per_session.
allow_login_shell boolean Cho phép các công cụ dựa trên shell sử dụng cơ chế shell đăng nhập. Mặc định là true; khi là false, các yêu cầu login = true bị từ chối và nếu bỏ qua login thì mặc định dùng shell không đăng nhập.
analytics.enabled boolean Bật hoặc tắt tính năng phân tích cho máy/hồ sơ này. Nếu không đặt, áp dụng giá trị mặc định của ứng dụng khách.
approval_policy on-request | never | { granular = { sandbox_approval = bool, rules = bool, mcp_elicitations = bool, request_permissions = bool, skill_approval = bool } } Kiểm soát thời điểm Codex tạm dừng để xin phê duyệt trước khi thực thi lệnh. Bạn cũng có thể dùng approval_policy = { granular = { ... } } để cho phép hoặc tự động từ chối các nhóm yêu cầu cụ thể, đồng thời giữ các yêu cầu khác ở chế độ tương tác. untrusted không được hỗ trợ và on-failure đã ngừng được khuyến nghị sử dụng; hãy dùng on-request cho các lần chạy tương tác hoặc never cho các lần chạy không tương tác.
approval_policy.granular.mcp_elicitations boolean Khi là true, cho phép hiển thị yêu cầu cung cấp thông tin của MCP thay vì tự động từ chối.
approval_policy.granular.request_permissions boolean Khi là true, cho phép hiển thị yêu cầu từ công cụ request_permissions.
approval_policy.granular.rules boolean Khi là true, cho phép hiển thị yêu cầu phê duyệt do các quy tắc execpolicy prompt kích hoạt.
approval_policy.granular.sandbox_approval boolean Khi là true, cho phép hiển thị yêu cầu phê duyệt nâng quyền môi trường cô lập.
approval_policy.granular.skill_approval boolean Khi là true, cho phép hiển thị yêu cầu phê duyệt tập lệnh Skill.
approvals_reviewer user | auto_review Bên xét duyệt các yêu cầu phê duyệt đủ điều kiện theo on-request hoặc các chính sách phê duyệt chi tiết. Mặc định là user; auto_review sử dụng tác nhân phụ xét duyệt. Thiết lập này không thay đổi cơ chế môi trường cô lập và không xét duyệt các hành động vốn đã được phép trong môi trường cô lập.
apps._default.approvals_reviewer user | auto_review Bên xét duyệt mặc định cho các yêu cầu phê duyệt công cụ ứng dụng, trừ khi được ghi đè theo từng ứng dụng. Nếu bỏ qua, các ứng dụng kế thừa giá trị approvals_reviewer ở cấp cao nhất.
apps._default.default_tools_approval_mode auto | prompt | writes | approve Hành vi phê duyệt mặc định cho các công cụ ứng dụng không có thiết lập ghi đè theo ứng dụng hoặc công cụ.
apps._default.destructive_enabled boolean Mặc định cho phép/từ chối các công cụ ứng dụng có destructive_hint = true.
apps._default.enabled boolean Trạng thái bật mặc định cho tất cả ứng dụng, trừ khi được ghi đè theo từng ứng dụng.
apps._default.open_world_enabled boolean Mặc định cho phép/từ chối các công cụ ứng dụng có open_world_hint = true.
apps.<id>.approvals_reviewer user | auto_review Bên xét duyệt các yêu cầu phê duyệt công cụ của ứng dụng này. Ghi đè apps._default.approvals_reviewer.
apps.<id>.default_tools_approval_mode auto | prompt | writes | approve Hành vi phê duyệt mặc định cho các công cụ trong ứng dụng này, trừ khi có thiết lập ghi đè theo từng công cụ.
apps.<id>.default_tools_enabled boolean Trạng thái bật mặc định cho các công cụ trong ứng dụng này, trừ khi có thiết lập ghi đè theo từng công cụ.
apps.<id>.destructive_enabled boolean Cho phép hoặc chặn các công cụ trong ứng dụng này công bố destructive_hint = true.
apps.<id>.enabled boolean Bật hoặc tắt một ứng dụng/trình kết nối cụ thể theo ID (mặc định: true).
apps.<id>.open_world_enabled boolean Cho phép hoặc chặn các công cụ trong ứng dụng này công bố open_world_hint = true.
apps.<id>.tools.<tool>.approval_mode auto | prompt | writes | approve Ghi đè hành vi phê duyệt cho một công cụ ứng dụng cụ thể.
apps.<id>.tools.<tool>.enabled boolean Ghi đè trạng thái bật cho một công cụ ứng dụng cụ thể (ví dụ: repos/list).
auto_review.extra_policy string Chính sách Markdown cục bộ bổ sung cho việc xét duyệt tự động, được đưa vào cùng chính sách chính. guardian_extra_policy do quản trị viên quản lý được ưu tiên. Các giá trị trống bị bỏ qua.
auto_review.policy string Hướng dẫn chính sách bằng Markdown cục bộ cho việc xét duyệt tự động. guardian_policy_config do quản trị viên quản lý được ưu tiên. Các giá trị trống bị bỏ qua.
background_terminal_max_timeout number Thời gian thăm dò tối đa tính bằng mili giây cho các lần thăm dò write_stdin trống (thăm dò terminal ở chế độ nền). Mặc định: 300000 (5 phút). Thay thế khóa background_terminal_timeout cũ.
browser_use.allow_history_access boolean Đặt thành false để hạn chế quyền truy cập lịch sử trình duyệt. Các yêu cầu do quản trị viên quản lý có thể bắt buộc áp dụng hạn chế này.
browser_use.default_origin_policy table Các hạn chế dự phòng theo origin của trình duyệt. Hỗ trợ access, uploads, downloads và full_cdp_access, mỗi mục được đặt thành allow hoặc deny.
browser_use.origins.<origin> table Các hạn chế của trình duyệt theo từng origin, với các trường giống browser_use.default_origin_policy. Bao gồm scheme HTTP hoặc HTTPS và cổng tùy chọn; bỏ qua đường dẫn, truy vấn và fragment. Các giá trị cục bộ không thể nới lỏng những lệnh cấm do quản trị viên quản lý.
chatgpt_base_url string Ghi đè URL cơ sở được sử dụng trong quy trình đăng nhập ChatGPT.
check_for_update_on_startup boolean Kiểm tra bản cập nhật Codex khi khởi động (chỉ đặt thành false khi các bản cập nhật được quản lý tập trung).
cli_auth_credentials_store file | keyring | auto | ephemeral Kiểm soát nơi CLI lưu thông tin xác thực đã lưu đệm.
compact_prompt string Ghi đè trực tiếp lời nhắc nén lịch sử.
computer_use.default_app_access allow | deny Chính sách truy cập ứng dụng gốc dự phòng cho Computer Use. Các mục dành riêng cho ứng dụng có thể cung cấp chính sách; cấu hình cục bộ không thể nới lỏng các hạn chế do quản trị viên quản lý.
computer_use.macos.bundle_ids map<string, allow | deny> Quyền truy cập ứng dụng macOS gốc, lấy mã định danh bundle làm khóa.
computer_use.windows.always_allowed_app_ids array<string> Các mã định danh ứng dụng Windows mà Computer Use có thể mở mà không cần hỏi. Các ứng dụng ngoài danh sách cần được phê duyệt; xóa các mục đã lưu trong phần thiết lập Computer Use của ứng dụng ChatGPT trên máy tính.
computer_use.windows.aumids map<string, allow | deny> Quyền truy cập ứng dụng Windows đóng gói, lấy Application User Model ID (AUMID) làm khóa.
computer_use.windows.exes array<table> Quy tắc truy cập tệp thực thi Windows. Mỗi quy tắc bắt buộc có publisher_name, product_name và access (allow hoặc deny); binary_name là tùy chọn.
default_permissions string Tên hồ sơ quyền mặc định áp dụng cho các lệnh gọi công cụ trong môi trường cô lập. Các hồ sơ tích hợp sẵn là :read-only, :workspace và :danger-full-access; tên hồ sơ tùy chỉnh cần có các bảng [permissions.&lt;name&gt;] tương ứng. Không kết hợp với sandbox_mode hoặc [sandbox_workspace_write].
desktop.custom_file_handlers.<id> table Chỉ ở cấp người dùng. Định nghĩa một đích Mở bằng bổ sung cho ứng dụng ChatGPT trên máy tính. Xem Thêm trình xử lý tệp tùy chỉnh để biết ví dụ và các ràng buộc về ID trình xử lý.
desktop.custom_file_handlers.<id>.args array<string> Các đối số được chèn giữa lệnh và đầu vào tệp (mặc định: []).
desktop.custom_file_handlers.<id>.command string Đường dẫn tệp thực thi hoặc tên lệnh để phát hiện và khởi chạy. Bắt buộc.
desktop.custom_file_handlers.<id>.icon string Đường dẫn tài nguyên đi kèm, URL data:image/... mã hóa Base64, URI tệp hoặc đường dẫn cục bộ tuyệt đối cho biểu tượng trình xử lý. Bắt buộc; các nguồn không được hỗ trợ sử dụng biểu tượng VS Code mặc định.
desktop.custom_file_handlers.<id>.input path | json_argument | json_stdin Cách ứng dụng gửi đầu vào tệp đến trình xử lý (mặc định: path).
desktop.custom_file_handlers.<id>.label string Tên hiển thị trong các menu Mở bằng. Bắt buộc.
desktop.custom_file_handlers.<id>.supports_ssh boolean Cung cấp trình xử lý cho các tệp trong không gian làm việc SSH (mặc định: false).
developer_instructions string Hướng dẫn bổ sung của nhà phát triển được chèn vào phiên (tùy chọn).
disable_paste_burst boolean Tắt tính năng phát hiện dán dồn trong TUI.
experimental_compact_prompt_file string (path) Tải nội dung ghi đè lời nhắc nén từ tệp (thử nghiệm).
experimental_use_unified_exec_tool boolean Tên cũ để bật exec hợp nhất; ưu tiên dùng [features].unified_exec hoặc codex --enable unified_exec.
features.apps boolean Bật tích hợp ứng dụng (trình kết nối) (ổn định; bật theo mặc định). Lưu lượng của ứng dụng và trình kết nối không chịu sự kiểm soát của proxy mạng dành cho lệnh trong môi trường cô lập hoặc danh sách miền được phép của proxy đó.
features.code_mode.direct_only_tool_namespaces array<string> Các không gian tên công cụ mà chế độ mã chỉ có thể sử dụng thông qua lệnh gọi công cụ trực tiếp.
features.code_mode.enabled boolean Bật cấu hình tính năng chế độ mã. Tính năng này đang được phát triển và tắt theo mặc định.
features.code_mode.excluded_tool_namespaces array<string> Các không gian tên công cụ mà chế độ mã loại khỏi hướng dẫn công cụ lồng nhau và không cung cấp cho trình thực thi.
features.context_management.experimental_mode boolean Thiết lập quản lý ngữ cảnh thử nghiệm. Tính năng này hiện chưa khả dụng.
features.enable_request_compression boolean Nén phần thân yêu cầu truyền luồng bằng zstd khi được hỗ trợ (ổn định; bật theo mặc định).
features.fast_mode boolean Bật lựa chọn cấp dịch vụ từ danh mục mô hình trong TUI, bao gồm các lệnh cấp Fast khi mô hình đang hoạt động công bố hỗ trợ (ổn định; bật theo mặc định).
features.goals boolean Bật tính năng lưu bền vững mục tiêu và tự động tiếp tục (ổn định; bật theo mặc định).
features.hooks boolean Bật các hook vòng đời được tải từ hooks.json hoặc cấu hình [hooks] trực tiếp. features.codex_hooks là bí danh đã ngừng được khuyến nghị sử dụng.
features.memories boolean Bật Bộ nhớ (tắt theo mặc định).
features.multi_agent boolean Bật các công cụ cộng tác đa tác nhân (spawn_agent, send_input, resume_agent, wait_agent và close_agent) (ổn định; bật theo mặc định).
features.network_proxy boolean | table Khởi động proxy mạng cho các lệnh trong môi trường cô lập (thử nghiệm; tắt theo mặc định). Bắt buộc để thực thi các quy tắc miền của hồ sơ quyền, trừ khi các yêu cầu experimental_network do quản trị viên quản lý đã bật khởi động proxy. Sử dụng bảng khi đặt các tùy chọn chính sách ở cấp tính năng như domains. Không lọc tìm kiếm web, ứng dụng, MCP hoặc các công cụ được lưu trữ khác.
features.network_proxy.allow_local_binding boolean Cho phép truy cập mạng cục bộ/riêng rộng hơn. Mặc định là false; các quy tắc cho phép với địa chỉ IP cục bộ chính xác hoặc localhost vẫn có thể cho phép các đích cục bộ cụ thể.
features.network_proxy.allow_upstream_proxy boolean Cho phép kết nối nối tiếp qua proxy thượng nguồn lấy từ môi trường. Mặc định là true.
features.network_proxy.dangerously_allow_all_unix_sockets boolean Cho phép các đích Unix socket tùy ý thay vì chỉ truy cập theo danh sách cho phép. Mặc định là false; chỉ sử dụng trong môi trường được kiểm soát chặt chẽ.
features.network_proxy.dangerously_allow_non_loopback_proxy boolean Cho phép địa chỉ lắng nghe ngoài loopback. Mặc định là false; bật thiết lập này có thể khiến các trình lắng nghe proxy có thể được truy cập từ bên ngoài localhost.
features.network_proxy.domains map<string, allow | deny> Chính sách miền cho kết nối mạng trong môi trường cô lập. Mặc định không đặt, nghĩa là không đích bên ngoài nào được phép cho đến khi bạn thêm các quy tắc allow. Hỗ trợ tên máy chủ chính xác, *.example.com chỉ cho miền con, **.example.com cho miền gốc cùng các miền con và quy tắc cho phép toàn cục *. Ưu tiên các quy tắc có phạm vi giới hạn vì * mở rộng quyền truy cập ra mạng công cộng. Thêm các quy tắc deny cho những đích bị chặn; deny được ưu tiên khi có xung đột.
features.network_proxy.enable_socks5 boolean Cung cấp hỗ trợ SOCKS5. Mặc định là true.
features.network_proxy.enable_socks5_udp boolean Cho phép UDP qua SOCKS5. Mặc định là true.
features.network_proxy.enabled boolean Khởi động proxy mạng cho lệnh trong môi trường cô lập khi quyền truy cập mạng của lệnh được bật. Mặc định là false; các quy tắc miền của hồ sơ quyền không được thực thi khi proxy tắt.
features.network_proxy.proxy_url string URL lắng nghe HTTP cho kết nối mạng trong môi trường cô lập. Mặc định là "http://127.0.0.1:3128".
features.network_proxy.socks_url string URL lắng nghe SOCKS5. Mặc định là "http://127.0.0.1:8081".
features.network_proxy.unix_sockets map<string, allow | deny> Chính sách Unix socket cho kết nối mạng trong môi trường cô lập. Mặc định không đặt; thêm các mục allow cho các socket được phép.
features.personality boolean Bật các tùy chọn lựa chọn tính cách (ổn định; bật theo mặc định).
features.prevent_idle_sleep boolean Ngăn máy chuyển sang chế độ ngủ khi một lượt đang chạy (thử nghiệm; tắt theo mặc định).
features.remote_plugin boolean Bật danh mục plugin từ xa (ổn định; bật theo mặc định).
features.rollout_budget.enabled boolean Bật theo dõi ngân sách rollout. Tính năng này đang được phát triển và tắt theo mặc định. Khi bật, bắt buộc có features.rollout_budget.limit_tokens.
features.rollout_budget.limit_tokens integer Giới hạn token dương để theo dõi ngân sách rollout. Bắt buộc khi bật ngân sách rollout.
features.rollout_budget.prefill_token_weight number Hệ số nhân hữu hạn, không âm cho các token prefill khi tính ngân sách rollout. Mặc định là 1.0.
features.rollout_budget.reminder_interval_tokens integer Khoảng token dương giữa các lần nhắc về ngân sách rollout. Mặc định là 10% của limit_tokens, tối thiểu 1 token.
features.rollout_budget.sampling_token_weight number Hệ số nhân hữu hạn, không âm cho các token được lấy mẫu khi tính ngân sách rollout. Mặc định là 1.0.
features.shell_snapshot boolean Chụp nhanh môi trường shell để tăng tốc các lệnh lặp lại (ổn định; bật theo mặc định).
features.shell_tool boolean Bật công cụ shell mặc định để chạy lệnh (ổn định; bật theo mặc định).
features.skill_mcp_dependency_install boolean Cho phép hỏi và cài đặt các thành phần phụ thuộc MCP còn thiếu cho skills (ổn định; bật theo mặc định).
features.unified_exec boolean Sử dụng công cụ exec hợp nhất dựa trên PTY (ổn định; bật theo mặc định, trừ trên Windows).
features.web_search boolean Tùy chọn bật/tắt cũ đã ngừng được khuyến nghị sử dụng; ưu tiên thiết lập web_search ở cấp cao nhất.
features.web_search_cached boolean Tùy chọn bật/tắt cũ đã ngừng được khuyến nghị sử dụng. Khi chưa đặt web_search, true ánh xạ tới web_search = "cached".
features.web_search_request boolean Tùy chọn bật/tắt cũ đã ngừng được khuyến nghị sử dụng. Khi chưa đặt web_search, true ánh xạ tới web_search = "live".
feedback.enabled boolean Cho phép gửi phản hồi qua /feedback trên các ứng dụng khách cục bộ (mặc định: true).
file_opener vscode | vscode-insiders | windsurf | cursor | none Scheme URI dùng để mở các trích dẫn từ đầu ra Codex (mặc định: vscode).
forced_chatgpt_workspace_id string (uuid) Giới hạn đăng nhập ChatGPT ở một mã định danh không gian làm việc cụ thể.
forced_login_method chatgpt | api Giới hạn Codex ở một phương thức xác thực cụ thể.
hide_agent_reasoning boolean Ẩn các sự kiện suy luận trong cả TUI và đầu ra codex exec.
history.max_bytes number Nếu được đặt, giới hạn kích thước tệp lịch sử theo byte bằng cách loại bỏ các mục cũ nhất.
history.persistence save-all | none Kiểm soát việc Codex có lưu bản ghi phiên vào history.jsonl hay không.
hooks table Các hook vòng đời được cấu hình trực tiếp trong config.toml. Sử dụng cùng lược đồ sự kiện với hooks.json; xem hướng dẫn Hooks để biết ví dụ và các sự kiện được hỗ trợ.
hooks.<Event> array<table> Các nhóm đối sánh cho sự kiện hook như PreToolUse, PermissionRequest, PostToolUse, PreCompact, PostCompact, SessionStart, SessionEnd, SubagentStart, SubagentStop, UserPromptSubmit, Stop hoặc Interrupt.
hooks.<Event>[].hooks array<table> Các trình xử lý hook cho một nhóm đối sánh. Hỗ trợ hook lệnh và hook công cụ MCP, còn các trình xử lý hook lời nhắc và tác nhân được phân tích cú pháp nhưng bị bỏ qua.
hooks.<Event>[].hooks[].additionalContextLimit integer Ngưỡng token gần đúng cho từng trình xử lý để lưu additionalContext quá lớn xuống đĩa và hiển thị cho mô hình một bản xem trước ngắn hơn. Mặc định là 2500; 0 truyền toàn bộ ngữ cảnh trực tiếp cho mô hình. Xem Đầu ra hook lớn.
hooks.<Event>[].hooks[].async boolean Chạy hook lệnh ở chế độ nền mà không làm chậm thao tác kích hoạt. Mặc định là false; SessionEnd luôn chạy đồng bộ. Xem Chạy hook ở chế độ nền.
hooks.<Event>[].hooks[].commandWindows string Ghi đè lệnh chỉ dành cho Windows đối với các hook lệnh. Bí danh TOML command_windows cũng được chấp nhận.
instructions string Dành riêng cho mục đích sử dụng trong tương lai; ưu tiên dùng model_instructions_file hoặc AGENTS.md.
log_dir string (path) Thư mục nơi Codex ghi các tệp nhật ký; mặc định là $CODEX_HOME/log. Việc đặt rõ giá trị này cũng bật nhật ký TUI dạng văn bản thuần cần chủ động kích hoạt, codex-tui.log, trong thư mục đó.
marketplaces.<name>.ref string Nhánh, thẻ hoặc commit Git tùy chọn cho kho plugin.
marketplaces.<name>.source string Vị trí kho Git hoặc thư mục gốc của kho plugin cục bộ. Sử dụng đường dẫn tuyệt đối cho nguồn cục bộ; thư mục này chứa .agents/plugins/marketplace.json.
marketplaces.<name>.source_type git | local Loại nguồn cho một kho plugin đã cấu hình. Các kho có thể được định nghĩa trong config.toml của hệ thống, do đám mây quản lý, của người dùng hoặc của dự án đáng tin cậy.
marketplaces.<name>.sparse_paths array<string> Các đường dẫn sparse checkout tùy chọn cho kho plugin Git. Bao gồm danh mục kho plugin và mọi thư mục plugin cục bộ mà danh mục tham chiếu.
mcp_oauth_callback_port integer Cổng cố định toàn cục tùy chọn cho máy chủ callback HTTP cục bộ được sử dụng khi đăng nhập MCP OAuth. oauth.callback_port dành riêng cho máy chủ được ưu tiên. Khi cả hai đều chưa đặt, Codex liên kết với một cổng tạm thời do hệ điều hành chọn.
mcp_oauth_callback_url string URL callback cơ sở tùy chọn cho đăng nhập MCP OAuth, chẳng hạn như URL đầu vào của devbox. Các ứng dụng khách đăng ký trước mới được thêm sử dụng nguyên URL này khi máy chủ ủy quyền hỗ trợ nhận diện bên phát hành; các ứng dụng khách hiện có chưa lưu callback sẽ nối thêm ID callback dành riêng cho máy chủ. Khi không hỗ trợ nhận diện bên phát hành, mọi MCP server đăng ký trước có callback đã cấu hình thiếu ID bắt buộc sẽ chuyển sang URL này với ID được nối vào cuối. Cổng trong URL callback không quyết định cổng lắng nghe.
mcp_oauth_credentials_store auto | file | keyring Kho lưu trữ ưu tiên cho thông tin xác thực MCP OAuth.
mcp_optional_startup_grace_ms integer (milliseconds) Thời gian chờ chung cho các MCP servers tùy chọn khi tạo danh mục công cụ ban đầu. Mặc định là 1000. Đặt thành 0 để thay vào đó chờ theo startup_timeout_sec của từng máy chủ.
mcp_servers.<id>.args array<string> Các đối số được truyền cho lệnh MCP server stdio.
mcp_servers.<id>.auth oauth | chatgpt Phương án xác thực dự phòng cho MCP server HTTP sau các bearer token và tiêu đề ủy quyền đã cấu hình. oauth (mặc định) sử dụng thông tin xác thực MCP OAuth đã lưu khi có sẵn. chatgpt sử dụng phiên ChatGPT hiện tại cho origin ChatGPT chính chủ đáng tin cậy, sau đó chuyển sang OAuth đã lưu nếu cần. Cả hai chế độ đều có thể kết nối mà không xác thực nếu không tìm được thông tin xác thực từ bất kỳ nguồn nào.
mcp_servers.<id>.bearer_token_env_var string Biến môi trường cung cấp bearer token cho MCP server HTTP.
mcp_servers.<id>.command string Lệnh khởi chạy MCP server stdio.
mcp_servers.<id>.cwd string Thư mục làm việc của tiến trình MCP server stdio.
mcp_servers.<id>.default_tools_approval_mode auto | prompt | writes | approve Hành vi phê duyệt mặc định cho các công cụ MCP trên máy chủ này, trừ khi có thiết lập ghi đè theo từng công cụ.
mcp_servers.<id>.disabled_tools array<string> Danh sách từ chối được áp dụng sau enabled_tools cho MCP server.
mcp_servers.<id>.enabled boolean Tắt MCP server mà không xóa cấu hình của máy chủ đó.
mcp_servers.<id>.enabled_tools array<string> Danh sách tên công cụ được phép cung cấp bởi MCP server.
mcp_servers.<id>.env map<string,string> Các biến môi trường được chuyển tiếp đến MCP server stdio.
mcp_servers.<id>.env_http_headers map<string,string> Các tiêu đề HTTP được điền từ biến môi trường cho MCP server HTTP.
mcp_servers.<id>.env_vars array<string | { name = string, source = "local" | "remote" }> Các biến môi trường bổ sung được đưa vào danh sách cho phép đối với MCP server stdio. Các mục dạng chuỗi mặc định là source = "local"; chỉ sử dụng source = "remote" với stdio từ xa dựa trên trình thực thi.
mcp_servers.<id>.experimental_environment local | remote Vị trí triển khai thử nghiệm cho MCP server. remote khởi động các máy chủ stdio thông qua môi trường thực thi từ xa; chưa triển khai vị trí từ xa cho streamable HTTP.
mcp_servers.<id>.http_headers map<string,string> Các tiêu đề HTTP tĩnh được gửi kèm mỗi yêu cầu MCP HTTP.
mcp_servers.<id>.http_headers_helper string (command) Lệnh cục bộ in ra một đối tượng JSON gồm tên và giá trị của các tiêu đề HTTP. Chỉ hỗ trợ cho các MCP servers HTTP được kết nối cục bộ. Bearer token được chỉ định rõ và thông tin xác thực OAuth được ưu tiên hơn các tiêu đề Authorization do chương trình trợ giúp cung cấp.
mcp_servers.<id>.oauth_resource string Tham số tài nguyên OAuth RFC 8707 tùy chọn được đưa vào khi đăng nhập MCP.
mcp_servers.<id>.oauth.callback_port integer Cổng lắng nghe callback OAuth cố định cho MCP server này. Ghi đè mcp_oauth_callback_port. Với callback loopback trực tiếp có cổng được chỉ rõ trong URL, hãy cấu hình cùng cổng lắng nghe đó.
mcp_servers.<id>.oauth.callback_url string Callback OAuth dành riêng cho máy chủ. Các ứng dụng khách đã đăng ký trước tái sử dụng callback này khi hỗ trợ nhận diện bên phát hành hoặc URL đã kết thúc bằng ID callback dành riêng cho máy chủ. Nếu không, Codex sử dụng callback toàn cục hoặc mặc định với ID đó được nối vào cuối. Các ứng dụng khách không có ID đăng ký trước sử dụng callback này trong quá trình đăng ký ứng dụng khách.
mcp_servers.<id>.oauth.client_id string ID ứng dụng khách OAuth đã đăng ký trước, được sử dụng để ủy quyền và trao đổi token với MCP server này.
mcp_servers.<id>.required boolean Khi là true, làm cho quá trình khởi động/tiếp tục thất bại nếu MCP server đang bật này không thể khởi tạo.
mcp_servers.<id>.scopes array<string> Các phạm vi OAuth cần yêu cầu khi xác thực với MCP server đó.
mcp_servers.<id>.startup_timeout_ms number Bí danh cho startup_timeout_sec tính bằng mili giây.
mcp_servers.<id>.startup_timeout_sec number Ghi đè thời gian chờ khởi động mặc định 10 giây cho MCP server.
mcp_servers.<id>.tool_timeout_sec number Ghi đè thời gian chờ mặc định 60 giây cho từng công cụ của MCP server.
mcp_servers.<id>.tools.<tool>.approval_mode auto | prompt | writes | approve Ghi đè hành vi phê duyệt cho một công cụ MCP trên máy chủ này.
mcp_servers.<id>.tools.<tool>.output_token_limit integer (positive) Ngân sách token cho đầu ra của một công cụ MCP, trước phần dự phòng tiêu chuẩn 20% cho việc tuần tự hóa. Ghi đè ngân sách cắt ngắn đầu ra mặc định của mô hình cho công cụ đó.
mcp_servers.<id>.url string Điểm cuối của MCP server streamable HTTP.
memories.consolidation_model string Tùy chọn ghi đè mô hình để hợp nhất bộ nhớ toàn cục.
memories.disable_on_external_context boolean Khi là true, các luồng sử dụng ngữ cảnh bên ngoài như lệnh gọi công cụ MCP, tìm kiếm web hoặc tìm kiếm công cụ sẽ không được dùng để tạo bộ nhớ. Mặc định là false. Bí danh cũ: memories.no_memories_if_mcp_or_web_search.
memories.extract_model string Tùy chọn ghi đè mô hình để trích xuất bộ nhớ theo từng luồng.
memories.generate_memories boolean Khi là false, các luồng mới tạo không được lưu làm đầu vào để tạo bộ nhớ. Mặc định là true.
memories.max_raw_memories_for_consolidation number Số bộ nhớ thô gần đây tối đa được giữ lại để hợp nhất toàn cục. Mặc định là 256 và bị giới hạn ở 4096.
memories.max_rollout_age_days number Tuổi tối đa của các luồng được xem xét để tạo bộ nhớ. Mặc định là 30 và bị giới hạn trong khoảng 0-90.
memories.max_rollouts_per_startup number Số rollout ứng viên tối đa được xử lý trong mỗi lần khởi động. Mặc định là 16 và bị giới hạn ở 128.
memories.max_unused_days number Số ngày tối đa kể từ lần sử dụng bộ nhớ gần nhất trước khi bộ nhớ đó không còn đủ điều kiện hợp nhất. Mặc định là 30 và bị giới hạn trong khoảng 0-365.
memories.min_rate_limit_remaining_percent number Tỷ lệ phần trăm còn lại tối thiểu cần có trong các cửa sổ giới hạn tốc độ của Codex trước khi bắt đầu tạo bộ nhớ. Mặc định là 25 và bị giới hạn trong khoảng 0-100.
memories.min_rollout_idle_hours number Thời gian không hoạt động tối thiểu trước khi một luồng được xem xét để tạo bộ nhớ. Mặc định là 6 và bị giới hạn trong khoảng 1-48.
memories.use_memories boolean Khi là false, Codex bỏ qua việc chèn các bộ nhớ hiện có vào những phiên sau. Mặc định là true.
model string Mô hình sẽ sử dụng (ví dụ: gpt-6.1-sol).
model_auto_compact_token_limit number Ngưỡng token kích hoạt tính năng tự động nén lịch sử (nếu không đặt, sử dụng giá trị mặc định của mô hình).
model_auto_compact_token_limit_scope total | body_after_prefix Kiểm soát việc ngưỡng tự động nén tính toàn bộ ngữ cảnh đang hoạt động (total, mặc định) hay chỉ phần tăng thêm sau tiền tố cửa sổ nén được giữ lại (body_after_prefix).
model_catalog_json string (path) Đường dẫn tùy chọn đến danh mục mô hình JSON được tải khi khởi động. Tệp hồ sơ $CODEX_HOME/profile-name.config.toml được chọn có thể ghi đè giá trị này cho từng hồ sơ.
model_context_window number Số token trong cửa sổ ngữ cảnh mà mô hình đang hoạt động có thể sử dụng.
model_instructions_file string (path) Nội dung thay thế hướng dẫn tích hợp sẵn, dùng thay cho AGENTS.md.
model_provider string ID nhà cung cấp trong model_providers (mặc định: openai).
model_providers.<id> table Định nghĩa nhà cung cấp tùy chỉnh. Các ID nhà cung cấp tích hợp sẵn (openai, ollama và lmstudio) được dành riêng và không thể ghi đè.
model_providers.<id>.auth table Cấu hình bearer token dựa trên lệnh cho nhà cung cấp tùy chỉnh. Không kết hợp với env_key, experimental_bearer_token hoặc requires_openai_auth.
model_providers.<id>.auth.args array<string> Các đối số được truyền cho lệnh lấy token.
model_providers.<id>.auth.command string Lệnh cần chạy khi Codex cần bearer token. Lệnh phải in token ra stdout.
model_providers.<id>.auth.cwd string (path) Thư mục làm việc cho lệnh lấy token.
model_providers.<id>.auth.refresh_interval_ms number Tần suất Codex chủ động làm mới token, tính bằng mili giây (mặc định: 300000). Đặt thành 0 để chỉ làm mới sau một lần thử lại xác thực.
model_providers.<id>.auth.timeout_ms number Thời gian chạy tối đa của lệnh lấy token, tính bằng mili giây (mặc định: 5000).
model_providers.<id>.base_url string URL cơ sở API cho nhà cung cấp mô hình.
model_providers.<id>.env_http_headers map<string,string> Các tiêu đề HTTP được điền từ biến môi trường khi có.
model_providers.<id>.env_key string Biến môi trường cung cấp API key của nhà cung cấp.
model_providers.<id>.env_key_instructions string Hướng dẫn thiết lập tùy chọn cho API key của nhà cung cấp.
model_providers.<id>.experimental_bearer_token string Bearer token trực tiếp cho nhà cung cấp (không khuyến khích; hãy dùng env_key).
model_providers.<id>.http_headers map<string,string> Các tiêu đề HTTP tĩnh được thêm vào yêu cầu gửi đến nhà cung cấp.
model_providers.<id>.name string Tên hiển thị cho nhà cung cấp mô hình tùy chỉnh.
model_providers.<id>.query_params map<string,string> Các tham số truy vấn bổ sung được nối vào yêu cầu gửi đến nhà cung cấp.
model_providers.<id>.request_max_retries number Số lần thử lại cho các yêu cầu HTTP gửi đến nhà cung cấp (mặc định: 4).
model_providers.<id>.requires_openai_auth boolean Nhà cung cấp sử dụng xác thực OpenAI (mặc định là false).
model_providers.<id>.stream_idle_timeout_ms number Thời gian chờ khi luồng SSE không hoạt động, tính bằng mili giây (mặc định: 300000).
model_providers.<id>.stream_max_retries number Số lần thử lại khi luồng SSE bị gián đoạn (mặc định: 5).
model_providers.<id>.supports_standalone_web_search boolean Công bố hỗ trợ điểm cuối tìm kiếm web độc lập tương thích (mặc định: false). Tính năng tìm kiếm độc lập vẫn đang được phát triển và tắt theo mặc định; chỉ riêng khả năng tương thích của nhà cung cấp không bật tính năng này.
model_providers.<id>.supports_websockets boolean Nhà cung cấp đó có hỗ trợ phương thức truyền tải WebSocket của Responses API hay không.
model_providers.<id>.wire_api responses Giao thức được nhà cung cấp sử dụng. responses là giá trị duy nhất được hỗ trợ và là mặc định nếu bỏ qua.
model_providers.amazon-bedrock.aws.profile string Tên hồ sơ AWS được nhà cung cấp tích hợp sẵn amazon-bedrock sử dụng.
model_providers.amazon-bedrock.aws.region string Khu vực AWS được nhà cung cấp tích hợp sẵn amazon-bedrock sử dụng.
model_reasoning_effort string Mức độ suy luận mà mô hình đã chọn công bố hỗ trợ, chẳng hạn như low, medium, high, xhigh, max hoặc ultra. Các mức khả dụng phụ thuộc vào mô hình và ứng dụng khách.
model_reasoning_summary auto | concise | detailed | none Chọn mức độ chi tiết của bản tóm tắt suy luận hoặc tắt hoàn toàn các bản tóm tắt.
model_supports_reasoning_summaries boolean Buộc Codex gửi hoặc không gửi siêu dữ liệu suy luận.
model_verbosity low | medium | high Tùy chọn ghi đè mức độ dài dòng của GPT-5 Responses API; nếu không đặt, sử dụng giá trị mặc định của mô hình/cấu hình đặt sẵn đã chọn.
notice.hide_full_access_warning boolean Theo dõi việc xác nhận lời nhắc cảnh báo toàn quyền truy cập.
notice.hide_gpt-5.1-codex-max_migration_prompt boolean Theo dõi việc xác nhận lời nhắc chuyển sang gpt-5.1-codex-max.
notice.hide_gpt5_1_migration_prompt boolean Theo dõi việc xác nhận lời nhắc chuyển sang GPT-5.1.
notice.hide_rate_limit_model_nudge boolean Theo dõi việc tắt lời nhắc chuyển mô hình khi chạm giới hạn tốc độ.
notice.hide_world_writable_warning boolean Theo dõi việc xác nhận cảnh báo về các thư mục mà mọi người đều có quyền ghi trên Windows.
notice.model_migrations map<string,string> Theo dõi các lần chuyển đổi mô hình đã xác nhận dưới dạng ánh xạ cũ->mới.
notify array<string> Lệnh được gọi để gửi thông báo; nhận dữ liệu JSON từ Codex.
openai_base_url string Ghi đè URL cơ sở cho nhà cung cấp mô hình tích hợp sẵn openai.
oss_provider lmstudio | ollama Nhà cung cấp cục bộ mặc định khi chạy với --oss (mặc định sẽ hỏi nếu chưa đặt).
otel.environment string Nhãn môi trường được áp dụng cho các sự kiện OpenTelemetry được phát ra (mặc định: dev).
otel.exporter none | otlp-http | otlp-grpc Chọn trình xuất OpenTelemetry và cung cấp siêu dữ liệu điểm cuối nếu có.
otel.exporter.<id>.endpoint string Điểm cuối trình xuất cho nhật ký OTEL.
otel.exporter.<id>.headers map<string,string> Các tiêu đề tĩnh được gửi kèm yêu cầu của trình xuất OTEL.
otel.exporter.<id>.protocol binary | json Giao thức được trình xuất OTLP/HTTP sử dụng.
otel.exporter.<id>.tls.ca-certificate string Đường dẫn chứng chỉ CA cho TLS của trình xuất OTEL.
otel.exporter.<id>.tls.client-certificate string Đường dẫn chứng chỉ ứng dụng khách cho TLS của trình xuất OTEL.
otel.exporter.<id>.tls.client-private-key string Đường dẫn khóa riêng của ứng dụng khách cho TLS của trình xuất OTEL.
otel.log_user_prompt boolean Chủ động cho phép xuất nguyên văn lời nhắc của người dùng cùng nhật ký OpenTelemetry.
otel.metrics_exporter none | statsig | otlp-http | otlp-grpc Chọn trình xuất số liệu OpenTelemetry (mặc định là statsig).
otel.trace_exporter none | otlp-http | otlp-grpc Chọn trình xuất trace OpenTelemetry và cung cấp siêu dữ liệu điểm cuối nếu có.
otel.trace_exporter.<id>.endpoint string Điểm cuối trình xuất trace cho nhật ký OTEL.
otel.trace_exporter.<id>.headers map<string,string> Các tiêu đề tĩnh được gửi kèm yêu cầu của trình xuất trace OTEL.
otel.trace_exporter.<id>.protocol binary | json Giao thức được trình xuất trace OTLP/HTTP sử dụng.
otel.trace_exporter.<id>.tls.ca-certificate string Đường dẫn chứng chỉ CA cho TLS của trình xuất trace OTEL.
otel.trace_exporter.<id>.tls.client-certificate string Đường dẫn chứng chỉ ứng dụng khách cho TLS của trình xuất trace OTEL.
otel.trace_exporter.<id>.tls.client-private-key string Đường dẫn khóa riêng của ứng dụng khách cho TLS của trình xuất trace OTEL.
permissions.<name>.description string Mô tả dễ đọc cho hồ sơ có tên này. Hồ sơ không kế thừa mô tả của hồ sơ cha qua extends.
permissions.<name>.extends string Hồ sơ cha tùy chọn được áp dụng trước hồ sơ có tên này. Đặt thành một hồ sơ có tên khác, :read-only hoặc :workspace; :danger-full-access, hồ sơ cha chưa được định nghĩa và quan hệ vòng đều bị từ chối.
permissions.<name>.filesystem table Hồ sơ quyền hệ thống tệp có tên. Mỗi khóa là một đường dẫn tuyệt đối hoặc token đặc biệt như :minimal hoặc :workspace_roots.
permissions.<name>.filesystem.":workspace_roots".<subpath-or-glob> "read" | "write" | "deny" Quyền truy cập hệ thống tệp được giới hạn phạm vi tương đối với từng thư mục gốc không gian làm việc có hiệu lực. Sử dụng "." cho chính thư mục gốc; các đường dẫn con dạng glob như "**/*.env" có thể từ chối đọc bằng "deny".
permissions.<name>.filesystem.<path-or-glob> "read" | "write" | "deny" | table Cấp quyền truy cập trực tiếp cho một đường dẫn, mẫu glob hoặc token đặc biệt, hoặc giới hạn phạm vi các mục lồng nhau dưới thư mục gốc đó. Sử dụng "deny" để từ chối đọc các đường dẫn khớp.
permissions.<name>.filesystem.glob_scan_max_depth number Độ sâu tối đa để mở rộng các mẫu glob từ chối đọc trên những nền tảng chụp nhanh các kết quả khớp trước khi khởi động môi trường cô lập. Nếu đặt, phải ít nhất là 1.
permissions.<name>.network.allow_local_binding boolean Cho phép truy cập mạng cục bộ/riêng rộng hơn thông qua kết nối mạng trong môi trường cô lập. Các quy tắc cho phép với địa chỉ IP cục bộ chính xác hoặc localhost vẫn có thể cho phép các đích cục bộ cụ thể khi thiết lập này giữ ở false.
permissions.<name>.network.allow_upstream_proxy boolean Cho phép kết nối mạng trong môi trường cô lập nối tiếp qua một proxy thượng nguồn khác.
permissions.<name>.network.dangerously_allow_all_unix_sockets boolean Cho phép các đích Unix socket tùy ý thay vì tập hợp giới hạn mặc định. Chỉ sử dụng trong môi trường được kiểm soát chặt chẽ.
permissions.<name>.network.dangerously_allow_non_loopback_proxy boolean Cho phép các trình lắng nghe mạng trong môi trường cô lập liên kết với địa chỉ ngoài loopback. Bật thiết lập này có thể khiến các trình lắng nghe có thể được truy cập từ bên ngoài localhost.
permissions.<name>.network.domains table Các quy tắc miền cho lệnh trong môi trường cô lập. Chỉ được thực thi khi features.network_proxy hoặc các yêu cầu mạng do quản trị viên quản lý đã bật kích hoạt proxy. Hỗ trợ tên máy chủ chính xác, *.example.com, **.example.com và các quy tắc cho phép toàn cục *; deny được ưu tiên. Không hạn chế tìm kiếm web, ứng dụng hoặc MCP server.
permissions.<name>.network.domains.<pattern> allow | deny Cho phép hoặc từ chối một tên máy chủ chính xác hoặc mẫu ký tự đại diện có phạm vi giới hạn như *.example.com hoặc **.example.com.
permissions.<name>.network.enable_socks5 boolean Cung cấp hỗ trợ SOCKS5 khi hồ sơ quyền này bật kết nối mạng trong môi trường cô lập.
permissions.<name>.network.enable_socks5_udp boolean Cho phép UDP qua trình lắng nghe SOCKS5 khi được bật.
permissions.<name>.network.enabled boolean Bật quyền truy cập mạng cho các lệnh trong hồ sơ quyền này. Thiết lập này không khởi động proxy mạng. Nếu không có features.network_proxy hoặc các yêu cầu mạng do quản trị viên quản lý đã bật, lệnh truy cập mạng trực tiếp và các quy tắc miền của hồ sơ không được thực thi.
permissions.<name>.network.mode limited | full Chế độ proxy mạng được sử dụng cho lưu lượng của tiến trình con.
permissions.<name>.network.proxy_url string URL lắng nghe HTTP được sử dụng khi hồ sơ quyền này bật kết nối mạng trong môi trường cô lập.
permissions.<name>.network.socks_url string Điểm cuối proxy SOCKS5 được hồ sơ quyền này sử dụng.
permissions.<name>.network.unix_sockets table Các thiết lập ghi đè danh sách Unix socket được phép cho kết nối mạng trong môi trường cô lập. Sử dụng đường dẫn socket làm khóa; allow thêm một đường dẫn và deny từ chối đường dẫn đó.
permissions.<name>.network.unix_sockets.<path> allow | deny Thêm một đường dẫn Unix socket tuyệt đối vào danh sách cho phép có hiệu lực bằng allow hoặc từ chối bằng deny. Các mục bị từ chối bị loại khỏi danh sách cho phép có hiệu lực.
permissions.<name>.workspace_roots table Các thư mục gốc không gian làm việc do hồ sơ định nghĩa, nhận các quy tắc hệ thống tệp :workspace_roots cùng với các thư mục gốc không gian làm việc lúc chạy của phiên.
permissions.<name>.workspace_roots.<path> boolean Đưa một đường dẫn vào tập hợp thư mục gốc không gian làm việc của hồ sơ khi true. Các mục bị tắt vẫn không hoạt động.
personality none | friendly | pragmatic Phong cách giao tiếp mặc định cho các mô hình công bố hỗ trợ supportsPersonality; có thể ghi đè theo từng luồng/lượt hoặc qua /personality.
plan_mode_reasoning_effort string Ghi đè mức độ suy luận riêng cho chế độ Plan bằng một mức được mô hình đã chọn hỗ trợ. Nếu không đặt, chế độ Plan sử dụng giá trị mặc định được thiết lập sẵn.
plugins.<plugin>.enabled boolean Bật hoặc tắt plugin từ kho cục bộ bằng khóa plugin-name@marketplace-name. Được đọc từ cấu hình hợp nhất có hiệu lực; các thiết lập của dự án đáng tin cậy có thể ghi đè giá trị mặc định của người dùng, do đám mây quản lý và của hệ thống. Việc làm mới kho có thể cài đặt hoặc làm mới các plugin đã cấu hình ngay cả khi chúng bị tắt. Thiết lập này không ghi đè trạng thái bật do không gian làm việc quản lý.
plugins.<plugin>.mcp_servers.<server>.default_tools_approval_mode auto | prompt | writes | approve Hành vi phê duyệt mặc định cho các công cụ trên MCP server do plugin cung cấp.
plugins.<plugin>.mcp_servers.<server>.disabled_tools array<string> Danh sách từ chối được áp dụng sau enabled_tools cho MCP server do plugin cung cấp.
plugins.<plugin>.mcp_servers.<server>.enabled boolean Bật hoặc tắt MCP server đi kèm plugin đã cài đặt mà không thay đổi manifest của plugin.
plugins.<plugin>.mcp_servers.<server>.enabled_tools array<string> Danh sách công cụ được phép cung cấp từ MCP server của plugin.
plugins.<plugin>.mcp_servers.<server>.tools.<tool>.approval_mode auto | prompt | writes | approve Ghi đè hành vi phê duyệt theo từng công cụ MCP do plugin cung cấp.
project_doc_fallback_filenames array<string> Các tên tệp bổ sung cần thử khi thiếu AGENTS.md.
project_doc_max_bytes number Số byte tối đa được đọc từ AGENTS.md khi xây dựng hướng dẫn dự án.
project_root_markers array<string> Danh sách tên tệp đánh dấu thư mục gốc dự án; được sử dụng khi tìm thư mục gốc dự án trong các thư mục cha.
projects.<path>.trust_level string Đánh dấu dự án hoặc worktree là đáng tin cậy hoặc không đáng tin cậy ("trusted" | "untrusted"). Các dự án không đáng tin cậy bỏ qua các lớp .codex/ trong phạm vi dự án, bao gồm cấu hình cục bộ của dự án, hook và quy tắc.
review_model string Tùy chọn ghi đè mô hình cho /review (mặc định là mô hình của phiên hiện tại).
sandbox_mode read-only | workspace-write | danger-full-access Chính sách môi trường cô lập cho quyền truy cập hệ thống tệp và mạng trong quá trình thực thi lệnh.
sandbox_workspace_write.exclude_slash_tmp boolean Loại /tmp khỏi các thư mục gốc có quyền ghi trong chế độ workspace-write.
sandbox_workspace_write.exclude_tmpdir_env_var boolean Loại $TMPDIR khỏi các thư mục gốc có quyền ghi trong chế độ workspace-write.
sandbox_workspace_write.network_access boolean Cho phép truy cập mạng ra ngoài từ bên trong môi trường cô lập workspace-write.
sandbox_workspace_write.writable_roots array<string> Các thư mục gốc có quyền ghi bổ sung khi sandbox_mode = "workspace-write".
service_tier string Cấp dịch vụ ưu tiên cho các lượt mới. Dùng fast hoặc cấp khác mà mô hình đang hoạt động công bố hỗ trợ; fast ánh xạ tới giá trị yêu cầu priority.
shell_environment_policy.exclude array<string> Các mẫu loại trừ biến môi trường cũ. Sử dụng shell_environment_policy.filters cho cấu hình mới; không kết hợp cả hai dạng trong cùng một lớp.
shell_environment_policy.experimental_use_profile boolean Sử dụng hồ sơ shell của người dùng khi tạo tiến trình con.
shell_environment_policy.filters map<string, include | exclude> Các bộ lọc mẫu biến môi trường chuẩn, không phân biệt chữ hoa chữ thường. Các mục đưa vào tạo thành danh sách cho phép và không thể khôi phục các giá trị đã bị loại trừ. Các giá trị set được chỉ định rõ được áp dụng sau khi loại trừ. Không kết hợp bộ lọc với các mảng exclude hoặc include_only cũ trong cùng một lớp.
shell_environment_policy.ignore_default_excludes boolean Giữ các biến chứa KEY, SECRET hoặc TOKEN trước khi chạy những bộ lọc khác (mặc định: true). Đặt thành false để tự động loại trừ theo tên biến bí mật.
shell_environment_policy.include_only array<string> Danh sách cho phép cũ gồm các mẫu biến môi trường. Sử dụng shell_environment_policy.filters cho cấu hình mới; không kết hợp cả hai dạng trong cùng một lớp.
shell_environment_policy.inherit all | core | none Thiết lập cơ sở cho việc kế thừa môi trường khi tạo tiến trình con.
shell_environment_policy.set map<string,string> Các giá trị môi trường được chỉ định rõ, được chèn sau khi loại trừ; các bộ lọc đưa vào vẫn có thể loại bỏ chúng.
show_raw_agent_reasoning boolean Hiển thị nội dung suy luận thô khi mô hình đang hoạt động phát ra nội dung đó.
skills.config array<object> Các thiết lập ghi đè trạng thái bật theo từng Skill, được lưu trong config.toml.
skills.config.<index>.enabled boolean Bật hoặc tắt Skill được tham chiếu.
skills.config.<index>.path string (path) Đường dẫn đến thư mục Skill chứa SKILL.md.
skills.max_context_tokens integer (positive) Ngân sách token cho danh mục skills khả dụng. Mặc định là 2% cửa sổ ngữ cảnh của mô hình. Các giá trị đặt rõ bị giới hạn ở 10000 token.
sqlite_home string (path) Thư mục nơi Codex lưu cơ sở dữ liệu trạng thái dựa trên SQLite, được sử dụng cho các tác vụ của tác nhân và trạng thái thời gian chạy khác có thể tiếp tục.
suppress_unstable_features_warning boolean Ẩn cảnh báo xuất hiện khi bật các cờ tính năng đang được phát triển.
tool_output_token_limit number Ngân sách token để lưu từng đầu ra công cụ/hàm trong lịch sử.
tool_suggest.disabled_tools array<table> Tắt đề xuất cho các trình kết nối hoặc plugin cụ thể có thể khám phá. Mỗi mục sử dụng type = "connector" hoặc "plugin" cùng một id.
tool_suggest.discoverables array<table> Cho phép công cụ đề xuất thêm các trình kết nối hoặc plugin có thể khám phá. Mỗi mục sử dụng type = "connector" hoặc "plugin" cùng một id.
tools.view_image boolean Bật công cụ đính kèm ảnh cục bộ view_image.
tools.web_search boolean | { context_size = "low|medium|high", allowed_domains = [string], location = { country, region, city, timezone } } Cấu hình tùy chọn cho công cụ tìm kiếm web. Dạng đối tượng có thể đặt kích thước ngữ cảnh tìm kiếm, các miền tìm kiếm được phép và vị trí gần đúng của người dùng. Các bộ lọc miền tìm kiếm này tách biệt với các quy tắc miền mạng cho lệnh trong môi trường cô lập và không hạn chế trình kết nối hoặc MCP server.
tui table Các tùy chọn dành riêng cho TUI, chẳng hạn như bật thông báo trên máy tính trực tiếp trong giao diện.
tui.alternate_screen auto | always | never Kiểm soát việc sử dụng màn hình thay thế cho TUI (mặc định: auto; auto bỏ qua màn hình này trong Zellij để giữ lịch sử cuộn).
tui.animations boolean Bật hiệu ứng động trong terminal (màn hình chào mừng, hiệu ứng lấp lánh, biểu tượng xoay) (mặc định: true).
tui.keymap.<context>.<action> string | array<string> Gán phím tắt cho một hành động TUI. Các ngữ cảnh được hỗ trợ gồm global, chat, composer, editor, vim_normal, vim_operator, vim_text_object, pager, list và approval. Một số hành động của trình soạn thảo dùng các phím tắt tui.keymap.global tương ứng làm phương án dự phòng; các phím tắt riêng cho ngữ cảnh được ưu tiên khi được hỗ trợ.
tui.keymap.<context>.<action> = [] empty array Hủy gán phím cho hành động trong ngữ cảnh sơ đồ phím đó. Tên phím sử dụng các chuỗi chuẩn hóa như ctrl-a, shift-enter, page-down hoặc minus.
tui.model_availability_nux.<model> integer Trạng thái nội bộ của chú giải khởi động, lấy slug mô hình làm khóa.
tui.notification_condition unfocused | always Kiểm soát việc thông báo TUI chỉ được gửi khi terminal không có tiêu điểm hay được gửi bất kể trạng thái tiêu điểm. Mặc định là unfocused.
tui.notification_method auto | osc9 | bel Phương thức gửi thông báo terminal (mặc định: auto).
tui.notifications boolean | array<string> Bật thông báo TUI; có thể giới hạn theo các loại sự kiện cụ thể.
tui.raw_output_mode boolean Khởi động TUI ở chế độ lịch sử cuộn thô để dễ chọn và sao chép nội dung trong terminal (mặc định: false). Bạn có thể chuyển đổi bằng /raw hoặc phím tắt mặc định alt-r.
tui.resume_cwd current | session Thư mục làm việc cần dùng khi tiếp tục hoặc tạo nhánh từ một phiên. Nếu không đặt, Codex yêu cầu bạn chọn khi thư mục hiện tại khác với thư mục đã lưu của phiên.
tui.show_tooltips boolean Hiển thị chú giải hướng dẫn ban đầu trên màn hình chào mừng TUI (mặc định: true).
tui.status_line array<string> | null Danh sách có thứ tự các mã định danh mục trên dòng trạng thái ở chân TUI. null tắt dòng trạng thái.
tui.terminal_title array<string> | null Danh sách có thứ tự các mã định danh mục trong tiêu đề cửa sổ/tab terminal. Mặc định là ["spinner", "project"]; null tắt cập nhật tiêu đề.
tui.theme string Ghi đè chủ đề tô sáng cú pháp (tên chủ đề dạng kebab-case).
tui.vim_mode_default boolean Khởi động trình soạn thảo ở chế độ thường của Vim thay vì chế độ chèn (mặc định: false). Bạn vẫn có thể chuyển đổi theo từng phiên bằng /vim.
web_search disabled | cached | indexed | live Chế độ tìm kiếm web (mặc định: "cached"; cached sử dụng chỉ mục do OpenAI duy trì mà không truy cập web bên ngoài; indexed chỉ cho phép truy cập bên ngoài khi được chỉ mục tìm kiếm cho phép; nếu bạn sử dụng --yolo hoặc một thiết lập môi trường cô lập khác có toàn quyền truy cập, giá trị mặc định là "live"). Sử dụng "live" để truy xuất trực tiếp không hạn chế hoặc "disabled" để loại bỏ công cụ.
windows_wsl_setup_acknowledged boolean Theo dõi việc xác nhận hướng dẫn ban đầu trên Windows (chỉ dành cho Windows).
windows.sandbox unelevated | elevated | mxc Chế độ môi trường cô lập gốc chỉ dành cho Windows khi chạy Codex trực tiếp trên Windows.

Bạn có thể xem JSON schema mới nhất cho config.toml tại đây.

Để nhận gợi ý tự động hoàn thành và thông tin chẩn đoán khi chỉnh sửa config.toml trong VS Code hoặc Cursor, bạn có thể cài đặt tiện ích Even Better TOML và thêm dòng này vào đầu config.toml:

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

Lưu ý: Đổi tên experimental_instructions_file thành model_instructions_file. Codex đã ngừng khuyến nghị khóa cũ; hãy cập nhật các cấu hình hiện có sang tên mới.

requirements.toml

requirements.toml là tệp cấu hình do quản trị viên thực thi, dùng để áp đặt giới hạn đối với các thiết lập nhạy cảm về bảo mật mà người dùng không thể ghi đè. Để biết chi tiết, vị trí và ví dụ, hãy xem Yêu cầu do quản trị viên thực thi.

Đối với người dùng ChatGPT Business và Enterprise, Codex cũng có thể áp dụng các yêu cầu được tải từ đám mây. Hãy xem trang bảo mật để biết chi tiết về thứ tự ưu tiên.

Sử dụng [features] trong requirements.toml để cố định các cờ tính năng thời gian chạy theo cùng các khóa chuẩn mà config.toml sử dụng. Yêu cầu cũng có thể bao gồm các khóa chỉ dành cho ứng dụng đã được ghi trong tài liệu, vốn không thuộc config.toml. Các khóa bị bỏ qua sẽ không bị ràng buộc.

Một số yêu cầu được quản lý thực thi một giá trị cấu hình chính xác thay vì một danh sách cho phép. Người dùng không thể ghi đè đường dẫn, tùy chọn cập nhật, chính sách login shell, thiết lập phản hồi hoặc thiết lập màn hình riêng tư trên Windows đã được thực thi.

Danh sách hồ sơ quyền được quản lý yêu cầu Codex 0.138.0 trở lên. Codex 0.137.0 trở về trước bỏ qua allowed_permission_profiles và default_permissions được quản lý.

Sử dụng allowed_sandbox_modes cùng với sandbox_mode. Đối với các bản triển khai hồ sơ quyền, hãy sử dụng allowed_permission_profiles cùng với default_permissions được quản lý.

Một mục untrusted trong allowed_approval_policies vẫn hợp lệ đối với cơ chế phê duyệt nghiêm ngặt hơn mà Codex suy ra khi một dự án sử dụng trust_level = "untrusted". Mục này không cho phép thiết lập tường minh approval_policy = "untrusted".

Bảng [models.new_thread] cung cấp các giá trị mặc định được quản lý, không áp đặt bắt buộc. Nếu bạn ghi đè tường minh mô hình hoặc mức độ suy luận bằng --model, --config hoặc --profile, Codex bỏ qua cả model và model_reasoning_effort trong [models.new_thread]. service_tier hoạt động độc lập.

Các yêu cầu về trình duyệt áp dụng cho ba bề mặt riêng biệt. in_app_browser kiểm soát ngăn trình duyệt mà người dùng trực tiếp mở và sử dụng. browser_use kiểm soát công việc do tác nhân thực hiện trong trình duyệt. computer_use kiểm soát công việc do tác nhân thực hiện trong các ứng dụng desktop gốc.

Các giá trị chính sách Browser Use và Computer Use lồng nhau không tự cấp quyền truy cập. Một giá trị allow dành riêng cho origin hoặc ứng dụng có thể ghi đè phương án dự phòng của cùng một nguồn chính sách, nhưng các bước kiểm tra thông thường về tính năng, phê duyệt và những chính sách khác vẫn được áp dụng. Khi cả yêu cầu được quản lý và config.toml đều có hiệu lực, giá trị deny từ một trong hai nguồn sẽ được ưu tiên.

Khóa Loại / giá trị Chi tiết
additional_developer_instructions string Chỉ dẫn dành cho nhà phát triển được quản lý, được thêm dưới dạng một thông điệp nhà phát triển riêng. Codex từ chối các chỉ dẫn vượt quá giới hạn ước tính 10.000 token, bao gồm cả dấu đánh dấu ngữ cảnh.
allow_appshots boolean Đặt thành false để vô hiệu hóa Appshots cho người dùng được quản lý. Nếu bỏ qua, Appshots không bị các yêu cầu này ràng buộc và tuân theo điều kiện khả dụng thông thường của sản phẩm.
allow_browser_and_computer_use boolean Đặt thành false để chặn cả Browser Use do tác nhân điều khiển và Computer Use trên ứng dụng gốc. Đặt thành true hoặc bỏ qua không bật tính năng nào trong hai tính năng này; các bước kiểm tra tính năng, chính sách và phê duyệt còn lại vẫn áp dụng.
allow_login_shell boolean Ấn định việc các công cụ shell có thể khởi động shell đăng nhập hay không.
allow_managed_hooks_only boolean Khi là true, Codex bỏ qua hook của người dùng, dự án, phiên và plugin, đồng thời vẫn cho phép các hook được quản lý từ requirements.toml và các lớp cấu hình được quản lý khác.
allow_remote_control boolean Đặt thành false để vô hiệu hóa điều khiển thiết bị từ xa cho người dùng được quản lý. Nếu bỏ qua, điều khiển thiết bị từ xa không bị các yêu cầu này ràng buộc và tuân theo điều kiện khả dụng thông thường của sản phẩm.
allowed_approval_policies array<string> Các chính sách phê duyệt được phép, chẳng hạn như on-request, never và granular. Thêm untrusted để cho phép chính sách nghiêm ngặt hơn được suy ra từ một dự án không đáng tin cậy; không thể chọn trực tiếp chính sách này bằng approval_policy.
allowed_approvals_reviewers array<string> Các giá trị được phép cho approvals_reviewer, chẳng hạn như user và auto_review.
allowed_chatgpt_workspaces array<string> Giới hạn đăng nhập ChatGPT, bao gồm token truy cập Codex, ở các ID không gian làm việc được liệt kê. Danh sách trống sẽ vô hiệu hóa đăng nhập ChatGPT; xác thực API vẫn khả dụng khi được phép. Thiết lập qua tệp yêu cầu hệ thống cục bộ hoặc macOS MDM; các giá trị được quản lý trên đám mây sẽ bị bỏ qua.
allowed_login_methods array<string> Cho phép chatgpt, api hoặc cả hai. Nếu bỏ qua, cài đặt này không hạn chế phương thức đăng nhập. Nếu được đặt, danh sách phải chứa ít nhất một phương thức. api cho phép xác thực API, bao gồm Amazon Bedrock. Thiết lập qua tệp yêu cầu hệ thống cục bộ hoặc macOS MDM. Các giá trị được quản lý trên đám mây sẽ bị bỏ qua.
allowed_permission_profiles table<boolean> Danh sách đầy đủ các hồ sơ quyền được phép. Hồ sơ được đặt thành true sẽ được phép. Hồ sơ bị bỏ qua hoặc được đặt thành false sẽ bị từ chối, bao gồm cả hồ sơ được thêm trong các phiên bản tương lai. Khi kết hợp các nguồn yêu cầu, các mục được đối chiếu theo tên hồ sơ.
allowed_permission_profiles.<name> boolean Cho phép hoặc từ chối một hồ sơ quyền tích hợp sẵn hoặc tùy chỉnh được định nghĩa trong cấu hình hay nguồn yêu cầu đã nạp. Nguồn yêu cầu xuất hiện sau và có độ ưu tiên cao hơn có thể dùng false để tắt một hồ sơ được nguồn trước đó có độ ưu tiên thấp hơn cho phép.
allowed_sandbox_modes array<string> Các giá trị được phép cho sandbox_mode.
allowed_web_search_modes array<string> Các giá trị được phép cho web_search (disabled, cached, indexed, live). disabled luôn được phép; danh sách trống trên thực tế chỉ cho phép disabled.
apps table Các yêu cầu ứng dụng được quản lý, dùng mã định danh ứng dụng làm khóa. Yêu cầu có thể vô hiệu hóa ứng dụng hoặc ràng buộc hành vi phê duyệt cho từng công cụ.
apps.<id>.enabled boolean Đặt thành false để vô hiệu hóa ứng dụng. Yêu cầu vô hiệu hóa vẫn giữ tác dụng hạn chế khi hợp nhất nhiều nguồn yêu cầu.
apps.<id>.tools.<tool>.approval_mode auto | prompt | writes | approve Đặt chế độ phê duyệt được quản lý cho một công cụ của ứng dụng.
auto_review table Các yêu cầu được quản lý cho quy trình rà soát tự động.
auto_review.ignore_rules array<string> Các slug mô hình đầy đủ mà Codex sẽ bỏ qua quy tắc tiền tố allow trong chính sách thực thi lệnh. Phải khớp chính xác slug, bao gồm không gian tên của nhà cung cấp nếu có; khác với required_on_models, cài đặt này không chấp nhận bí danh không có không gian tên. Các quy tắc từ chối và mạng vẫn được áp dụng.
auto_review.required_on_models array<string> Các slug mô hình bắt buộc phải dùng quy trình rà soát tự động. Slug không được để trống, phải bỏ không gian tên của nhà cung cấp và không có khoảng trắng ở đầu hoặc cuối. Danh sách từ nhiều nguồn yêu cầu sẽ được kết hợp.
browser_use table Các yêu cầu được quản lý cho Browser Use do tác nhân điều khiển.
browser_use.allow_global_persistent_approval boolean Đặt thành false để ngăn Browser Use tạo hoặc áp dụng các phê duyệt Always allow bao trùm mọi trang web, chẳng hạn như cho phép tải xuống từ bất kỳ trang web nào. Các phê duyệt đã lưu sẽ bị bỏ qua, không bị xóa. Đặt thành true hoặc bỏ qua không tạo ra phê duyệt.
browser_use.allow_history_access boolean Đặt thành false để ngăn Browser Use đọc lịch sử trình duyệt. Đặt thành true hoặc bỏ qua sẽ giữ nguyên các cài đặt lịch sử và bước kiểm tra điều kiện khả dụng thông thường.
browser_use.default_origin_policy table Giá trị dự phòng cho từng cài đặt Browser Use khi không có mục khớp nào trong browser_use.origins định nghĩa cài đặt đó. Quy tắc nguồn gốc khớp sẽ thay thế giá trị dự phòng của nguồn chính sách đó. Sau đó, Codex áp dụng kết quả nghiêm ngặt hơn giữa các yêu cầu được quản lý và cấu hình người dùng.
browser_use.default_origin_policy.access allow | deny Sử dụng deny để chặn Browser Use trên các nguồn gốc sử dụng giá trị dự phòng. Nguồn gốc bị từ chối cũng chặn việc tải lên, tải xuống, quyền truy cập gỡ lỗi trình duyệt đầy đủ và rà soát tự động tại đó. allow chỉ cho phép tiếp tục các bước kiểm tra phê duyệt và chính sách thông thường.
browser_use.default_origin_policy.access_approval_lifetime turn | thread Đặt thời gian hiệu lực của phê duyệt truy cập trang web không được lưu lâu dài: turn giới hạn trong lượt hiện tại, còn thread giữ phê duyệt trong phần còn lại của luồng hiện tại. persistent_approval kiểm soát riêng việc Always allow có khả dụng hay không. Giá trị mặc định của sản phẩm là thread.
browser_use.default_origin_policy.auto_review allow | deny Sử dụng deny để bỏ qua rà soát tự động trên các nguồn gốc sử dụng giá trị dự phòng và thay vào đó yêu cầu người dùng phê duyệt. allow giữ khả năng rà soát tự động khi các cài đặt khác cho phép.
browser_use.default_origin_policy.downloads allow | deny Sử dụng deny để chặn Browser Use tải xuống trên các nguồn gốc sử dụng giá trị dự phòng. allow chỉ cho phép tiếp tục các bước kiểm tra phê duyệt và chính sách thông thường.
browser_use.default_origin_policy.full_cdp_access allow | deny Sử dụng deny để chặn quyền truy cập đầy đủ Chrome DevTools Protocol (CDP) trên các nguồn gốc sử dụng giá trị dự phòng. allow chỉ cho phép tiếp tục các bước kiểm tra chủ động bật và phê duyệt thông thường.
browser_use.default_origin_policy.persistent_approval boolean Đặt thành false để ngăn Browser Use lưu hoặc áp dụng phê duyệt Always allow trên các nguồn gốc sử dụng giá trị dự phòng. Phê duyệt cho lượt hoặc luồng hiện tại vẫn có thể được áp dụng. true làm cho Always allow khả dụng khi các điều kiện khác cho phép nhưng không tạo ra phê duyệt.
browser_use.default_origin_policy.uploads allow | deny Sử dụng deny để chặn Browser Use tải lên trên các nguồn gốc sử dụng giá trị dự phòng. allow chỉ cho phép tiếp tục các bước kiểm tra phê duyệt và chính sách thông thường.
browser_use.disable_auto_review boolean Đặt thành true để bỏ qua quy trình rà soát tự động cho Browser Use và thay vào đó yêu cầu người dùng phê duyệt. Đặt thành false hoặc bỏ qua sẽ giữ khả năng rà soát tự động khi các cài đặt khác cho phép.
browser_use.origins map<string, table> Các chính sách Browser Use riêng cho từng nguồn gốc. Khóa sử dụng &lt;scheme&gt;://&lt;host-pattern&gt;[:&lt;port&gt;] với http hoặc https. Sử dụng tên máy chủ chính xác, *.example.com chỉ cho các tên miền phụ hoặc **.example.com cho tên miền gốc và các tên miền phụ. Các ký tự đại diện * khác có thể khớp qua dấu chấm, vì vậy region*.example.com cũng khớp với region.api.example.com; tên máy chủ * khớp với mọi máy chủ của lược đồ đó. Lược đồ và cổng không mặc định có ý nghĩa khi đối chiếu; các cổng mặc định được ghi rõ sẽ bị loại bỏ khi chuẩn hóa. Đường dẫn, truy vấn, tên người dùng hoặc mật khẩu nhúng, và ký tự đại diện trong lược đồ hoặc cổng đều không hợp lệ. Đặt mẫu trong dấu ngoặc kép ở TOML, ví dụ [browser_use.origins."https://**.example.com"].
browser_use.origins.<pattern> table Chính sách cho các nguồn gốc khớp với mẫu này. Nếu nhiều mẫu cùng khớp, Codex sử dụng giá trị hạn chế nhất cho từng khả năng: deny được ưu tiên hơn allow, false hơn true và turn hơn thread.
browser_use.origins.<pattern>.access allow | deny Sử dụng deny để chặn Browser Use trên các nguồn gốc khớp. Việc từ chối cũng chặn tải lên, tải xuống, quyền truy cập gỡ lỗi trình duyệt đầy đủ và rà soát tự động tại đó. allow chỉ cho phép tiếp tục các bước kiểm tra phê duyệt và chính sách thông thường.
browser_use.origins.<pattern>.access_approval_lifetime turn | thread Đặt thời gian hiệu lực của phê duyệt truy cập trang web không được lưu lâu dài cho các nguồn gốc khớp: turn giới hạn trong lượt hiện tại, còn thread giữ phê duyệt trong phần còn lại của luồng hiện tại. persistent_approval kiểm soát riêng việc Always allow có khả dụng hay không.
browser_use.origins.<pattern>.auto_review allow | deny Sử dụng deny để bỏ qua rà soát tự động trên các nguồn gốc khớp và thay vào đó yêu cầu người dùng phê duyệt. allow giữ khả năng rà soát tự động khi các cài đặt khác cho phép.
browser_use.origins.<pattern>.downloads allow | deny Sử dụng deny để chặn Browser Use tải xuống trên các nguồn gốc khớp. allow chỉ cho phép tiếp tục các bước kiểm tra phê duyệt và chính sách thông thường.
browser_use.origins.<pattern>.full_cdp_access allow | deny Sử dụng deny để chặn quyền truy cập đầy đủ Chrome DevTools Protocol (CDP) trên các nguồn gốc khớp. allow chỉ cho phép tiếp tục các bước kiểm tra chủ động bật và phê duyệt thông thường.
browser_use.origins.<pattern>.persistent_approval boolean Đặt thành false để ngăn Browser Use lưu hoặc áp dụng phê duyệt Always allow trên các nguồn gốc khớp. Phê duyệt cho lượt hoặc luồng hiện tại vẫn có thể được áp dụng. true làm cho Always allow khả dụng khi các điều kiện khác cho phép nhưng không tạo ra phê duyệt.
browser_use.origins.<pattern>.uploads allow | deny Sử dụng deny để chặn Browser Use tải lên trên các nguồn gốc khớp. allow chỉ cho phép tiếp tục các bước kiểm tra phê duyệt và chính sách thông thường.
chatgpt_base_url string Ấn định URL cơ sở của dịch vụ ChatGPT trước khi xác thực và truy xuất chính sách đám mây. Cài đặt này không cấu hình mọi đích mạng của Codex. Thiết lập qua tệp yêu cầu hệ thống cục bộ hoặc macOS MDM; các giá trị được quản lý trên đám mây sẽ bị bỏ qua.
check_for_update_on_startup boolean Ấn định việc Codex có kiểm tra bản cập nhật khi khởi động hay không.
cli_auth_credentials_store file | keyring | auto | ephemeral Ấn định kho thông tin xác thực CLI trước khi nạp cơ chế xác thực. file sử dụng CODEX_HOME/auth.json; keyring yêu cầu kho thông tin xác thực của hệ điều hành; auto chuyển sang dùng tệp nếu kho thông tin xác thực không khả dụng; ephemeral giữ thông tin xác thực trong bộ nhớ cho tiến trình hiện tại. Thiết lập qua tệp yêu cầu hệ thống cục bộ hoặc macOS MDM; các giá trị được quản lý trên đám mây sẽ bị bỏ qua.
computer_use table Các yêu cầu được quản lý cho công việc do tác nhân thực hiện trong ứng dụng gốc trên máy tính. Cả quy tắc ứng dụng được quản lý lẫn quy tắc ứng dụng config.toml đều được thực thi; ứng dụng phải được từng nguồn chính sách cho phép.
computer_use.allow_locked_computer_use boolean Đặt thành false để ngăn người dùng bật Locked Use trên thiết bị macOS được quản lý. Yêu cầu này loại bỏ các điều khiển bật tính năng; nó không tắt Locked Use nếu tính năng đã được bật. Nếu bỏ qua, điều kiện khả dụng thông thường của sản phẩm sẽ áp dụng.
computer_use.allow_persistent_approval boolean Đặt thành false để loại bỏ tùy chọn lưu phê duyệt ứng dụng qua nhiều phiên. Phê duyệt cho phiên hiện tại vẫn khả dụng. Đặt thành true hoặc bỏ qua không phê duyệt ứng dụng.
computer_use.default_app_access allow | deny Quyền truy cập dự phòng cho các ứng dụng gốc không khớp với quy tắc riêng của nền tảng. deny chặn truy cập. allow chỉ cho phép tiếp tục các bước kiểm tra phê duyệt và chính sách thông thường. Giá trị mặc định của sản phẩm là allow.
computer_use.macos table Các quy tắc ứng dụng Computer Use cho macOS.
computer_use.macos.bundle_ids map<string, allow | deny> Ánh xạ chính xác các mã định danh gói macOS sang allow hoặc deny. Quy tắc khớp sẽ thay thế computer_use.default_app_access trong cùng nguồn chính sách. Việc từ chối từ yêu cầu được quản lý hoặc cấu hình người dùng vẫn chặn truy cập.
computer_use.macos.bundle_ids.<bundle-id> allow | deny Sử dụng deny để chặn đúng mã định danh gói đó. allow chỉ ghi đè giá trị mặc định của nguồn chính sách này và vẫn yêu cầu mọi nguồn chính sách khác cùng quy trình phê duyệt thông thường cho phép ứng dụng.
computer_use.windows table Các quy tắc ứng dụng Computer Use cho ứng dụng Windows được đóng gói và không được đóng gói.
computer_use.windows.aumids map<string, allow | deny> Ánh xạ chính xác các Application User Model ID (AUMID) đã đăng ký của ứng dụng đóng gói có chữ ký sang allow hoặc deny. Quy tắc khớp sẽ thay thế computer_use.default_app_access trong cùng nguồn chính sách.
computer_use.windows.aumids.<aumid> allow | deny Sử dụng deny để chặn đúng danh tính ứng dụng đóng gói đó. allow chỉ ghi đè giá trị mặc định của nguồn chính sách này và vẫn yêu cầu mọi nguồn chính sách khác cùng quy trình phê duyệt thông thường cho phép ứng dụng.
computer_use.windows.exes array<table> Các quy tắc cho tệp thực thi Windows có chữ ký và không được đóng gói. Quy tắc đối chiếu nhà phát hành đã xác minh và thông tin phiên bản có chữ ký của tệp thực thi, không đối chiếu đường dẫn hay tên tệp hiện tại. Quy tắc từ chối khớp được ưu tiên hơn các quy tắc cho phép khớp. Tệp thực thi không có chữ ký sử dụng computer_use.default_app_access; tệp thực thi có danh tính chữ ký không thể xác minh rõ ràng sẽ bị chặn.
computer_use.windows.exes[].access allow | deny Quyết định truy cập bắt buộc cho các tệp thực thi khớp. deny chặn truy cập. allow chỉ ghi đè giá trị mặc định của nguồn chính sách này và vẫn yêu cầu mọi nguồn chính sách khác cùng quy trình phê duyệt thông thường cho phép ứng dụng.
computer_use.windows.exes[].binary_name string Giá trị OriginalFilename tùy chọn từ thông tin phiên bản có chữ ký của tệp thực thi. Việc đối chiếu không phân biệt chữ hoa chữ thường. Nếu quy tắc khớp về nhà phát hành và sản phẩm yêu cầu giá trị này nhưng tệp thực thi không cung cấp, Computer Use sẽ chặn tệp thực thi.
computer_use.windows.exes[].product_name string Giá trị ProductName chính xác bắt buộc phải có từ thông tin phiên bản có chữ ký của tệp thực thi.
computer_use.windows.exes[].publisher_name string Tên nhà phát hành chính xác bắt buộc phải có từ chứng chỉ ký đáng tin cậy của tệp thực thi, được định dạng dưới dạng tên phân biệt X.500 của Windows.
default_permissions string Hồ sơ quyền mặc định được quản lý. Hồ sơ phải được allowed_permission_profiles cho phép. Hãy đặt rõ giá trị này để hành vi có thể dự đoán được; nếu bỏ qua, Codex chỉ mặc định dùng :workspace khi cả :workspace và :read-only đều được cho phép rõ ràng.
enforce_residency string Yêu cầu lưu lượng dịch vụ Codex sử dụng một khu vực lưu trú dữ liệu được hỗ trợ. Hiện chấp nhận us.
experimental_network table Các yêu cầu mạng do quản trị viên quản lý cho lệnh cục bộ chạy trong môi trường cô lập, được thực thi từ requirements.toml. Khi được bật, các yêu cầu này có thể khởi động proxy mạng cho lệnh mà không cần features.network_proxy. Các công cụ trình duyệt kiểm tra riêng các quy tắc từ chối mạng và danh sách cho phép độc quyền được quản lý. Những yêu cầu này không định tuyến lưu lượng trình duyệt qua proxy hay kiểm soát tìm kiếm web, ứng dụng, MCP server, lưu lượng ứng dụng gốc hoặc lưu lượng riêng của các khả năng khác. Trên các luồng xử lý Codex Cloud được quản lý có hỗ trợ, những yêu cầu này ràng buộc kết nối mạng của lệnh cùng với các cài đặt internet riêng của môi trường Cloud. Việc nâng quyền vượt toàn bộ môi trường cô lập đã được phê duyệt có thể bỏ qua proxy lệnh khi chính sách cho phép. Work Cloud không kế thừa những yêu cầu này.
experimental_network.allow_local_binding boolean Cho phép quyền truy cập mạng cục bộ/riêng rộng hơn đối với kết nối mạng trong môi trường cô lập. Trên luồng proxy Codex Cloud được hỗ trợ, giá trị false được đặt rõ ràng có thể ngăn truy cập proxy thượng nguồn ngay cả khi tên miền được cho phép. Giá trị chỉ mặc định là true nếu không có yêu cầu áp dụng, hồ sơ mạng được chọn hoặc cài đặt tính năng proxy nào cung cấp giá trị. Giá trị false được kế thừa vẫn được coi là tường minh. Giá trị ghi đè Cloud có độ ưu tiên cao hơn và được hỗ trợ có thể thay đổi giá trị này mà không mở rộng Global cho Local hoặc thêm mục Allow cho tên miền. Hãy xác minh khả năng hỗ trợ của trình thực thi. Không áp dụng giá trị mặc định Cloud này cho Local.
experimental_network.allow_upstream_proxy boolean Cho phép kết nối mạng trong môi trường cô lập đi nối tiếp qua proxy thượng nguồn từ môi trường.
experimental_network.allowed_domains array<string> Các quy tắc cho phép của quản trị viên đối với kết nối mạng của lệnh trong môi trường cô lập khi proxy mạng được quản lý đang bật. Những quy tắc này không áp dụng cho tìm kiếm web, ứng dụng hoặc MCP server. Không kết hợp cài đặt này với experimental_network.domains.
experimental_network.dangerously_allow_all_unix_sockets boolean Cho phép các đích Unix socket bất kỳ thay vì chỉ truy cập các đích trong danh sách cho phép. Chỉ sử dụng trong môi trường được kiểm soát chặt chẽ.
experimental_network.dangerously_allow_non_loopback_proxy boolean Cho phép địa chỉ lắng nghe không phải loopback cho các yêu cầu [experimental_network]. Bật cài đặt này có thể khiến các bộ lắng nghe có thể được truy cập từ bên ngoài localhost.
experimental_network.denied_domains array<string> Các quy tắc từ chối của quản trị viên ở dạng danh sách cho kết nối mạng trong môi trường cô lập. Không kết hợp cài đặt này với experimental_network.domains.
experimental_network.domains map<string, allow | deny> Chính sách tên miền của quản trị viên ở dạng ánh xạ cho kết nối mạng trong môi trường cô lập. Hỗ trợ tên máy chủ chính xác, *.example.com chỉ cho tên miền phụ, **.example.com cho tên miền gốc cùng các tên miền phụ và quy tắc cho phép * toàn cục. Ưu tiên quy tắc có phạm vi giới hạn vì * mở rộng quyền truy cập ra mạng công cộng. Quy tắc môi trường có thể thay thế cùng khóa tên miền Global trong một chính sách. Giá trị có độ ưu tiên cao hơn thay thế cùng khóa, trong khi các khóa kế thừa khác được giữ lại. Sau khi kết hợp, một deny khớp khác, bao gồm ký tự đại diện được kế thừa, vẫn chặn yêu cầu. Ánh xạ môi trường trống không xóa các quy tắc Global. Hãy xác minh khả năng hỗ trợ của trình thực thi. Không kết hợp cài đặt này với experimental_network.allowed_domains hoặc experimental_network.denied_domains.
experimental_network.domains.<pattern> allow | deny Cho phép hoặc từ chối truy cập mạng trong môi trường cô lập đối với mẫu tên miền khớp. Quy tắc từ chối được ưu tiên khi nhiều mẫu cùng khớp.
experimental_network.enabled boolean Bật các yêu cầu kết nối mạng trong môi trường cô lập. Cài đặt này không cấp quyền truy cập mạng khi môi trường cô lập đang hoạt động tắt kết nối mạng của lệnh.
experimental_network.http_port integer Cổng lắng nghe HTTP trên địa chỉ loopback dùng cho các yêu cầu [experimental_network].
experimental_network.managed_allowed_domains_only boolean Khi các yêu cầu kết nối mạng được bật và giá trị này là true, cấu hình người dùng thông thường và phê duyệt theo từng tên miền không thể mở rộng danh sách cho phép của proxy được quản lý. Nếu không có mục Allow được cấu hình hoặc kế thừa nào có hiệu lực, các lệnh được quản lý thông thường sẽ không có đích nào được phép. Chính sách chỉ có quy tắc từ chối không cho phép truy cập phần còn lại của internet. Cài đặt này không bao phủ mọi công cụ hoặc việc nâng quyền vượt toàn bộ môi trường cô lập đã được phê duyệt.
experimental_network.socks_port integer Cổng lắng nghe SOCKS5 trên địa chỉ loopback dùng cho các yêu cầu [experimental_network].
experimental_network.unix_sockets map<string, allow | deny> Danh sách Unix socket được quản trị viên cho phép đối với kết nối mạng trong môi trường cô lập trên macOS. Đường dẫn phải là đường dẫn tuyệt đối.
experimental_network.unix_sockets.<path> allow | deny Trên macOS, allow thêm một đường dẫn Unix socket tuyệt đối vào danh sách cho phép; deny không thêm đường dẫn đó. Mục deny không thể chặn socket khi tùy chọn cho phép mọi Unix socket được bật.
features table Các giá trị tính năng được cố định. Sử dụng tên chuẩn từ config.toml cho các tính năng thời gian chạy; các khóa yêu cầu chỉ dành cho ứng dụng đã được ghi trong tài liệu cũng được hỗ trợ tại đây.
features.<name> boolean Yêu cầu một tính năng thời gian chạy hoặc tính năng ứng dụng đã được ghi trong tài liệu luôn bật hoặc tắt.
features.apps boolean Cố định trạng thái bật hoặc tắt tích hợp Apps cho người dùng được quản lý.
features.browser_use boolean Đặt thành false trong requirements.toml để vô hiệu hóa Browser Use do tác nhân điều khiển.
features.browser_use_external boolean Đặt thành false trong requirements.toml để ngăn Codex thao tác trên các trình duyệt được hỗ trợ thông qua tiện ích mở rộng trình duyệt ChatGPT, bao gồm các tab hiện có và phiên đã đăng nhập.
features.browser_use_full_cdp_access boolean Đặt thành false trong requirements.toml để vô hiệu hóa quyền truy cập đầy đủ Chrome DevTools Protocol trong môi trường thời gian chạy cục bộ, bao gồm chế độ Browser Developer, và ngăn ứng dụng ChatGPT dành cho máy tính bật cài đặt tương ứng. Nếu bỏ qua, điều kiện khả dụng thông thường của sản phẩm sẽ áp dụng.
features.computer_use boolean Đặt thành false trong requirements.toml để vô hiệu hóa Computer Use, Record & Replay và các quy trình cài đặt hoặc bật tính năng liên quan.
features.fast_mode boolean Cố định trạng thái bật hoặc tắt tính năng chuẩn fast_mode cho người dùng được quản lý.
features.guardian_approval boolean Cố định trạng thái bật hoặc tắt khả năng phê duyệt Guardian cho người dùng được quản lý.
features.in_app_browser boolean Đặt thành false trong requirements.toml để vô hiệu hóa ngăn trình duyệt tích hợp mà người dùng trực tiếp mở và điều khiển.
features.in_app_chat boolean Đặt thành false để ẩn các màn hình hội thoại ChatGPT và ChatGPT Work cùng giao diện tự động hóa đám mây liên quan trong ứng dụng ChatGPT dành cho máy tính. Cài đặt này không chặn ChatGPT Voice hay dừng các tác vụ đám mây hiện có. Đặt thành true không bỏ qua các bước kiểm tra tài khoản, quyền không gian làm việc hoặc triển khai tính năng.
features.in_app_dictation boolean Đặt thành false để vô hiệu hóa nhập liệu bằng giọng nói trong ứng dụng dành cho máy tính. Đặt thành true không bỏ qua các bước kiểm tra điều kiện khả dụng khác.
features.in_app_local_automation boolean Đặt thành false để vô hiệu hóa các tác vụ được lên lịch cục bộ trong ứng dụng dành cho máy tính. Đặt thành true không bỏ qua các bước kiểm tra điều kiện khả dụng khác.
features.in_app_updates boolean Đặt thành false trong requirements.toml để vô hiệu hóa cập nhật trong ứng dụng. Theo mặc định, cập nhật vẫn được bật khi bỏ qua yêu cầu này.
features.memories boolean Cố định trạng thái bật hoặc tắt Memories cho người dùng được quản lý.
features.multi_agent boolean Cố định trạng thái bật hoặc tắt khả năng đa tác nhân cho người dùng được quản lý.
features.plugin_sharing boolean Đặt thành false trong requirements.toml được quản lý trên đám mây để vô hiệu hóa việc chia sẻ trong không gian làm việc đối với các plugin được xây dựng cục bộ.
features.plugins boolean Cố định trạng thái bật hoặc tắt plugin cho người dùng được quản lý.
features.realtime_conversation boolean Đặt thành false để vô hiệu hóa lệnh thử nghiệm /voice trong Codex CLI. Không dựa vào cài đặt này để chặn ChatGPT Voice trong ứng dụng dành cho máy tính hoặc các phiên giọng nói app-server. Đặt thành true không bỏ qua các bước kiểm tra ứng dụng khách hoặc triển khai tính năng.
features.remote_plugin boolean Cố định trạng thái bật hoặc tắt danh mục plugin từ xa cho người dùng được quản lý.
features.workspace_dependencies boolean Cố định trạng thái bật hoặc tắt môi trường thời gian chạy đi kèm cho các phần phụ thuộc của không gian làm việc đối với người dùng được quản lý.
feedback table Cài đặt phản hồi được quản lý.
feedback.enabled boolean Ấn định việc người dùng có thể gửi phản hồi từ các ứng dụng khách Codex hay không.
guardian_extra_policy string Chính sách Markdown bổ sung được quản lý cho quy trình rà soát tự động, được đưa vào cùng với chính sách chính. Cài đặt này được ưu tiên hơn [auto_review].extra_policy cục bộ. Các giá trị trống sẽ bị bỏ qua.
guardian_policy_config string Chỉ dẫn chính sách Markdown được quản lý cho quy trình rà soát tự động. Cài đặt này được ưu tiên hơn [auto_review].policy cục bộ. Các giá trị trống sẽ bị bỏ qua.
hooks table Các hook vòng đời được quản lý do quản trị viên bắt buộc áp dụng. Yêu cầu một thư mục hook được quản lý và sử dụng cùng lược đồ sự kiện như [hooks] nội tuyến trong config.toml.
hooks.<Event> array<table> Các nhóm đối sánh cho một sự kiện hook như PreToolUse, PermissionRequest, PostToolUse, PreCompact, PostCompact, SessionStart, SessionEnd, SubagentStart, SubagentStop, UserPromptSubmit hoặc Stop.
hooks.<Event>[].hooks array<table> Các trình xử lý hook cho một nhóm đối sánh. Hook lệnh và hook công cụ MCP được hỗ trợ, còn trình xử lý hook prompt và tác nhân được phân tích cú pháp nhưng bị bỏ qua.
hooks.<Event>[].hooks[].additionalContextLimit integer Ngưỡng token gần đúng cho từng trình xử lý để lưu additionalContext quá lớn vào đĩa và hiển thị bản xem trước ngắn hơn cho mô hình. Mặc định là 2500; 0 chuyển toàn bộ ngữ cảnh trực tiếp cho mô hình. Xem Đầu ra hook lớn.
hooks.<Event>[].hooks[].async boolean Chạy hook lệnh ở chế độ nền mà không làm chậm thao tác kích hoạt nó. Mặc định là false; SessionEnd luôn chạy đồng bộ. Xem Chạy hook ở chế độ nền.
hooks.<Event>[].hooks[].commandWindows string Giá trị ghi đè lệnh chỉ dành cho Windows đối với hook lệnh. Bí danh TOML command_windows cũng được chấp nhận.
hooks.managed_dir string (absolute path) Thư mục chứa các tập lệnh hook được quản lý trên macOS và Linux. Codex xác minh rằng đường dẫn là tuyệt đối và thư mục tồn tại trước khi nạp các hook được quản lý.
hooks.windows_managed_dir string (absolute path) Thư mục chứa các tập lệnh hook được quản lý trên Windows. Codex xác minh rằng đường dẫn là tuyệt đối và thư mục tồn tại trước khi nạp các hook được quản lý.
in_app_browser table Các yêu cầu đối với ngăn trình duyệt tích hợp. Những cài đặt này không kiểm soát Browser Use do tác nhân điều khiển.
in_app_browser.allow_external_browser_settings_import boolean Đặt thành false để ngăn người dùng nhập cài đặt hoặc dữ liệu duyệt web từ trình duyệt bên ngoài vào trình duyệt tích hợp. Đặt thành true hoặc bỏ qua sẽ giữ khả năng nhập khi các bước kiểm tra sản phẩm khác cho phép. Đây là cài đặt chỉ dành cho quản lý và không thể ghi đè bằng config.toml.
log_dir string (path) Ấn định thư mục nơi Codex ghi các tệp nhật ký cục bộ.
marketplaces table Các yêu cầu của quản trị viên đối với nguồn chợ plugin. Quy tắc có hiệu lực khi restrict_to_allowed_sources là true.
marketplaces.allowed_sources table Các nguồn chợ được phép, dùng tên quy tắc do quản trị viên chọn làm khóa. Các tên khác nhau được tích lũy qua các lớp yêu cầu; các trường dưới cùng một tên sử dụng thứ tự ưu tiên lớp thông thường.
marketplaces.allowed_sources.<name> table Một quy tắc nguồn được phép. Giá trị source cuối cùng sau khi hợp nhất yêu cầu quyết định những trường ngang hàng nào được Codex diễn giải.
marketplaces.allowed_sources.<name>.host_pattern string Biểu thức chính quy bắt buộc khi source = "host_pattern". Codex đối sánh biểu thức với tên máy chủ viết thường được phân tích từ nguồn Git kiểu HTTPS, SSH hoặc SCP. Sử dụng ^ và $ để yêu cầu khớp toàn bộ tên máy chủ.
marketplaces.allowed_sources.<name>.path string (absolute path) Thư mục chợ cục bộ bắt buộc khi source = "local". Codex yêu cầu đường dẫn tuyệt đối và so sánh đường dẫn sau khi chuẩn hóa.
marketplaces.allowed_sources.<name>.ref string Git ref chính xác tùy chọn cho quy tắc git. Nếu bỏ qua, quy tắc cho phép mọi ref của kho lưu trữ khớp.
marketplaces.allowed_sources.<name>.source git | host_pattern | local Loại bộ đối sánh nguồn chợ. Sử dụng git cho một kho lưu trữ, host_pattern cho các máy chủ Git được đối sánh bằng biểu thức chính quy hoặc local cho một thư mục.
marketplaces.allowed_sources.<name>.url string URL kho lưu trữ Git bắt buộc khi source = "git". Codex chuẩn hóa URL đã cấu hình và URL được phép trước khi yêu cầu kho lưu trữ khớp chính xác.
marketplaces.restrict_to_allowed_sources boolean Khi là true, yêu cầu các nguồn chợ đã cấu hình phải khớp allowed_sources khi thêm chợ, cài đặt plugin, làm mới và nạp lúc chạy. Các danh mục Git do OpenAI tuyển chọn, bao gồm danh mục API key, cũng phải khớp danh sách cho phép. Plugin không gian làm việc đi kèm và được cài đặt từ xa tách biệt với chính sách nguồn Git được tuyển chọn này.
mcp_servers table Danh sách các MCP servers được phép bật. Cả tên máy chủ (&lt;id&gt;) lẫn danh tính của nó phải khớp thì MCP server mới được bật. Bất kỳ MCP server đã cấu hình nào không có trong danh sách cho phép (hoặc có danh tính không khớp) đều bị vô hiệu hóa.
mcp_servers.<id>.identity table Quy tắc danh tính cho một MCP server. Đặt command (stdio) hoặc url (HTTP có khả năng truyền luồng).
mcp_servers.<id>.identity.command string | table Cho phép MCP server stdio theo chuỗi lệnh chính xác, hoặc sử dụng bảng đối sánh để yêu cầu tệp thực thi chính xác và các bộ đối sánh đối số theo thứ tự. Dạng chuỗi không kiểm tra đối số, cwd, env hoặc env_vars.
mcp_servers.<id>.identity.command.args array<table> Các bộ đối sánh đối số theo thứ tự cho máy chủ stdio. Danh sách đối số đã cấu hình phải có cùng độ dài và mọi vị trí đều phải khớp. Bộ đối sánh lệnh không kiểm tra cwd, env hoặc env_vars.
mcp_servers.<id>.identity.command.args[].expression string Biểu thức chính quy được bộ đối sánh đối số regex sử dụng. Biểu thức phải hợp lệ và khớp toàn bộ giá trị đối số.
mcp_servers.<id>.identity.command.args[].match exact | prefix | regex Phép đối sánh cho vị trí đối số này.
mcp_servers.<id>.identity.command.args[].value string Giá trị được bộ đối sánh đối số exact hoặc prefix sử dụng.
mcp_servers.<id>.identity.command.executable string Tệp thực thi mà command đã cấu hình của máy chủ stdio phải khớp chính xác.
mcp_servers.<id>.identity.url string | table Cho phép MCP server HTTP có khả năng truyền luồng theo chuỗi URL chính xác, hoặc sử dụng bảng đối sánh giá trị exact, prefix hoặc regex.
mcp_servers.<id>.identity.url.expression string Biểu thức chính quy được bộ đối sánh URL regex sử dụng. Biểu thức phải hợp lệ và khớp toàn bộ giá trị URL.
mcp_servers.<id>.identity.url.match exact | prefix | regex Phép đối sánh cho URL MCP server đã cấu hình.
mcp_servers.<id>.identity.url.value string Giá trị được bộ đối sánh URL exact hoặc prefix sử dụng.
model_catalog_json string (path) Ấn định danh mục mô hình JSON mà Codex sử dụng khi khởi động.
model_provider string Ấn định ID nhà cung cấp mô hình, ghi đè cấu hình cục bộ và cấu hình phiên.
model_providers map<string, table> Các định nghĩa nhà cung cấp mô hình được quản lý. Mỗi mục thay thế toàn bộ nhà cung cấp đã cấu hình có cùng ID; các trường không được hợp nhất với định nghĩa của người dùng. Nhà cung cấp có ID khác vẫn khả dụng.
model_providers.<id> table Định nghĩa đầy đủ của nhà cung cấp được quản lý. Sử dụng cùng các trường nhà cung cấp như config.toml, bao gồm name, base_url, cài đặt xác thực và truyền tải.
models table Chứa bảng [models.new_thread].
models.new_thread table Các giá trị mặc định tùy chọn được áp dụng khi bắt đầu một luồng cục bộ mới. Chúng được ưu tiên hơn giá trị mặc định của người dùng và dự án, nhưng có thể bị thay thế bằng giá trị ghi đè tường minh.
models.new_thread.model string Mô hình mặc định cho các luồng mới. Việc ghi đè tường minh mô hình hoặc mức độ suy luận sẽ khiến cả hai trường bị bỏ qua.
models.new_thread.model_reasoning_effort string Mức độ suy luận mặc định cho các luồng mới. Việc ghi đè tường minh mô hình hoặc mức độ suy luận sẽ khiến cả hai trường bị bỏ qua.
models.new_thread.service_tier string Cấp dịch vụ mặc định cho các luồng mới. Việc ghi đè tường minh cấp dịch vụ sẽ khiến trường này bị bỏ qua.
permissions table Các hồ sơ quyền do quản trị viên định nghĩa, dùng tên hồ sơ làm khóa. Sử dụng cùng các trường hồ sơ như config.toml.
permissions.<name> table Hồ sơ quyền do quản trị viên định nghĩa. Tên không được bắt đầu bằng :, sử dụng tên dành riêng filesystem hoặc trùng với hồ sơ trong cấu hình đã nạp. Sử dụng cùng các trường hồ sơ như config.toml; xem hướng dẫn về Quyền để biết lược đồ hồ sơ đầy đủ.
permissions.filesystem.deny_read array<string> Các quy tắc từ chối đọc hệ thống tệp do quản trị viên bắt buộc áp dụng. Các mục có thể là đường dẫn hoặc mẫu glob, và người dùng không thể nới lỏng chúng bằng cấu hình cục bộ.
plugins table Danh sách MCP server được phép cho từng plugin, dùng mã định danh plugin làm khóa. Khi có bảng này, các máy chủ đi kèm plugin không có mục plugin và máy chủ khớp sẽ bị vô hiệu hóa.
plugins.<plugin>.mcp_servers table Danh sách cho phép đối với các MCP servers đi kèm một plugin. Các yêu cầu máy chủ plugin sử dụng cùng dạng danh tính chính xác và dạng đối sánh như các yêu cầu mcp_servers cấp cao nhất.
plugins.<plugin>.mcp_servers.<server>.identity table Quy tắc danh tính cho một MCP server đi kèm plugin. Đặt command (stdio) hoặc url (HTTP có khả năng truyền luồng).
plugins.<plugin>.mcp_servers.<server>.identity.command string | table Cho phép MCP server stdio của plugin theo chuỗi lệnh chính xác, hoặc sử dụng bảng đối sánh để yêu cầu tệp thực thi chính xác và các bộ đối sánh đối số theo thứ tự.
plugins.<plugin>.mcp_servers.<server>.identity.command.args array<table> Các bộ đối sánh đối số theo thứ tự cho máy chủ stdio đi kèm plugin. Danh sách đối số đã cấu hình phải có cùng độ dài và mọi vị trí đều phải khớp.
plugins.<plugin>.mcp_servers.<server>.identity.command.args[].expression string Biểu thức chính quy được bộ đối sánh đối số regex sử dụng. Biểu thức phải khớp toàn bộ giá trị đối số.
plugins.<plugin>.mcp_servers.<server>.identity.command.args[].match exact | prefix | regex Phép đối sánh cho vị trí đối số này.
plugins.<plugin>.mcp_servers.<server>.identity.command.args[].value string Giá trị được bộ đối sánh đối số exact hoặc prefix sử dụng.
plugins.<plugin>.mcp_servers.<server>.identity.command.executable string Tệp thực thi mà lệnh đã cấu hình của máy chủ stdio đi kèm plugin phải khớp chính xác.
plugins.<plugin>.mcp_servers.<server>.identity.url string | table Cho phép MCP server HTTP có khả năng truyền luồng của plugin theo chuỗi URL chính xác, hoặc sử dụng bảng đối sánh giá trị exact, prefix hoặc regex.
plugins.<plugin>.mcp_servers.<server>.identity.url.expression string Biểu thức chính quy được bộ đối sánh URL regex sử dụng. Biểu thức phải khớp toàn bộ giá trị URL.
plugins.<plugin>.mcp_servers.<server>.identity.url.match exact | prefix | regex Phép đối sánh cho URL MCP server đi kèm plugin.
plugins.<plugin>.mcp_servers.<server>.identity.url.value string Giá trị được bộ đối sánh URL exact hoặc prefix sử dụng.
remote_sandbox_config array<table> Các yêu cầu môi trường cô lập riêng cho từng máy chủ. Mục đầu tiên có hostname_patterns khớp với tên máy chủ đã phân giải sẽ ghi đè allowed_sandbox_modes cấp cao nhất của nguồn yêu cầu đó. Hiện các mục riêng cho từng máy chủ chỉ ghi đè chế độ môi trường cô lập.
remote_sandbox_config[].allowed_sandbox_modes array<string> Các chế độ môi trường cô lập được phép áp dụng khi mục riêng cho máy chủ này khớp.
remote_sandbox_config[].hostname_patterns array<string> Các mẫu tên máy chủ không phân biệt chữ hoa chữ thường. Hỗ trợ * cho chuỗi ký tự bất kỳ và ? cho một ký tự.
rules table Các quy tắc lệnh do quản trị viên bắt buộc áp dụng, được hợp nhất với các tệp .rules. Quy tắc yêu cầu phải mang tính hạn chế.
rules.prefix_rules array<table> Danh sách các quy tắc tiền tố bắt buộc áp dụng. Mỗi quy tắc phải bao gồm pattern và decision.
rules.prefix_rules[].decision prompt | forbidden Bắt buộc. Quy tắc yêu cầu chỉ có thể yêu cầu xác nhận hoặc cấm (không thể cho phép).
rules.prefix_rules[].justification string Lý do tùy chọn, không được để trống, hiển thị trong lời nhắc phê duyệt hoặc thông báo từ chối.
rules.prefix_rules[].pattern array<table> Tiền tố lệnh được biểu diễn bằng các token mẫu. Mỗi token đặt token hoặc any_of.
rules.prefix_rules[].pattern[].any_of array<string> Danh sách các token thay thế được phép tại vị trí này.
rules.prefix_rules[].pattern[].token string Một token nguyên văn duy nhất tại vị trí này.
sqlite_home string (path) Ấn định thư mục nơi Codex lưu trạng thái thời gian chạy dựa trên SQLite.
windows table Các yêu cầu đối với môi trường cô lập gốc của Windows.
windows.allowed_sandbox_implementations array<string> Các cách triển khai môi trường cô lập gốc Windows cũ được phép (elevated và unelevated). Danh sách không được để trống. Khi cả hai đều được phép và chưa chọn chế độ nào, Codex ưu tiên elevated. Danh sách này không hạn chế môi trường cô lập mxc khi môi trường cô lập đó khả dụng.