Bắt đầu với Codex: Các phương pháp tối ưu để đạt kết quả tốt hơn

Nếu bạn mới bắt đầu với @OpenAI Codex hoặc các tác nhân lập trình nói chung, hướng dẫn này sẽ giúp bạn đạt kết quả tốt hơn nhanh hơn. Nó bao gồm các thói quen cốt lõi giúp Codex hoạt động hiệu quả hơn trên CLI, tiện ích mở rộng IDE và ứng dụng Codex, từ việc ra lệnh và lập kế hoạch đến xác thực, MCP, kỹ năng và tự động hóa.

Codex hoạt động tốt nhất khi bạn coi nó như một đồng đội mà bạn có thể cấu hình và cải thiện theo thời gian, thay vì chỉ là một trợ lý dùng một lần.

Một mô hình tư duy hữu ích là: bắt đầu với ngữ cảnh tác vụ phù hợp, sử dụng AGENTS.md cho các hướng dẫn bền vững, cấu hình Codex phù hợp với quy trình làm việc của bạn, kết nối các hệ thống bên ngoài bằng MCP, biến các công việc lặp lại thành kỹ năng và tự động hóa các quy trình ổn định.

1. Thiết lập Codex mạnh mẽ ngay từ lần sử dụng đầu với ngữ cảnh và câu lệnh rõ ràng

Codex đã đủ mạnh để hữu ích ngay cả khi câu lệnh của bạn không hoàn hảo. Bạn thường có thể giao cho nó một vấn đề khó với thiết lập tối thiểu và vẫn nhận được kết quả tốt. Việc ra lệnh rõ ràng không bắt buộc để có được giá trị, nhưng nó giúp kết quả đáng tin cậy hơn, đặc biệt là trong các codebase lớn hoặc các tác vụ quan trọng hơn.

Nếu bạn làm việc trong một kho lưu trữ lớn hoặc phức tạp, khả năng bứt phá lớn nhất thường là cung cấp cho Codex ngữ cảnh tác vụ phù hợp và một cấu trúc rõ ràng cho những gì bạn muốn thực hiện.

Một mặc định tốt là bao gồm bốn điều sau trong câu lệnh của bạn:

• Mục tiêu: Bạn đang cố gắng thay đổi hoặc xây dựng điều gì?
• Ngữ cảnh: Tệp, thư mục, tài liệu, ví dụ hoặc lỗi nào quan trọng cho tác vụ này? Bạn có thể @ đề cập đến các tệp nhất định làm ngữ cảnh.
• Ràng buộc: Codex nên tuân theo các tiêu chuẩn, kiến trúc, yêu cầu bảo mật hoặc quy ước nào?
• Hoàn thành khi: Điều gì nên đúng trước khi tác vụ hoàn tất, chẳng hạn như các bài kiểm tra đạt, hành vi thay đổi hoặc lỗi được sửa?

Điều này giúp Codex duy trì phạm vi, đưa ra ít giả định hơn và tạo ra công việc dễ xem xét và xác thực hơn.

Chọn mức độ suy luận dựa trên độ khó của tác vụ và kiểm tra xem mức nào hoạt động tốt nhất cho quy trình làm việc của bạn. Những người dùng và tác vụ khác nhau sẽ được hưởng lợi từ các cài đặt khác nhau.

• Thấp cho các tác vụ nhanh hơn, có phạm vi tốt
• Trung bình hoặc Cao cho các thay đổi hoặc gỡ lỗi phức tạp hơn
• Rất Cao cho các tác vụ dài, có tác nhân, yêu cầu suy luận nhiều

Mẹo cho người dùng mới

: Hầu hết mọi người làm quen nhanh nhất bằng cách bắt đầu với một vài thành công cơ bản, như đặt câu hỏi cho Codex về codebase hoặc sử dụng nó để sửa một lỗi nhỏ, có phạm vi. Rất khuyến khích sử dụng tính năng đọc chính tả bằng giọng nói trong ứng dụng Codex để tăng tốc các lần lặp.

Các mức suy luận của Codex

2. Giảm sai sót trong các tác vụ khó bằng cách yêu cầu Codex lập kế hoạch trước

Nếu tác vụ phức tạp, mơ hồ hoặc khó mô tả rõ ràng, hãy yêu cầu Codex lập kế hoạch trước khi bắt đầu viết mã.

Có một số cách tốt để thực hiện điều này:

Sử dụng chế độ Lập kế hoạch: Đối với hầu hết người dùng, đây là lựa chọn dễ dàng và hiệu quả nhất. Chế độ Lập kế hoạch cho phép Codex thu thập ngữ cảnh, đặt câu hỏi làm rõ và xây dựng một kế hoạch tốt hơn trước khi triển khai. Bật/tắt bằng /plan hoặc Shift+Tab.

Yêu cầu Codex phỏng vấn bạn: Nếu bạn có một ý tưởng sơ bộ về những gì bạn muốn nhưng không chắc chắn làm thế nào để mô tả nó tốt, hãy yêu cầu Codex đặt câu hỏi cho bạn trước. Hãy bảo nó thách thức các giả định của bạn và biến ý tưởng mơ hồ thành thứ gì đó cụ thể trước khi viết mã.

Sử dụng mẫu PLANS.md: Đối với các quy trình làm việc nâng cao hơn, bạn có thể cấu hình Codex để tuân theo một mẫu PLANS.md hoặc kế hoạch thực thi cho các công việc dài hơn hoặc nhiều bước. Để biết thêm chi tiết, hãy xem hướng dẫn về kế hoạch thực thi của chúng tôi.

Chế độ Lập kế hoạch

3. Làm cho hướng dẫn thành công có thể tái sử dụng với AGENTS.md

Khi một khuôn mẫu ra lệnh hiệu quả, bước tiếp theo là ngừng lặp lại nó một cách thủ công. Đó là lúc AGENTS.md xuất hiện.

Hãy nghĩ về AGENTS.md như một README dành cho các tác nhân. Nó là một định dạng mở, đơn giản được tự động tải vào ngữ cảnh và là nơi tốt nhất để mã hóa cách bạn và nhóm của bạn muốn Codex hoạt động trong một kho lưu trữ.

Một AGENTS.md tốt thường bao gồm:

• Bố cục kho lưu trữ và các thư mục quan trọng
• Cách chạy dự án
• Các lệnh xây dựng, kiểm tra và lint
• Các quy ước kỹ thuật và kỳ vọng về PR
• Các ràng buộc và quy tắc không được làm
• "Hoàn thành" nghĩa là gì và cách xác minh công việc

Lệnh slash /init trong CLI là lệnh khởi động nhanh để tạo khung AGENTS.md trong thư mục hiện tại. Đó là một điểm khởi đầu tuyệt vời, nhưng bạn nên chỉnh sửa kết quả để phù hợp với cách nhóm của bạn thực sự xây dựng, kiểm tra, xem xét và triển khai mã.

Bạn có thể tạo tệp AGENTS.md ở nhiều cấp độ: AGENTS.md toàn cục cho các mặc định cá nhân nằm trong ~/.codex, tệp cấp kho lưu trữ cho các tiêu chuẩn dùng chung và các tệp cụ thể hơn trong thư mục con cho các quy tắc cục bộ. Nếu có một tệp cụ thể hơn gần với thư mục làm việc hiện tại của bạn, hướng dẫn đó sẽ được ưu tiên.

Hãy giữ nó thực tế. Một AGENTS.md ngắn gọn, chính xác sẽ hữu ích hơn một tệp dài với đầy các quy tắc mơ hồ. Bắt đầu với những điều cơ bản, sau đó chỉ thêm các quy tắc mới sau khi bạn nhận thấy các lỗi lặp lại.

Nếu AGENTS.md bắt đầu trở nên quá lớn, hãy giữ tệp chính ngắn gọn và tham chiếu đến các tệp markdown dành riêng cho tác vụ cho những thứ như lập kế hoạch, đánh giá mã hoặc kiến trúc.

Mẹo

: Khi Codex mắc cùng một lỗi hai lần, hãy yêu cầu nó tổng kết lại và cập nhật AGENTS.md. Các hướng dẫn sẽ luôn thực tế và dựa trên những khó khăn thực tế.

Trang web AGENTS.md

4. Đạt được hành vi nhất quán hơn bằng cách cấu hình Codex phù hợp với quy trình làm việc của bạn

Cấu hình là một trong những cách chính để làm cho Codex hoạt động nhất quán hơn qua các phiên và bề mặt. Ví dụ, bạn có thể đặt mặc định cho lựa chọn mô hình, mức độ suy luận, chế độ sandbox, chính sách phê duyệt, hồ sơ và thiết lập MCP.

Một khuôn mẫu khởi đầu tốt là:

• Giữ các mặc định cá nhân trong ~/.codex/config.toml (Cài đặt → Cấu hình → Mở config.toml từ ứng dụng Codex)
• Giữ hành vi dành riêng cho kho lưu trữ trong .codex/config.toml
• Chỉ sử dụng ghi đè dòng lệnh cho các tình huống một lần (nếu bạn sử dụng CLI)

Config.toml là nơi bạn xác định các tùy chọn ưu tiên bền vững như máy chủ MCP, hồ sơ, thiết lập nhiều tác nhân và các tính năng thử nghiệm. Bạn có thể chỉnh sửa nó trực tiếp hoặc yêu cầu Codex cập nhật nó cho bạn.

Codex được trang bị tính năng sandbox ở cấp độ hệ điều hành và có hai núm điều chỉnh chính mà bạn có thể kiểm soát. Chế độ phê duyệt xác định khi nào Codex yêu cầu sự cho phép của bạn để chạy một lệnh và chế độ sandbox xác định liệu Codex có thể đọc hoặc ghi trong thư mục và những tệp nào tác nhân có thể truy cập.

Nếu bạn hoàn toàn mới với các tác nhân lập trình, khuyến nghị là bắt đầu một cách thận trọng với các quyền mặc định. Giữ chế độ phê duyệt và sandbox chặt chẽ theo mặc định, sau đó chỉ nới lỏng quyền đối với các kho lưu trữ đáng tin cậy hoặc các quy trình làm việc cụ thể khi nhu cầu thực sự rõ ràng.

Lưu ý rằng CLI, IDE và ứng dụng Codex đều chia sẻ cùng một lớp cấu hình. Tìm hiểu thêm trên trang tài liệu cấu hình mẫu của chúng tôi.

Mẹo

: Cấu hình Codex cho môi trường thực tế của bạn ngay từ đầu. Nhiều vấn đề về chất lượng thực chất là vấn đề thiết lập, như sai thư mục làm việc, thiếu quyền ghi, sai mặc định mô hình hoặc thiếu các công cụ và trình kết nối.

5. Cải thiện độ tin cậy bằng cách yêu cầu Codex kiểm tra, xác thực và đánh giá công việc

Đừng chỉ dừng lại ở việc yêu cầu Codex thực hiện một thay đổi. Hãy yêu cầu nó tạo các bài kiểm tra khi cần, chạy các kiểm tra liên quan, xác thực kết quả và đánh giá công việc trước khi bạn chấp nhận nó.

Codex có thể tự thực hiện vòng lặp này cho bạn, nhưng chỉ khi nó biết "tốt" trông như thế nào. Hướng dẫn đó có thể đến từ câu lệnh hoặc AGENTS.md.

Điều đó có thể bao gồm:

• Viết hoặc cập nhật các bài kiểm tra cho thay đổi
• Chạy các bộ kiểm tra phù hợp
• Kiểm tra lint, định dạng hoặc kiểm tra kiểu
• Xác nhận hành vi cuối cùng khớp với yêu cầu
• Xem xét diff để tìm lỗi, hồi quy hoặc các mẫu rủi ro

Mẹo:

Bật bảng diff trong ứng dụng Codex để

xem xét các thay đổi trực tiếp cục bộ. Nhấp vào một hàng cụ thể để cung cấp phản hồi được đưa vào làm ngữ cảnh cho lượt Codex tiếp theo.

Một tùy chọn hữu ích ở đây là lệnh slash /review, cung cấp cho bạn một số cách khác nhau để xem xét mã:

• Xem xét dựa trên một nhánh cơ sở để đánh giá theo kiểu PR
• Xem xét các thay đổi chưa được commit
• Xem xét một commit
• Sử dụng hướng dẫn đánh giá tùy chỉnh

Nếu bạn và nhóm của bạn có một tệp code_review.md được tham chiếu trong AGENTS.md, Codex cũng có thể tuân theo hướng dẫn đó trong quá trình đánh giá. Đây là một khuôn mẫu mạnh mẽ cho các nhóm muốn hành vi đánh giá nhất quán giữa các kho lưu trữ và người đóng góp.

Codex không chỉ nên tạo mã. Với các hướng dẫn phù hợp, nó cũng có thể giúp kiểm tra nó, xác thực nó và đánh giá nó.

Nếu bạn sử dụng GitHub Cloud, bạn có thể dễ dàng thiết lập Codex để chạy đánh giá mã cho các PR của bạn. Chúng tôi cho Codex đánh giá 100% PR tại OpenAI. Bạn có tùy chọn bật đánh giá tự động hoặc để Codex đánh giá một cách phản ứng khi bạn @Codex.

/review trong Codex CLI

6. Đưa các công cụ bên ngoài và ngữ cảnh trực tiếp vào Codex với MCP

Sử dụng MCP khi ngữ cảnh Codex cần nằm bên ngoài kho lưu trữ. Nó cho phép Codex kết nối với các công cụ và hệ thống bạn đã sử dụng, để bạn không phải liên tục sao chép và dán thông tin trực tiếp vào câu lệnh.

Model Context Protocol, hay MCP, là một tiêu chuẩn mở để kết nối Codex với các công cụ và hệ thống bên ngoài.

Sử dụng MCP khi:

• Ngữ cảnh cần thiết nằm bên ngoài kho lưu trữ
• Dữ liệu thay đổi thường xuyên
• Bạn muốn Codex sử dụng một công cụ thay vì dựa vào các hướng dẫn đã dán
• Bạn cần một tích hợp có thể lặp lại giữa các người dùng hoặc dự án

Codex hỗ trợ cả máy chủ STDIO và Streamable HTTP với OAuth.

Trong ứng dụng Codex, hãy vào Cài đặt → Máy chủ MCP để xem các máy chủ tùy chỉnh và được đề xuất. Thông thường, Codex có thể giúp bạn cài đặt các máy chủ cần thiết. Tất cả những gì bạn cần làm là yêu cầu. Bạn cũng có thể sử dụng lệnh codex mcp add trong CLI để thêm các máy chủ tùy chỉnh của bạn với tên, URL và bất kỳ thông tin bổ sung nào.

Mẹo

: Chỉ thêm các công cụ khi chúng mở khóa một quy trình làm việc thực sự. Đừng bắt đầu bằng cách kết nối tất cả các công cụ bạn sử dụng. Bắt đầu với một hoặc hai công cụ rõ ràng loại bỏ một vòng lặp thủ công mà bạn thường xuyên thực hiện, sau đó mở rộng từ đó.

Quản lý máy chủ MCP

7. Biến các quy trình làm việc lặp lại thành các kỹ năng có thể tái sử dụng

Khi một quy trình làm việc trở nên lặp lại, hãy ngừng dựa vào các câu lệnh dài hoặc các trao đổi qua lại lặp đi lặp lại. Sử dụng Kỹ năng để đóng gói các hướng dẫn trong một tệp SKILL.md, ngữ cảnh và logic hỗ trợ mà Codex sẽ áp dụng một cách nhất quán. Kỹ năng hoạt động trên CLI, tiện ích mở rộng IDE và ứng dụng Codex.

Giữ mỗi kỹ năng được giới hạn chặt chẽ trong một công việc. Bắt đầu với 2 đến 3 trường hợp sử dụng cụ thể, xác định đầu vào và đầu ra rõ ràng, và viết mô tả sao cho nó nói rõ kỹ năng làm gì và khi nào sử dụng nó. Bao gồm các loại cụm từ kích hoạt mà người dùng thực sự có thể nói.

Đừng cố gắng bao quát mọi trường hợp ngoại lệ ngay từ đầu. Bắt đầu với một tác vụ đại diện, làm cho nó hoạt động tốt, sau đó biến quy trình làm việc đó thành một kỹ năng và cải thiện từ đó. Chỉ bao gồm các tập lệnh hoặc nội dung bổ sung khi chúng cải thiện đáng kể độ tin cậy.

Một nguyên tắc nhỏ tốt: nếu bạn tiếp tục sử dụng lại cùng một câu lệnh hoặc sửa cùng một quy trình làm việc, nó có lẽ nên trở thành một kỹ năng.

Kỹ năng đặc biệt hữu ích cho các công việc lặp đi lặp lại như:

• Phân loại nhật ký
• Soạn thảo ghi chú phát hành
• Đánh giá PR dựa trên danh sách kiểm tra
• Lập kế hoạch di chuyển
• Tóm tắt đo từ xa hoặc sự cố
• Luồng gỡ lỗi tiêu chuẩn

Kỹ năng $skill-creator là nơi tốt nhất để bắt đầu, nhằm tạo khung cho phiên bản đầu tiên của một kỹ năng và sử dụng kỹ năng $skill-installer để cài đặt nó cục bộ. Một trong những phần quan trọng nhất của một kỹ năng là mô tả. Nó nên nói rõ kỹ năng làm gì và khi nào sử dụng nó.

Mẹo

: Các kỹ năng cá nhân được lưu trữ trong

$HOME /.agents/skills và các kỹ năng nhóm dùng chung có thể được kiểm tra vào .agents/skills bên trong một kho lưu trữ. Điều này đặc biệt hữu ích cho việc đào tạo các thành viên mới trong nhóm.

Tạo và cài đặt kỹ năng

Giao diện kỹ năng của ứng dụng Codex

8. Tiết kiệm thời gian cho các công việc lặp đi lặp lại với tự động hóa

Khi một quy trình làm việc đã ổn định, bạn có thể lên lịch để Codex chạy nó trong nền cho bạn. Trong ứng dụng Codex, tự động hóa cho phép bạn chọn dự án, câu lệnh, nhịp độ và môi trường thực thi cho một tác vụ lặp lại.

Khi một tác vụ trở nên lặp đi lặp lại đối với bạn, bạn có thể dễ dàng tạo một tự động hóa trong tab Tự động hóa trên ứng dụng Codex. Bạn có thể chọn dự án mà nó chạy, câu lệnh nó chạy (bạn có thể gọi các kỹ năng) và nhịp độ nó sẽ chạy. Bạn cũng có thể chọn liệu tự động hóa chạy trong một cây làm việc git chuyên dụng hay trong môi trường cục bộ của bạn. Tìm hiểu thêm về cây làm việc git.

Các ứng cử viên tốt bao gồm:

• Tóm tắt các commit gần đây
• Quét tìm các lỗi tiềm ẩn
• Soạn thảo ghi chú phát hành
• Kiểm tra lỗi CI
• Tạo tóm tắt standup
• Chạy các quy trình phân tích lặp lại theo lịch trình

Một quy tắc hữu ích là các kỹ năng xác định phương pháp, tự động hóa xác định lịch trình. Nếu một quy trình làm việc vẫn cần nhiều sự điều chỉnh, trước tiên hãy biến nó thành một kỹ năng. Khi nó có thể dự đoán được, tự động hóa trở thành một nhân tố tăng sức mạnh.

Mẹo

: Sử dụng tự động hóa để suy ngẫm và bảo trì, không chỉ để thực thi. Xem lại các phiên gần đây, tóm tắt các khó khăn lặp lại và cải thiện câu lệnh, hướng dẫn hoặc thiết lập quy trình làm việc theo thời gian.

Tạo tự động hóa trong ứng dụng Codex

9. Giữ tổ chức trong các công việc dài hạn với các điều khiển phiên

Các phiên Codex không chỉ là lịch sử trò chuyện. Chúng là các luồng công việc tích lũy ngữ cảnh, quyết định và hành động theo thời gian, vì vậy việc quản lý chúng tốt có tác động lớn đến chất lượng.

Quản lý nhiều luồng dễ dàng nhất trong giao diện ứng dụng Codex với khả năng ghim luồng và tạo cây làm việc. Nhưng nếu bạn đang sử dụng CLI, các lệnh slash này đặc biệt hữu ích:

• /experimental để bật/tắt các tính năng thử nghiệm và thêm vào config.toml của bạn
• /resume để tiếp tục một cuộc trò chuyện đã lưu
• /fork để tạo một luồng mới trong khi vẫn giữ nguyên bản ghi gốc
• /compact khi luồng đang trở nên dài và bạn muốn một phiên bản tóm tắt của ngữ cảnh trước đó. Lưu ý rằng Codex tự động thu gọn các cuộc trò chuyện cho bạn
• /agent khi bạn đang chạy nhiều tác nhân và muốn chuyển đổi giữa các luồng tác nhân đang hoạt động
• /theme để chọn một chủ đề tô sáng cú pháp
• /apps để sử dụng các ứng dụng ChatGPT trực tiếp trong Codex
• /status để kiểm tra trạng thái phiên hiện tại

Giữ một luồng trên mỗi đơn vị công việc mạch lạc. Nếu công việc vẫn là một phần của cùng một vấn đề, ở lại trong cùng một luồng thường tốt hơn vì nó bảo tồn dấu vết suy luận. Chỉ fork khi công việc thực sự rẽ nhánh.

Mẹo

:

Sử dụng các quy trình làm việc

đa tác nhân của Codex để chuyển giao công việc có giới hạn khỏi luồng chính. Giữ tác nhân chính tập trung vào vấn đề cốt lõi và sử dụng các tác nhân phụ cho các tác vụ như khám phá, kiểm tra hoặc phân loại.

10. Các lỗi thường gặp cần tránh

Một số lỗi thường gặp cần tránh khi mới sử dụng Codex:

• Làm quá tải câu lệnh với các quy tắc lâu dài thay vì chuyển chúng vào AGENTS.md hoặc một kỹ năng
• Không để tác nhân thấy công việc của nó bằng cách không cung cấp chi tiết về cách chạy các lệnh xây dựng và kiểm tra tốt nhất
• Bỏ qua việc lập kế hoạch cho các tác vụ nhiều bước và phức tạp
• Cấp cho Codex toàn quyền truy cập vào máy tính của bạn trước khi hiểu rõ quy trình làm việc
• Chạy nhiều luồng trực tiếp trên cùng một tệp mà không sử dụng cây làm việc git
• Biến một tác vụ lặp lại thành tự động hóa trước khi nó đáng tin cậy khi thực hiện thủ công
• Sử dụng Codex song song với công việc của riêng bạn thay vì coi nó như thứ bạn phải theo dõi từng bước một

Danh sách kiểm tra bắt đầu

1. Cung cấp cho Codex mục tiêu, ngữ cảnh, ràng buộc và điều kiện hoàn thành phù hợp
2. Đối với các tác vụ khó, hãy yêu cầu Codex lập kế hoạch trước
3. Tạo một AGENTS.md khởi đầu
4. Hướng dẫn Codex cách xây dựng, kiểm tra, xác thực và đánh giá
5. Đặt các mặc định cấu hình phù hợp với quy trình làm việc của bạn
6. Thêm MCP cho các công cụ bên ngoài có giá trị cao
7. Biến các quy trình làm việc lặp lại thành kỹ năng
8. Sử dụng tự động hóa khi một quy trình làm việc đã ổn định

Bạn càng biến quy trình làm việc, tiêu chuẩn và ngữ cảnh của mình thành thứ Codex có thể sử dụng, bạn càng thấy rõ tác nhân thực sự có thể làm được gì. Hãy bắt đầu ngay hôm nay!