Dùng Codex để chuẩn hóa cấu hình cho nhóm và kiểm tra thiết lập có hiệu lực

Trong khoảng 40 phút, bạn có thể tạo cấu hình Codex chung cho dự án, thử thứ tự ưu tiên và ghi cách đồng đội tái hiện kết quả. Bạn cần Codex CLI, repo thử và quyền sửa tệp. Kết quả là một tệp cấu hình ngắn, bảng thử trên hai máy hoặc tài khoản và hướng dẫn xử lý khi thiết lập cá nhân ghi đè thiết lập chung.

Khi nhiều người dùng Codex, mỗi người có thể chọn mô hình và chế độ tìm kiếm khác nhau. Theo Config basics của OpenAI, Codex đọc cấu hình từ nhiều nơi. Tệp dự án chỉ có hiệu lực khi dự án đáng tin cậy, còn chính sách quản trị có thể giới hạn giá trị người dùng chọn. Bài này nói về độ lặp lại của cấu hình. Phạm vi tệp, mạng và phê duyệt khi chạy lệnh có trong hướng dẫn kiểm tra quyền Codex.

Chuẩn bị

Mở Codex CLI, đăng nhập và chọn repo thử với một tác vụ nhỏ, chẳng hạn sửa nhãn nút. Ghi phiên bản Codex, hệ điều hành, thư mục làm việc, workspace và ngày thử để đối chiếu hai máy.

Bạn cần phân biệt bốn nơi trước khi sửa:

1. ~/.codex/config.toml giữ mặc định riêng của từng người. Nếu đặt CODEX_HOME, gốc này chuyển sang thư mục đã chọn và thư mục phải tồn tại trước.
2. .codex/config.toml trong repo giữ các thiết lập phù hợp với dự án. Có thể có nhiều lớp từ gốc dự án tới thư mục làm việc; lớp gần thư mục hiện tại hơn được ưu tiên.
3. Tệp profile ở $CODEX_HOME/[tên].config.toml dành cho bộ thiết lập được chọn bằng --profile [tên].
4. Tham số CLI, kể cả -c hoặc --config, dùng cho một lần chạy và đứng đầu thứ tự ưu tiên của các giá trị cấu hình.

Xem Configuration Reference trước khi thêm khóa. Tệp dự án không thể ghi đè các khóa như model_provider, model_providers, notify, profile, profiles và otel. Quy tắc làm việc bằng ngôn ngữ tự nhiên thuộc AGENTS.md, còn lựa chọn máy chạy nằm ở config.toml.

Làm từng bước

1. Chọn ít giá trị chung nhất có thể

Hỏi người dùng thường xuyên và người phụ trách an toàn: thiết lập nào phải giống nhau trên mọi máy? Chỉ đưa vào repo giá trị chung. Nếu mô hình tùy gói từng người, đừng khóa model chỉ để có tệp giống nhau.

Tạo .codex/config.toml ở repo thử, với nội dung tối thiểu như sau:

web_search = "cached"
model_reasoning_effort = "medium"

Đây là ví dụ để thử, không phải chuẩn cho mọi công ty. cached dùng chỉ mục tìm kiếm theo Config basics. Mức suy luận chỉ có tác dụng khi mô hình hỗ trợ. Giữ tệp ngắn để người duyệt hiểu từng thay đổi.

Nếu muốn đặt mô hình chung, xác nhận nó có trong mọi tài khoản liên quan. Sample Configuration là nguồn tham khảo, không phải tệp để chép nguyên vào repo.

2. Lập bảng thứ tự ưu tiên cho nhóm

Ghi bảng ba cột: khóa, nơi đặt, giá trị mong đợi. Theo OpenAI, thứ tự từ cao xuống thấp là tham số CLI, cấu hình dự án đáng tin cậy từ gốc tới thư mục hiện tại, profile, cấu hình người dùng, mặc định cloud quản lý, cấu hình hệ thống, rồi mặc định tích hợp. Trong dự án, lớp gần thư mục chạy hơn được ưu tiên.

Ví dụ, repo đặt web_search = "cached", nhưng đồng đội chạy -c web_search=live. Phiên đó dùng live vì CLI đứng trên repo. Nếu profile ghi disabled và repo tin cậy ghi cached, repo thắng. Đây là suy luận từ thứ tự ưu tiên, cần xác nhận bằng thử nghiệm.

requirements.toml do quản trị viên áp đặt là ràng buộc, không phải mặc định có thể ghi đè bằng -c. Chính sách có thể cấm giá trị người dùng chọn. Với MDM, Agent Security hoặc Work Cloud, nhờ quản trị viên xác nhận chính sách ở đúng môi trường.

3. Thử với dự án tin cậy và chưa tin cậy

Nhờ hai đồng đội bắt đầu phiên mới trong cùng repo thử. Ghi cấu hình ở /status nếu giao diện hiển thị, hoặc ghi kết quả thử quan sát được. Không chụp khóa API, token hay tệp đăng nhập. Dùng yêu cầu sau:

Hãy cho biết bạn đang làm việc trong thư mục nào và tóm tắt thiết lập phiên mà giao diện hiển thị. Chưa sửa tệp.

Hãy giải thích ngắn vì sao tác vụ thử này cần hoặc không cần tìm kiếm web. Chưa sửa tệp và chưa chạy lệnh cài đặt.

Nếu dự án bị đánh dấu untrusted, Codex bỏ qua .codex/ của dự án, gồm cấu hình, hooks và rules. Cấu hình người dùng, hệ thống vẫn được nạp. Kiểm tra trạng thái tin cậy trước khi kết luận tệp repo sai. Chỉ tin cậy nguồn đã xem.

4. Kiểm tra ghi đè một lần, rồi khôi phục

Trưởng nhóm cần chứng minh bảng ưu tiên bằng một ca thử dễ đảo ngược. Trên repo thử, mở phiên CLI với một giá trị khác cho đúng một khóa, rồi so sánh với phiên bình thường:

codex -c web_search=disabled

Ghi lệnh, thư mục, giá trị mong đợi và kết quả quan sát. Đóng phiên thử rồi mở phiên không có -c. Nếu chỉ thấy hành vi thay đổi, hãy ghi rõ chưa chứng minh toàn bộ đường nạp cấu hình.

Profile hữu ích khi một người phải dùng hai cách làm khác nhau, chẳng hạn kiểm tra nhanh và công việc cần suy luận dài. Đặt tệp profile cạnh cấu hình người dùng, không giả định nó được định nghĩa ngay trong repo. Chọn profile bằng cờ CLI:

codex --profile [tên-profile]

Thay [tên-profile] bằng tên thật và thử trên máy đại diện. Trong repo đáng tin cậy, cấu hình dự án vẫn ưu tiên hơn profile. Chỉ đặt trong profile các giá trị khác mặc định chung.

5. Phân biệt biến môi trường với cấu hình bền vững

Theo Environment variables của OpenAI, config.toml giữ thiết lập bền vững. Biến môi trường dành cho phiên shell, bí mật tự động hóa và chẩn đoán. CODEX_HOME đổi nơi lưu cấu hình, xác thực, nhật ký và phiên. Nếu một người đặt biến này, kiểm tra đường dẫn trước khi sửa ~/.codex/config.toml.

Đừng đưa CODEX_API_KEY hoặc CODEX_ACCESS_TOKEN vào repo. OpenAI mô tả chúng cho tiến trình không tương tác hoặc tự động hóa đáng tin cậy. Dùng kho bí mật của CI và không in giá trị vào log. RUST_LOG chỉ lọc thông tin chẩn đoán.

[shell_environment_policy] giới hạn biến môi trường chuyển cho lệnh con. Theo Config basics, ignore_default_excludes = false bật lọc tên chứa KEY, SECRET, TOKEN. Thử bằng biến giả, không dùng bí mật thật. Lớp này khác việc Codex đọc tệp nào.

6. Đưa vào quy trình thay đổi của nhóm

Mỗi pull request sửa .codex/config.toml nên ghi lý do, khóa đổi và hai ca thử trước sau. Đồng đội thử ở thư mục khác để kiểm tra lớp gần hơn, rồi thử -c hoặc profile nếu nhóm dùng. Hướng dẫn tác vụ đặt trong AGENTS.md; skill dùng chung có quy trình phân phối riêng.

Kết quả mẫu

Một nhóm ba người thêm web_search và model_reasoning_effort vào repo. Hai người ghi cùng kỳ vọng. Người thứ ba dùng -c web_search=disabled, thấy phiên thử khác, rồi mở phiên mới để quay lại mặc định. Biên bản ghi ai dùng CODEX_HOME riêng và việc còn chờ quản trị viên xác nhận chính sách Work Cloud. Kết quả tốt là biết vì sao giá trị có hiệu lực.

Mẹo để kết quả tốt hơn

• Bắt đầu với hai hoặc ba khóa có thể thử được.
• Ghi thư mục đang đứng; lớp cấu hình gần hơn có thể đổi kết quả.
• Giữ bí mật và thiết lập cá nhân khỏi repo.
• Sau khi cập nhật Codex, thử lại và tra Configuration Reference.
• Người mới có thể đọc AI agent là gì trước khi xem TOML.

Giới hạn cần biết

config.toml chọn mặc định, không thay chính sách quản trị hay chứng minh quyền hệ điều hành đã được cấp. Tệp repo không tự quyết định quyền ứng dụng ngoài hoặc buộc tài khoản khác nhau dùng chung mô hình. Kiểm tra trong môi trường thật trước khi triển khai rộng.

CLI và IDE dùng chung các lớp cấu hình theo OpenAI. Codex Cloud, Work Cloud và máy được quản lý có chính sách riêng; nhờ quản trị viên kiểm tra. Nếu thử nghiệm mâu thuẫn với kỳ vọng, giữ bằng chứng để tìm nguyên nhân.

Câu hỏi thường gặp

Có nên sao chép toàn bộ config-sample vào repo không? Không. Tệp mẫu là tài liệu tham khảo nhiều khóa. Chỉ lấy những khóa nhóm cần, có người sở hữu và có ca thử.

Tại sao .codex/config.toml không có tác dụng? Kiểm tra repo đã được tin cậy chưa, thư mục hiện tại có lớp gần hơn không, và phiên có tham số CLI ghi đè không. Cũng xem khóa đó có bị bỏ qua trong cấu hình dự án hay không.

Profile có thắng cấu hình trong repo không? Với repo đáng tin cậy, cấu hình dự án có ưu tiên cao hơn profile. Tham số CLI đứng cao hơn cả hai.

Đặt CODEX_HOME có làm mọi đồng đội dùng chung cấu hình không? Không. Biến đó đổi thư mục gốc cho tiến trình trên máy hoặc môi trường đang chạy. Mỗi người phải xác nhận đúng đường dẫn và quyền của mình.

Có thể dùng -c để vượt chính sách công ty không? Không nên hiểu như vậy. -c ưu tiên hơn các mặc định cấu hình, nhưng yêu cầu quản trị là ràng buộc riêng. Hãy xác nhận với quản trị viên khi một giá trị bị từ chối.

Nguồn chính thức: Config basics, Configuration Reference, Environment variables và Sample Configuration, OpenAI Learn, đối chiếu ngày 5/10/2026.

#Codex #ChatGPT #AIAgent #VibeCoding