Codex Security: quét, kiểm chứng và vá lỗ hổng bảo mật — hướng dẫn cài đặt và dùng
Bài này là một góc nhìn khác về openai/codex-security — repo từng đổi tên nên mình viết lại với cách tiếp cận khác. Bài hướng dẫn chính: codex-security: quét, kiểm chứng và vá lỗ hổng bảo mật bằng AI — hướng dẫn cài đặt và dùng →

Tóm tắt nhanh
Codex Security là bộ công cụ của OpenAI gồm CLI (lệnh cs) và SDK TypeScript, dùng để quét kho mã nguồn, tìm lỗ hổng bảo mật, kiểm chứng và vá lỗi. Bạn cài bằng npm, đăng nhập rồi chạy một lệnh quét ngay trong thư mục dự án. Cài đặt không khó nếu máy đã có Node.js và Python đúng phiên bản.
Codex Security là công cụ của OpenAI giúp bạn tìm, điều tra và sửa lỗ hổng bảo mật trong mã nguồn. Nó có ba cách dùng: làm plugin trong Codex, chạy bằng lệnh cs trong terminal, hoặc gọi từ code qua SDK TypeScript và GitHub Action. Bạn đưa cho nó một thư mục dự án, nó quét rồi trả về một báo cáo kèm các phát hiện.
Repo này hợp với lập trình viên, nhóm nhỏ chưa có chuyên gia bảo mật riêng, và người phụ trách kỹ thuật ở công ty muốn kiểm tra nhanh sản phẩm của mình. Bạn không cần là chuyên gia bảo mật để chạy lần quét đầu tiên. Chỉ cần mở terminal, cài gói npm, đăng nhập và gõ một lệnh.
Điểm đáng giá nhất là nó không dừng ở việc liệt kê cảnh báo. Theo README, công cụ còn kiểm chứng các phát hiện ứng viên, tạo bản vá và xác minh bản sửa có thật sự hiệu quả không. Repo hiện có khoảng 12.700 sao và 991 fork, giấy phép Apache-2.0, và vẫn được cập nhật trong vài tháng gần đây.
openai/codex-security
Công cụ dòng lệnh và SDK TypeScript của OpenAI giúp quét mã nguồn, tìm lỗ hổng bảo mật, kiểm chứng và gợi ý bản vá.
I.Codex Security làm được gì
Dưới đây là các tính năng chính theo README, kèm lợi ích thực tế.
- Quét theo phạm vi bạn chọn. Bạn quét cả repo, chỉ vài thư mục, hoặc chỉ những thay đổi đã commit so với một nhánh gốc. Quét thay đổi rất hợp khi bạn muốn kiểm tra riêng phần code mới thay vì chờ cả dự án.
- Hai chế độ quét. Chế độ Standard là mặc định. Chế độ Deep lặp lại các lần quét Standard rồi trả về kết quả đã loại trùng. Deep kỹ hơn nhưng chắc chắn tốn thêm thời gian và chi phí.
- Kiểm chứng và vá lỗi. Công cụ kiểm chứng các phát hiện, tạo bản vá, và xác minh những bản sửa đã có. Nhờ vậy bạn đỡ phải đoán cảnh báo nào là thật.
- Soạn chính sách và mô hình đe dọa. Lệnh
cs policysoạn bản nhápSECURITY.md. Mô hình đe dọa (threat model) được lưu cùng kết quả quét và xuất ra file khi cần. - Quản lý kết quả đã lưu. Bạn xem lại các lần quét, nhận diện phát hiện trùng, đánh giá mức nghiêm trọng theo thang riêng của mình, và gợi ý người phụ trách dựa trên mã nguồn cùng lịch sử Git.
- Nhập kết quả từ công cụ quét khác. Bạn xem trước, lưu cục bộ, hoặc đăng báo cáo được hỗ trợ lên Codex Security Cloud.
- Đưa vào quy trình làm việc. Theo dõi phát hiện trong Linear, Jira hoặc GitHub, và xuất SARIF, JSON, CSV.
- Tự động hoá. Chạy quét nhiều repo, trong CI hoặc trong container.
- Nhiều nhà cung cấp mô hình. Ngoài OpenAI còn có Amazon Bedrock, OpenRouter, Fireworks AI và Cheaper Inference.
II.Cần chuẩn bị gì
Theo README, bạn cần:
- Node.js: bản 22.13.0 trở lên trong nhánh 22.x, hoặc Node.js 24.x, hoặc 26.x.
- Python 3.10 trở lên. Nếu dùng đúng Python 3.10 thì cần thêm gói
tomli. - Tài khoản đăng nhập: lệnh
cs logindùng để đăng nhập. README không nói chi tiết loại tài khoản nào đủ điều kiện, bạn xem thêm trong tài liệu chính thức. - Khoá API cho CI: khi chạy tự động, đặt
OPENAI_API_KEYhoặcCODEX_API_KEYtrong môi trường của tiến trình quét. Với GitHub Actions, README dùng secret tênCODEX_SECURITY_API_KEY. - Máy không đăng nhập được bằng trình duyệt: README có hướng dẫn đăng nhập bằng thiết bị hoặc SSH, nằm trong tài liệu của dự án.
- Dùng Amazon Bedrock: cần thông tin xác thực AWS và không cần đăng nhập OpenAI riêng.
README không nêu yêu cầu phần cứng như GPU hay dung lượng RAM, và cũng không nêu hệ điều hành cụ thể. Phần chi phí và hệ điều hành bạn nên kiểm tra thêm trong tài liệu chính thức.
Một số yêu cầu liên quan an ninh mạng và một số phát hiện được bảo vệ cần Trusted Access for Cyber. Quét cũng tiêu tốn tài nguyên mô hình, nên hãy đặt giới hạn chi phí khi chạy tự động và đừng dán khoá API vào file code hay đẩy lên GitHub.
III.Cài đặt từng bước
- Kiểm tra môi trườngChắc chắn máy có Node.js và Python đúng phiên bản
- Cài CLIChạy npm install --global để có lệnh cs
- Đăng nhậpChạy cs login
- Quét lần đầuVào thư mục dự án và chạy cs scan .
- Đọc báo cáoMở file Markdown ở đường dẫn REPORT
A.Kiểm tra Node.js và Python
Mở terminal (PowerShell trên Windows, Terminal trên macOS hay Linux) rồi kiểm tra phiên bản. Hai lệnh dưới đây là lệnh phổ thông để xem phiên bản đang cài.
node --version
python --versionNếu Node.js thấp hơn yêu cầu hoặc chưa có Python, bạn cần cài hoặc nâng cấp trước. Trên một số máy, lệnh Python là python3 thay vì python. Nếu bạn đang dùng đúng Python 3.10, hãy nhớ README yêu cầu thêm tomli.
B.Cài CLI toàn cục
Lệnh này cài gói @openai/codex-security cho cả máy, nên bạn gõ cs được từ bất kỳ thư mục nào.
npm install --global @openai/codex-securityChỗ người mới hay vấp là quyền cài đặt toàn cục. README không đề cập sudo hay chạy với quyền quản trị, nên nếu npm báo lỗi quyền, hãy xem cấu hình npm của bạn trước khi làm theo mẹo ngẫu nhiên trên mạng.
Còn nếu bạn không muốn cài toàn cục, hoặc npm báo xung đột EEXIST, README cho phép dùng npx @openai/codex-security thay cho cs ở cả bước đăng nhập lẫn quét. Tương tự, nếu tên cs trùng với lệnh khác trên máy, hãy dùng codex-security. Hai tên này chạy cùng một CLI.
C.Đăng nhập
cs loginLàm làm theo hướng dẫn hiện ra trong terminal. Nếu máy không có trình duyệt, ví dụ máy chủ từ xa, hãy xem phần đăng nhập bằng thiết bị hoặc SSH trong tài liệu của dự án. README chỉ nhắc có tồn tại hướng dẫn đó chứ không chép lệnh.
D.Chạy lần quét đầu tiên
Dùng cd để vào thư mục dự án cần quét rồi chạy lệnh dưới đây. Dấu chấm nghĩa là quét thư mục hiện tại, nên hãy chắc chắn bạn đang đứng đúng thư mục gốc của repo.
cs scan .Sau khi quét xong, terminal hiển thị đường dẫn ở mục REPORT. Đó là file Markdown chứa báo cáo.
E.Các tuỳ chọn quét hay dùng
Dưới đây là các lệnh nguyên văn từ README. Dòng bắt đầu bằng # là chú thích.
# Scan selected paths.
cs scan . --path src --path tests
# Scan committed changes from a base revision to HEAD.
cs scan . --diff origin/main
# Run a deep scan of the repository.
cs scan . --mode deepLệnh đầu chỉ quét thư mục src và tests. Lệnh thứ hai quét các thay đổi đã commit từ origin/main tới HEAD, nghĩa là phần code mới trên nhánh bạn đang làm. Lệnh thứ ba quét sâu toàn bộ repo.
README còn có tuỳ chọn --max-time 15 để đặt khoảng thời gian điều tra tham khảo 15 phút cho chế độ Standard. Đây là mức "khuyến nghị" chứ không phải giới hạn cứng. Muốn xem toàn bộ tuỳ chọn, gồm cả giới hạn chi phí và vá lỗi sau quét, dùng cs --help hoặc cs scan --help.
F.Cài SDK TypeScript (nếu cần)
Bước này chỉ dành cho dev muốn gọi từ code. Chạy trong thư mục dự án TypeScript của bạn.
npm install @openai/codex-securitySau đó dùng đoạn code mẫu trong README:
import { CodexSecurity } from "@openai/codex-security";
const security = new CodexSecurity();
try {
const result = await security.run("/path/to/repository");
console.log(result.reportPath);
} finally {
await security.close();
}Đoạn code tạo một đối tượng CodexSecurity, chạy quét trên đường dẫn repo, in ra đường dẫn báo cáo, rồi đóng kết nối. Hãy thay /path/to/repository bằng đường dẫn thật trên máy bạn.
IV.Kiểm tra đã chạy được chưa
Có ba dấu hiệu để biết mọi thứ ổn:
cs --helphiện danh sách lệnh, nghĩa là CLI đã cài được.cs scan .chạy xong và in ra đường dẫn REPORT. Mở file Markdown đó ra và đọc được nội dung là thành công.- Chạy
cs scans showtrong cùng thư mục repo sẽ tìm lại lần quét hoàn tất gần nhất.
Hãy đọc báo cáo kỹ phần bằng chứng từ mã nguồn và phần loại trừ. README nhấn mạnh rằng báo cáo cho biết phần nào đã được quét, phần nào bị bỏ qua. Một báo cáo ít phát hiện chưa chắc là dự án an toàn, vì có thể phạm vi quét hẹp.
V.Dùng vào việc thật
A.Dev kiểm tra code mới trước khi gộp nhánh
Bạn làm việc trên một nhánh tính năng và sắp mở pull request. Thay vì quét cả dự án, bạn chỉ quét phần đã commit so với nhánh chính:
cs scan . --diff origin/mainKết quả là báo cáo tập trung vào phần code bạn vừa thêm. Bạn đọc từng phát hiện kèm bằng chứng, rồi nhờ công cụ gợi ý bản vá hoặc xác minh bản sửa. Cách này nhanh hơn quét toàn bộ và phù hợp thói quen kiểm tra trước mỗi lần gộp.
Báo cáo bảo mật chỉ có giá trị khi bạn biết nó đã quét phần nào và bỏ qua phần nào.
Ông T
B.Chủ sản phẩm quét tập trung vào đăng nhập và phân quyền
Bạn là người phụ trách một ứng dụng bán hàng nhỏ và lo nhất là chỗ đăng nhập, phân quyền. Nếu dùng plugin trong Codex, README gợi ý một câu lệnh mẫu như sau:
Run a Codex Security scan on this repository, focusing on authentication and authorization. Return the saved report, source evidence, and coverage limits.
Bạn nhận lại báo cáo đã lưu, bằng chứng từ mã nguồn và giới hạn phạm vi. Nếu thích dùng terminal, bạn có thể thu hẹp phạm vi bằng --path vào đúng thư mục xử lý đăng nhập, nhưng bạn cần tự biết thư mục đó tên gì trong dự án của mình.
C.Nhóm nhỏ viết chính sách bảo mật cho repo
Công ty bạn chưa có file SECURITY.md, hoặc file cũ đã lỗi thời. Chạy:
cs policy .
cs policy . --path services/api --knowledge-base architecture.mdLệnh đầu soạn chính sách cho cả repo. Lệnh sau soạn cho một thành phần cụ thể là services/api, kèm tài liệu kiến trúc của bạn. Điểm an toàn là bản nháp được lưu bên ngoài repo và không ghi đè file nào. Bạn xem lại phần khác biệt và ghi chú, chỉnh sửa, rồi tự sao chép SECURITY.md vào vị trí Policy target mà công cụ hiển thị. Nếu repo đã có hướng dẫn báo cáo lỗ hổng, hãy giữ nguyên phần đó khi cập nhật.
D.Xuất mô hình đe dọa để gửi cho người khác xem
Sau khi quét, bạn muốn gửi mô hình đe dọa cho sếp hoặc đối tác kiểm duyệt. Lệnh xuất không chạy lại phân tích:
cs export --scan SCAN_ID --artifact threat-model --output threatmodel.mdThay SCAN_ID bằng mã lần quét. Nếu bỏ --scan, công cụ dùng lần quét hoàn tất gần nhất của repo hiện tại. Bạn nhận về file threatmodel.md để đưa vào tài liệu. README cũng nói tài liệu xuất còn hỗ trợ SARIF cho CI.
VI.Lỗi hay gặp và cách xử lý
A.Gõ cs báo không tìm thấy lệnh
Thường do cài chưa xong, hoặc terminal chưa nhận đường dẫn mới. Đóng terminal, mở lại rồi thử cs --help. Nếu vẫn lỗi, thử codex-security. Bạn cũng có thể chạy bằng npx @openai/codex-security thay cho cs mà không cần cài toàn cục.
B.npm báo lỗi EEXIST khi cài
Đây là lỗi README có nhắc đến. Cách xử lý được ghi là dùng npx @openai/codex-security thay cho cs, cho cả đăng nhập lẫn quét. Cách này tránh đụng vào file đang tồn tại.
C.Báo thiếu phiên bản Node.js hoặc Python
Kiểm tra lại bằng node --version và python --version, so với yêu cầu ở phần chuẩn bị. Nếu bạn dùng Python 3.10, đừng quên tomli. Nên nâng cấp theo hướng dẫn chính thức của Node.js và Python thay vì dùng bản tải từ nguồn lạ.
D.Đăng nhập không được trên máy chủ không có trình duyệt
Đừng cố ép trình duyệt. README có nhắc tới đăng nhập bằng thiết bị hoặc SSH cho máy không đầu (headless). Hãy tìm mục đó trong tài liệu của dự án. Nếu chạy trong CI, đặt OPENAI_API_KEY hoặc CODEX_API_KEY vào môi trường của tiến trình quét thông qua cơ chế bí mật của hệ thống CI, không viết thẳng vào file.
E.Quét tốn quá lâu hoặc vượt ngân sách
Chế độ Deep lặp lại nhiều lần quét nên tốn hơn. README ghi giới hạn chi phí chỉ là ước tính, và các yêu cầu đang chạy có thể vượt mức đó. Hãy bắt đầu bằng Standard, quét phạm vi nhỏ bằng --path hoặc --diff, và xem cs scan --help để biết các tuỳ chọn giới hạn chi phí.
VII.Có nên dùng không
Điểm mạnh. Công cụ đi trọn quy trình: quét, kiểm chứng, vá, xác minh. Nó có CLI, SDK và GitHub Action, nên dùng được từ máy cá nhân đến CI. Báo cáo nêu rõ bằng chứng và giới hạn phạm vi, giúp bạn không tin mù quáng vào kết quả. Bạn cũng có thể chọn nhà cung cấp mô hình khác ngoài OpenAI, và giấy phép Apache-2.0 khá thoáng.
Giới hạn. Cần Node.js và Python đúng phiên bản, cùng tài khoản hoặc khoá API để chạy. README không nêu giá cụ thể, nên bạn cần tự kiểm tra chi phí trước khi quét hàng loạt. Một số tính năng như Cloud hay Trusted Access for Cyber chỉ dùng được với tài khoản phù hợp. Trình duyệt dashboard cục bộ và lệnh serve đã bị gỡ, dù dữ liệu cũ vẫn còn dùng được.
Khi nên chọn cách khác. Nếu bạn không muốn gửi mã nguồn cho dịch vụ mô hình bên ngoài, cần xem kỹ cách xử lý dữ liệu trước. README không có đoạn nào mô tả chi tiết chuyện này nên chưa có kết luận. Và với hệ thống quan trọng, đừng coi một báo cáo quét là bằng chứng an toàn tuyệt đối. Hãy kết hợp rà soát thủ công và kiểm thử bảo mật chuyên sâu.
Nếu bạn là dev hay chủ sản phẩm muốn có lớp kiểm tra bảo mật tự động, bắt đầu với một lệnh cs scan . trên một repo nhỏ là cách thử rẻ và dễ nhất.
Câu hỏi thường gặp
Codex Security có miễn phí không?
Repo có giấy phép Apache-2.0 nên mã nguồn dùng tự do. Tuy nhiên, việc quét cần đăng nhập hoặc khoá API của nhà cung cấp mô hình, và README không nêu giá. Bạn nên kiểm tra chi phí trong tài liệu chính thức trước khi quét nhiều.
Cần cài gì trước khi dùng?
Cần Node.js 22.13.0 trở lên trong nhánh 22.x (hoặc 24.x, 26.x) và Python 3.10 trở lên. Nếu dùng Python 3.10 thì cần thêm gói tomli. Sau đó cài CLI bằng npm.
Có cần GPU không?
README không nhắc đến yêu cầu GPU hay phần cứng riêng. Công cụ dùng mô hình của nhà cung cấp như OpenAI hay Amazon Bedrock, nên về mặt tài liệu thì không thấy yêu cầu này.
Chạy được trên Windows không?
README không ghi rõ hệ điều hành nào được hỗ trợ. Nó chỉ nêu yêu cầu Node.js và Python, nên bạn cần kiểm tra thêm trong tài liệu chính thức nếu dùng Windows.
Chạy trong CI hoặc GitHub Actions được không?
Được. Với CI, đặt OPENAI_API_KEY hoặc CODEX_API_KEY trong môi trường của tiến trình quét. Repo cũng có GitHub Action, ví dụ quét hằng tuần trên Ubuntu của GitHub với secret CODEX_SECURITY_API_KEY và giới hạn ước tính 5 đô la mỗi lần quét.
Có dùng được mô hình ngoài OpenAI không?
Có. README liệt kê OpenAI, Amazon Bedrock, OpenRouter, Fireworks AI và Cheaper Inference. Bedrock dùng thông tin xác thực AWS và không cần đăng nhập OpenAI riêng.
Dữ liệu và mã nguồn của tôi có an toàn không?
README không mô tả chi tiết cách mã nguồn được xử lý khi gửi tới nhà cung cấp mô hình, nên chưa có thông tin để kết luận. Kết quả quét được lưu cục bộ, còn Codex Security Cloud là kết nối tuỳ chọn, quét cục bộ vẫn chạy khi không dùng Cloud.


