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

Kiến thức cơ bản về cấu hình

Tìm hiểu kiến thức cơ bản về cách cấu hình ứng dụng khách Codex cục bộ

Codex đọc thông tin cấu hình từ nhiều vị trí. Các giá trị mặc định cá nhân của bạn nằm trong ~/.codex/config.toml, và bạn có thể thêm các thiết lập ghi đè cho dự án bằng tệp .codex/config.toml. Để bảo mật, Codex chỉ tải các lớp .codex/ của dự án khi bạn tin cậy dự án đó.

Tệp cấu hình Codex

Codex lưu cấu hình cấp người dùng tại ~/.codex/config.toml. Để giới hạn phạm vi thiết lập cho một dự án hoặc thư mục con cụ thể, hãy thêm tệp .codex/config.toml vào kho lưu trữ của bạn.

Để mở tệp cấu hình từ tiện ích mở rộng Codex IDE, hãy chọn biểu tượng bánh răng ở góc trên bên phải, sau đó chọn Cài đặt Codex > Mở config.toml.

CLI và tiện ích mở rộng IDE dùng chung các lớp cấu hình. Bạn có thể sử dụng chúng để:

Thứ tự ưu tiên cấu hình

Các yêu cầu ràng buộc hành vi; các giá trị cấu hình cung cấp giá trị mặc định. Quyền truy cập máy tính cục bộ với Work Cloud tuân theo các yêu cầu sau:

  • Giữa các chính sách: Chính sách có mức ưu tiên cao hơn được ưu tiên áp dụng so với chính sách có mức ưu tiên thấp hơn, ngay cả khi chính sách có mức ưu tiên thấp hơn cụ thể hơn.
  • Trong cùng một chính sách: Các giá trị ghi đè cho môi trường dành riêng cho từng hệ điều hành được ưu tiên hơn các giá trị ghi đè cho môi trường áp dụng cho mọi hệ điều hành, sau đó mới đến Global.
  • Đối với thực thi cục bộ: 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.
  • Đối với Work Cloud: Các container đám mây của Work giữ nguyên các chính sách Work Cloud hiện có. Đối với Work có quyền truy cập cục bộ và dots, chính sách Global được hỗ trợ chi phối bộ điều phối đám mây dùng chung khi chính sách được quản lý được bật; các yêu cầu thực thi cục bộ có liên quan chi phối máy tính được kết nối.

Một số yêu cầu có quy tắc hợp nhất riêng cho từng trường. Xem Cấu hình được quản lý để biết phạm vi chính sách và các giới hạn khi thực thi, và Tài liệu tham khảo cấu hình để biết khả năng tương thích với Work.

Codex phân giải các giá trị theo thứ tự sau (mức ưu tiên cao nhất trước):

  1. Các cờ CLI và giá trị ghi đè --config
  2. Các tệp cấu hình dự án: .codex/config.toml, theo thứ tự từ thư mục gốc dự án xuống thư mục làm việc hiện tại (tệp gần nhất được ưu tiên; chỉ áp dụng cho dự án đáng tin cậy)
  3. Các tệp hồ sơ được chọn bằng --profile profile-name (~/.codex/profile-name.config.toml)
  4. Cấu hình người dùng: ~/.codex/config.toml
  5. Các giá trị mặc định config.toml do đám mây quản lý, khi được cung cấp cho không gian làm việc đã đăng nhập
  6. Cấu hình hệ thống (nếu có): /etc/codex/config.toml trên Unix
  7. Các giá trị mặc định tích hợp sẵn

Hãy sử dụng thứ tự ưu tiên này để đặt các giá trị mặc định dùng chung trong config.toml và chỉ giữ những giá trị khác biệt trong các tệp hồ sơ.

Cấu hình do đám mây quản lý và cấu hình hệ thống có thể xác định các kho plugin và thiết lập việc bật plugin theo mặc định. Các thiết lập này tách biệt với những chính sách requirements.toml được thực thi bắt buộc. Xem Cấu hình kho plugin và các giá trị mặc định.

Nếu bạn đánh dấu một dự án là không đáng tin cậy, Codex sẽ bỏ qua các lớp .codex/ thuộc phạm vi dự án, bao gồm cấu hình, hook và quy tắc cục bộ của dự án. Cấu hình người dùng và hệ thống vẫn được tải, bao gồm hook và quy tắc cấp người dùng/toàn cục.

Để biết cách ghi đè dùng một lần qua -c/--config (bao gồm các quy tắc đặt dấu ngoặc kép của TOML), hãy xem Cấu hình nâng cao.

Các tùy chọn cấu hình phổ biến

Dưới đây là một số tùy chọn thường được thay đổi nhất:

Mô hình mặc định

Chọn mô hình mà Codex sử dụng theo mặc định trong CLI và IDE.

model = "gpt-6.1-sol"

Lời nhắc phê duyệt

Kiểm soát thời điểm Codex tạm dừng để xin phép trước khi chạy các lệnh được tạo.

approval_policy = "on-request"

Để biết sự khác biệt về hành vi giữa on-request và never, hãy xem Chạy mà không có lời nhắc phê duyệt và Các cách kết hợp môi trường cô lập và phê duyệt phổ biến. Nếu cấu hình hiện có sử dụng approval_policy = "untrusted", hãy xem Chuyển đổi từ chính sách phê duyệt untrusted đã ngừng hỗ trợ.

Cấp độ môi trường cô lập

Điều chỉnh phạm vi truy cập hệ thống tệp và mạng mà Codex có khi thực thi lệnh.

sandbox_mode = "workspace-write"

Để biết hành vi của từng chế độ (bao gồm các đường dẫn .git, .agents, .codex và .aws được bảo vệ và thiết lập mạng mặc định), hãy xem Môi trường cô lập và phê duyệt, Đường dẫn được bảo vệ trong các thư mục gốc có thể ghi và Quyền truy cập mạng.

Hồ sơ quyền

Codex cũng hỗ trợ các hồ sơ quyền có tên để tái sử dụng chính sách hệ thống tệp và mạng. Các hồ sơ tích hợp sẵn gồm :read-only, :workspace và :danger-full-access. Hồ sơ tùy chỉnh sử dụng các bảng [permissions.<name>] và một giá trị default_permissions tương ứng. Hãy xem Quyền.

Chế độ môi trường cô lập trên Windows

Trên Windows, ưu tiên MXC khi thiết bị và chính sách hỗ trợ. Thiết lập một phương án triển khai cũ để dự phòng:

[windows]
sandbox = "elevated" # Legacy fallback

[features]
prefer_mxc = true

Chỉ dùng unelevated khi không thể thiết lập với quyền nâng cao và chính sách của tổ chức cho phép. Xem Hướng dẫn về môi trường cô lập trên Windows để biết các giới hạn tương thích và biện pháp kiểm soát triển khai.

Chế độ tìm kiếm web

Codex mặc định bật tìm kiếm trên web cho các cuộc trò chuyện cục bộ và cung cấp kết quả từ bộ nhớ đệm tìm kiếm trên web. Bộ nhớ đệm này là một chỉ mục kết quả web do OpenAI duy trì, vì vậy chế độ dùng bộ nhớ đệm trả về các kết quả đã được lập chỉ mục thay vì truy xuất trực tiếp các trang đang hoạt động. Điều này giúp giảm nguy cơ bị chèn chỉ dẫn độc hại từ nội dung trực tiếp bất kỳ. Hãy coi kết quả web là dữ liệu không đáng tin cậy. Nếu bạn đang sử dụng --yolo hoặc một cài đặt môi trường cô lập với toàn quyền truy cập khác, tìm kiếm trên web mặc định dùng kết quả trực tiếp. Chọn chế độ bằng web_search:

  • "cached" (mặc định) cung cấp kết quả từ bộ nhớ đệm tìm kiếm web.
  • "indexed" chỉ cho phép truy cập web bên ngoài khi chỉ mục tìm kiếm chấp thuận yêu cầu.
  • "live" truy xuất dữ liệu mới nhất từ web (giống như --search).
  • "disabled" tắt công cụ tìm kiếm web.
web_search = "cached"  # default; serves results from the web search cache
# web_search = "indexed" # gate external web access through the search index
# web_search = "live"  # fetch the most recent data from the web (same as --search)
# web_search = "disabled"

Mức độ suy luận

Điều chỉnh mức độ suy luận mà mô hình áp dụng khi được hỗ trợ.

model_reasoning_effort = "medium"

Phong cách giao tiếp

Để bỏ các chỉ dẫn về tính cách được tích hợp sẵn, hãy đặt:

personality = "none"

Thiết lập này loại bỏ phần Personality khỏi các chỉ dẫn tích hợp sẵn của mô hình. Thiết lập này không thay đổi các chỉ dẫn cơ sở tùy chỉnh được chỉ định rõ. Các giá trị cũ friendly và pragmatic không còn dùng để chọn phong cách. Codex không còn cung cấp lệnh /personality.

Sơ đồ phím TUI

Tùy chỉnh các phím tắt trong terminal tại tui.keymap. Các thao tác soạn thảo được chọn sẽ dùng phương án dự phòng là các liên kết tui.keymap.global tương ứng; các liên kết theo ngữ cảnh cụ thể được ưu tiên khi được hỗ trợ. Danh sách trống sẽ hủy liên kết của thao tác.

[tui.keymap.global]
open_transcript = "ctrl-t"

[tui.keymap.composer]
submit = ["enter", "ctrl-m"]

[tui.keymap.chat]
interrupt_turn = "f12"

Môi trường lệnh

Kiểm soát các biến môi trường mà Codex chuyển tiếp đến những lệnh được khởi chạy. Sử dụng các bộ lọc theo khóa để chỉ giữ lại những biến bạn cần:

[shell_environment_policy]
ignore_default_excludes = false

[shell_environment_policy.filters]
"PATH" = "include"
"HOME" = "include"

ignore_default_excludes mặc định là true, do đó bỏ qua việc lọc tự động đối với tên biến chứa KEY, SECRET hoặc TOKEN. Đặt thành false khi bạn muốn áp dụng cơ chế lọc tự động đó. Để biết các quy tắc loại trừ, thứ tự ưu tiên và cấu hình cũ, hãy xem Chính sách môi trường shell.

Thư mục nhật ký

Ghi đè vị trí Codex ghi các tệp nhật ký cục bộ. Việc đặt log_dir một cách rõ ràng cũng bật nhật ký TUI dạng văn bản thuần cần chủ động tham gia, codex-tui.log, trong thư mục đó.

log_dir = "/absolute/path/to/codex-logs"

Đối với các lần chạy dùng một lần, bạn cũng có thể đặt giá trị này từ CLI:

codex -c log_dir=./.codex-log

Cờ tính năng

Sử dụng bảng [features] trong config.toml để bật hoặc tắt các chức năng tùy chọn và thử nghiệm.

Các cờ tính năng phổ biến

Khóa Mặc định Mức độ hoàn thiện Mô tả
apps true Ổn định Bật tích hợp ứng dụng (trình kết nối)
goals true Ổn định Bật mục tiêu được lưu trữ và khả năng tự động tiếp tục
hooks true Ổn định Bật hook vòng đời từ hooks.json hoặc [hooks] nội tuyến. Hãy xem Hook.
fast_mode true Ổn định Bật lựa chọn chế độ Fast và đường dẫn service_tier = "fast"
memories false Thử nghiệm Bật Memories
multi_agent true Ổn định Bật các công cụ cộng tác với tác nhân phụ
remote_plugin true Ổn định Bật danh mục plugin từ xa
shell_snapshot true Ổn định Chụp nhanh môi trường shell để tăng tốc các lệnh lặp lại
shell_tool true Ổn định Bật các công cụ thực thi lệnh
unified_exec true Ổn định Bật thực thi lệnh có thể tiếp tục; chỉ các yêu cầu do quản trị viên quản lý mới có thể tắt tính năng này
web_search true Không còn khuyến nghị Cờ chuyển đổi cũ; nên dùng thiết lập web_search cấp cao nhất
web_search_cached false Không còn khuyến nghị Cờ chuyển đổi cũ ánh xạ đến web_search = "cached" khi chưa được đặt
web_search_request false Không còn khuyến nghị Cờ chuyển đổi cũ ánh xạ đến web_search = "live" khi chưa được đặt

Để biết cách cấu hình hook vòng đời, hãy xem Hook.

Bật tính năng

  • Trong config.toml, thêm feature_name = true bên dưới [features].
  • Từ CLI, chạy codex --enable feature_name.
  • Để bật nhiều tính năng, hãy chạy codex --enable feature_a --enable feature_b.
  • Để tắt một tính năng, hãy đặt khóa thành false trong config.toml.