Tổng quan cấu hình và mở rộng

Cấu hình tốt giúp Codex ít đoán hơn, chạy đúng lệnh hơn và an toàn hơn. Đừng bắt đầu bằng cấu hình phức tạp; hãy thêm từng lớp khi workflow thật cần.

Bốn lớp cấu hình

Lớp	Vai trò
AGENTS.md	Quy tắc dự án: lệnh, style, điều cấm, kiểm chứng
config.toml	Cấu hình cá nhân/CLI: model, sandbox, approval, profiles, MCP
Skills / Plugins	Đóng gói workflow hoặc năng lực ngoài
Chính sách đội nhóm	Quyền repo, secret, review, audit và release

Cách đọc chuyên mục này

1. Bắt đầu từ CLI options nếu bạn dùng terminal.
2. Đọc config.toml để biết profile và sandbox.
3. Đọc MCP, Skills và Subagents khi cần công cụ ngoài.
4. Đọc bảo mật và quản trị trước khi dùng trong đội nhóm.

Ba nguyên tắc

• Cấu hình càng mạnh càng cần kiểm chứng rõ.
• Secret không thuộc về prompt, README hoặc file tracked.
• Mọi quyền tự động phải có cách rollback hoặc audit.

Lộ trình tối thiểu

Ngày 1: dùng được

• Cài App hoặc CLI.
• Chạy task chỉ đọc.
• Tạo AGENTS.md tối thiểu.
• Dùng quyền workspace, không full access.

Tuần 1: ổn định

• Thêm lệnh test/build vào AGENTS.md.
• Tạo profile chỉ đọc và profile coding.
• Ghi lại lỗi thường gặp.
• Chọn một workflow lặp lại để thành template.

Tháng 1: đội nhóm

• Chuẩn hóa PR template.
• Viết playbook quyền và secret.
• Đóng gói Skill cho workflow hay dùng.
• Lập case library và checklist review.