Bỏ qua tới nội dung
Ông T.vn

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

10 phút đọcCập nhật

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 →

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à công cụ dòng lệnh (lệnh cs) kèm SDK TypeScript của OpenAI, giúp tìm, điều tra và vá lỗ hổng bảo mật trong mã nguồn. Bạn cài bằng npm, đăng nhập rồi chạy một lệnh quét trong thư mục dự án. Cài không khó nếu máy đã có Node.js và Python đúng phiên bản.

Codex Security là bộ công cụ của OpenAI giúp bạn tìm, điều tra và sửa các lỗ hổng bảo mật trong mã nguồn. Nó có ba cách dùng: chọn quy trình bảo mật ngay trong Codex, chạy lệnh cs trong terminal, hoặc gắn vào tự động hoá bằng SDK TypeScript và GitHub Action. Repo này là phần CLI và SDK, phát hành dưới dạng gói npm @openai/codex-security.

Bạn nên đọc bài này nếu mình là lập trình viên mới, chủ một sản phẩm phần mềm nhỏ, hoặc người phụ trách kỹ thuật trong công ty và muốn có một lượt rà soát bảo mật mà không phải thuê cả đội chuyên gia ngay. Bạn không cần là chuyên gia bảo mật. Bạn chỉ cần biết mở terminal và gõ lệnh.

Điểm đáng giá nhất: công cụ không chỉ liệt kê cảnh báo. Nó còn kiểm chứng các phát hiện, đề xuất bản vá và kiểm tra các bản vá có sẵn. Kết quả được lưu thành báo cáo kèm bằng chứng từ mã nguồn. Repo hiện có khoảng 12.683 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.

CLI

openai/codex-security

Công cụ dòng lệnh và SDK TypeScript của OpenAI để quét mã nguồn, kiểm chứng lỗ hổng bảo mật, gợi ý bản vá và xuất báo cáo.

★ 13kTypeScriptApache-2.0
Xem repo trên GitHub

I.Codex Security làm được gì

Dưới đây là các tính năng chính, kèm lợi ích thực tế khi dùng.

  • 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 Git. Nhờ vậy lần kiểm tra nhanh trước khi gộp code không phải quét lại toàn bộ dự án.
  • Hai chế độ quét. Chế độ Standard là mặc định. Chế độ Deep lặp lại các lượt quét Standard rồi trả về danh sách phát hiện đã loại trùng. Deep phù hợp khi bạn muốn rà kỹ trước một đợt phát hành lớn.
  • Kiểm chứng và vá. Công cụ kiểm chứng các phát hiện ứng viên, tạo bản vá và xác minh những bản sửa đã có. Bạn đỡ mất thời gian với cảnh báo không có thật.
  • Soạn chính sách và mô hình đe doạ. Công cụ giúp viết nháp file SECURITY.md và lưu mô hình đe doạ (threat model) để xem lại sau.
  • 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 công ty, và gợi ý người phụ trách dựa trên mã nguồn và lịch sử Git.
  • Nhập kết quả từ công cụ quét khác. Bạn xem trước phát hiện của công cụ bên thứ ba, lưu cục bộ, hoặc đăng một số loại báo cáo được hỗ trợ lên Codex Security Cloud.
  • Theo dõi và xuất báo cáo. Phát hiện có thể đưa vào Linear, Jira hoặc GitHub. Bạn cũng xuất được SARIF, JSON và CSV.
  • Tự động hoá. Công cụ chạy trong CI, trong container, qua GitHub Action, và quét hàng loạt nhiều repo.
  • Nhiều nhà cung cấp mô hình. Ngoài OpenAI, README nhắc tới 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 login dùng để đăng nhập. Với CI, bạn đặt khoá API trong biến môi trường OPENAI_API_KEY hoặc CODEX_API_KEY.
  • Nếu dùng Amazon Bedrock: dùng thông tin xác thực AWS và không cần đăng nhập OpenAI riêng.
  • Nếu dùng GitHub Actions: một khoá API OpenAI lưu thành secret của repo, tên CODEX_SECURITY_API_KEY.

README không ghi yêu cầu về GPU hay dung lượng ổ đĩa. Hệ điều hành hỗ trợ cũng chưa được nêu rõ trong phần README mình có. Bạn xem thêm trong tài liệu của repo (thư mục docs/) nếu cần chắc chắn.

Một số yêu cầu liên quan an ninh mạng và các phát hiện được bảo vệ cần Trusted Access for Cyber. Tài khoản có quyền Daybreak thì xem phần hướng dẫn riêng trong tài liệu. Khoá API là thông tin nhạy cảm: đừng dán vào chat, đừng commit vào repo. Quét có thể tốn phí, nên hãy xem giới hạn chi phí trong `cs scan --help` trước khi quét repo lớn.

III.Cài đặt từng bước

  1. Kiểm tra môi trườngXem Node.js và Python đã đúng phiên bản chưa
  2. Cài CLICài gói @openai/codex-security bằng npm
  3. Đăng nhậpChạy cs login
  4. Quét lần đầuVào thư mục dự án và chạy cs scan .
  5. Đọ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 hoặc Linux). Gõ hai lệnh sau để xem phiên bản đang có:

Terminal
node --version
python --version

Node cần thuộc các bản README liệt kê (22.13.0 trở lên trong 22.x, hoặc 24.x, 26.x). Python cần từ 3.10. Nếu máy dùng lệnh python3 thay vì python, bạn gõ python3 --version. Nếu thấy đúng Python 3.10, nhớ cài thêm tomli.

B.Cài CLI

Lệnh dưới đây cài công cụ ở mức toàn máy, nên gõ ở đâu cũng được:

Terminal
npm install --global @openai/codex-security

Sau khi cài xong, bạn có hai tên lệnh chạy cùng một chương trình là cs và codex-security. Nếu cs trùng với một lệnh khác trên máy, hãy dùng codex-security.

C.Đăng nhập

Terminal
cs login

Lệnh này đăng nhập để công cụ gọi được mô hình. Máy không có trình duyệt, ví dụ máy chủ từ xa, thì README có hướng dẫn riêng về đăng nhập bằng thiết bị hoặc SSH trong tài liệu.

D.Chạy lần quét đầu tiên

Trước hết cd vào thư mục dự án mà bạn muốn quét. Đây là chỗ người mới hay vấp: lệnh cs scan . quét thư mục hiện tại, nên đứng sai thư mục sẽ quét sai chỗ.

Terminal
cs scan .

Khi quét xong, terminal hiển thị đường dẫn REPORT. Đó là file Markdown chứa báo cáo. Bạn mở nó bằng bất kỳ trình soạn thảo nào.

E.Muốn dùng mà không cài toàn máy

Nếu không muốn cài global, hoặc npm báo lỗi EEXIST, README bảo dùng npx @openai/codex-security thay cho cs, cả khi đăng nhập lẫn khi quét. Lệnh có dạng như sau:

Terminal
npx @openai/codex-security login
npx @openai/codex-security scan .

F.Cài SDK TypeScript (nếu cần)

Bạn chỉ cần phần này khi muốn gọi công cụ từ code. Chạy lệnh trong thư mục dự án TypeScript của bạn:

Terminal
npm install @openai/codex-security

IV.Kiểm tra đã chạy được chưa

Cách đơn giản nhất là xem lệnh trợ giúp có hiện ra không:

Terminal
cs --help

Nếu terminal liệt kê các lệnh con thì CLI đã cài xong. Sau đó chạy cs scan . trong một dự án nhỏ. Kết quả mong đợi theo README là lần quét hoàn tất và hiện đường dẫn REPORT trỏ tới file Markdown.

Muốn tìm lại lần quét gần nhất của repo, bạn chạy lệnh sau từ cùng thư mục repo:

Terminal
cs scans show

V.Dùng vào việc thật

A.Tình huống 1: Rà soát toàn bộ dự án trước khi ra mắt

Bạn là lập trình viên của một công ty nhỏ, sắp đưa ứng dụng đặt hàng lên chạy thật. Bạn muốn có một lượt kiểm tra tổng thể. Bạn vào thư mục dự án và chạy chế độ quét sâu:

Terminal
cs scan . --mode deep

Deep lặp lại các lượt quét Standard rồi trả về danh sách phát hiện đã loại trùng. Bạn mở file báo cáo, đọc từng phát hiện cùng bằng chứng từ mã nguồn, và đọc luôn phần các nội dung bị loại trừ để biết công cụ chưa xem những gì.

Báo cáo bảo mật có giá trị nhất khi nó nói rõ chỗ nào chưa được xem.

Ông T

B.Tình huống 2: Kiểm tra thay đổi trước khi gộp code

Bạn là dev trong nhóm, vừa xong một nhánh tính năng. Thay vì quét lại cả dự án, bạn chỉ quét phần thay đổi đã commit so với nhánh chính:

Terminal
cs scan . --diff origin/main

Bạn cũng có thể giới hạn vào vài thư mục cụ thể, ví dụ phần mã đăng nhập và phần kiểm thử:

Terminal
cs scan . --path src --path tests

Nếu muốn giới hạn thời gian, README có tuỳ chọn --max-time (ví dụ 15 phút cho lượt điều tra Standard). Con số này chỉ mang tính tham khảo (advisory), không phải mức cắt cứng.

C.Tình huống 3: Viết chính sách bảo mật SECURITY.md

Bạn là người phụ trách kỹ thuật và repo của công ty chưa có file SECURITY.md. Bạn nhờ công cụ soạn nháp:

Terminal
cs policy .

Với một thành phần riêng, ví dụ thư mục dịch vụ API, bạn dùng ví dụ trong README:

Terminal
cs policy . --path services/api --knowledge-base architecture.md

Lệnh này lưu bản nháp ở ngoài repo và không đụng vào file hiện có. Bạn đọc phần so sánh và ghi chú, chỉnh bản nháp, rồi chỉ chép file SECURITY.md tới vị trí Policy target mà công cụ hiển thị. Nếu repo đã có hướng dẫn báo lỗi bảo mật, nhớ giữ nguyên phần đó.

D.Tình huống 4: Xuất mô hình đe doạ để họp với đội

Sau khi quét, bạn muốn gửi tài liệu mô hình đe doạ cho đồng nghiệp xem mà không chạy phân tích lại. Bạn xuất bản đã lưu:

Terminal
cs export --scan SCAN_ID --artifact threat-model --output threatmodel.md

Thay SCAN_ID bằng mã lần quét thật. Bỏ --scan thì công cụ dùng lần quét hoàn tất gần nhất của repo hiện tại. Kết quả là file threatmodel.md để bạn gửi hoặc đưa vào tài liệu nội bộ.

E.Dùng ngay trong Codex

Nếu đã bật plugin Codex Security trong một phiên Codex, bạn có thể hỏi bằng lời. Mẫu từ README:

text
Run a Codex Security scan on this repository, focusing on authentication and authorization. Return the saved report, source evidence, and coverage limits.

VI.Lỗi hay gặp và cách xử lý

A.Báo sai phiên bản Node hoặc Python

Công cụ cần Node.js và Python đúng phiên bản như phần chuẩn bị. Bạn chạy lại node --version và python --version, rồi nâng cấp nếu cần. Với Python 3.10, đừng quên gói tomli.

B.npm báo lỗi EEXIST khi cài global

Đây là xung đột tên lệnh đã có sẵn. README hướng dẫn dùng npx @openai/codex-security thay cho cs, cả khi đăng nhập lẫn khi quét. Cách này an toàn vì không ghi đè gì trên máy.

C.Lệnh cs chạy ra chương trình khác

Tên cs có thể trùng một công cụ khác trên máy. Hãy dùng tên đầy đủ codex-security thay cho cs, kết quả hoàn toàn giống nhau.

D.Không đăng nhập được trên máy chủ không có trình duyệt

Với máy chạy không giao diện (headless), README gọi tên các cách đăng nhập bằng thiết bị hoặc SSH. Bạn tìm trong tài liệu của repo. Với CI, bạn đặt OPENAI_API_KEY hoặc CODEX_API_KEY trong môi trường của tiến trình quét.

E.Lo chi phí khi quét repo lớn

Ví dụ GitHub Action trong README dùng giới hạn ước tính 5 đô la mỗi lần quét. README cũng lưu ý các yêu cầu đang chạy dở vẫn có thể vượt giới hạn. Hãy chạy cs scan --help để xem các tuỳ chọn giới hạn chi phí, và thử trên một thư mục nhỏ trước.

VII.Có nên dùng không

Điểm mạnh. Bạn cài bằng hai lệnh và quét bằng một lệnh. Công cụ có đủ chuỗi việc từ tìm, kiểm chứng đến vá và xuất báo cáo. Nó hỗ trợ CI, GitHub Action, container và SDK. Giấy phép Apache-2.0, và dự án vẫn được cập nhật.

Giới hạn. Công cụ cần Node.js và Python đúng phiên bản, cùng tài khoản hoặc khoá API của nhà cung cấp mô hình, nên có thể phát sinh chi phí. Quét bằng AI không thay thế kiểm thử bảo mật thủ công cho hệ thống quan trọng. Hãy luôn đọc phần phạm vi và loại trừ trong báo cáo, và tự xem lại bản vá trước khi đưa vào sản phẩm. README cũng ghi lệnh serve và bảng điều khiển trên trình duyệt đã bị gỡ, nên đừng tìm chúng.

Khi nào chọn cách khác. Nếu bạn cần công cụ chạy hoàn toàn ngoại tuyến, không gửi gì tới nhà cung cấp mô hình, hãy xem kỹ tài liệu về cách hoạt động trước khi dùng. Nếu chỉ cần rà soát thư viện phụ thuộc, hoặc nhóm đã có công cụ quét chuyên dụng, bạn vẫn có thể dùng Codex Security như một lớp bổ sung và nhập kết quả của công cụ cũ vào để xem chung.

4.0/5 · Ông T chấm

Chưa có độc giả chấm

Bài này có ích với bạn không?

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

Codex Security có miễn phí không?

Bản thân repo dùng giấy phép Apache-2.0. Tuy nhiên để quét, công cụ cần đăng nhập hoặc khoá API của nhà cung cấp mô hình, nên chi phí phụ thuộc vào gói và mức dùng của bạn. README chưa có bảng giá. Ví dụ GitHub Action trong README đặt giới hạn ước tính 5 đô la mỗi lần quét.

Cài Codex Security cần những gì?

Bạn cần Node.js 22.13.0 trở lên trong nhánh 22.x, hoặc Node.js 24.x hoặc 26.x, và Python 3.10 trở lên. Dùng Python 3.10 thì cần thêm gói tomli. Sau đó cài bằng npm install --global @openai/codex-security và đăng nhập bằng cs login.

Có cần GPU không?

README không nhắc yêu cầu GPU. Theo mô tả, các lần quét dùng mô hình của nhà cung cấp như OpenAI hoặc Amazon Bedrock, nên có vẻ máy bạn không phải tự chạy mô hình. Tuy vậy đây là suy ra từ README, nếu cần chắc chắn thì bạn xem tài liệu trong repo.

Chạy được trên Windows không?

README mình có không nêu rõ danh sách hệ điều hành hỗ trợ. Yêu cầu chỉ ghi phiên bản Node.js và Python. Bạn nên thử lệnh cs --help sau khi cài và xem thêm tài liệu trong repo để biết chi tiết cho Windows.

Dữ liệu mã nguồn của mình có an toàn không?

README chưa mô tả chi tiết cách xử lý dữ liệu. Kết quả quét được lưu cục bộ, và Codex Security Cloud là kết nối tuỳ chọn, quét cục bộ vẫn chạy khi không có Cloud. Với mã nguồn nhạy cảm, bạn nên đọc kỹ tài liệu và chính sách của nhà cung cấp mô hình bạn chọn trước khi quét.

Dùng được với nhà cung cấp mô hình khác ngoài OpenAI không?

Có. README nêu các nhà cung cấp được hỗ trợ gồm 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. Với ba nhà cung cấp còn lại, bạn đặt khoá API của họ và chọn mô hình được hỗ trợ.

Dùng trong CI hoặc GitHub Actions thế nào?

Với CI, bạn đặt OPENAI_API_KEY hoặc CODEX_API_KEY trong môi trường của tiến trình quét. Với GitHub Actions, bạn thêm secret CODEX_SECURITY_API_KEY, chép workflow mẫu hằng tuần vào .github/workflows/codex-security.yml và thay REPLACE_WITH_REVIEWED_COMMIT bằng mã commit đã duyệt của bản phát hành Action.

Chuyển nhanh tới mục

  1. I.Codex Security làm được gì
  2. II.Cần chuẩn bị gì
  3. III.Cài đặt từng bước
    1. A.Kiểm tra Node.js và Python
    2. B.Cài CLI
    3. C.Đăng nhập
    4. D.Chạy lần quét đầu tiên
    5. E.Muốn dùng mà không cài toàn máy
    6. F.Cài SDK TypeScript (nếu cần)
  4. IV.Kiểm tra đã chạy được chưa
  5. V.Dùng vào việc thật
    1. A.Tình huống 1: Rà soát toàn bộ dự án trước khi ra mắt
    2. B.Tình huống 2: Kiểm tra thay đổi trước khi gộp code
    3. C.Tình huống 3: Viết chính sách bảo mật SECURITY.md
    4. D.Tình huống 4: Xuất mô hình đe doạ để họp với đội
    5. E.Dùng ngay trong Codex
  6. VI.Lỗi hay gặp và cách xử lý
    1. A.Báo sai phiên bản Node hoặc Python
    2. B.npm báo lỗi EEXIST khi cài global
    3. C.Lệnh cs chạy ra chương trình khác
    4. D.Không đăng nhập được trên máy chủ không có trình duyệt
    5. E.Lo chi phí khi quét repo lớn
  7. VII.Có nên dùng không

Repo & Skill · 13/11/2026 · 11 phút đọc

Garden Skills: bộ skill thiết kế web, tạo ảnh, làm video cho AI — hướng dẫn cài đặt và dùng

Garden Skills là bộ sưu tập Agent Skills (kỹ năng cho AI) của tác giả ConardLi, dùng được với Claude Code, Cursor, Codex và các AI coding agent khác. Mỗi skill dạy agent làm tốt một việc như thiết kế trang web, tạo ảnh, làm video bằng code, biến tài liệu thành bài viết đẹp. Cài không khó, nhưng README có nhiều cách cài nên bạn cần chọn một cách hợp với công cụ đang dùng.

Repo & Skill · 13/11/2026 · 15 phút đọc

thesysdev/openui: xây giao diện AI dạng streaming — hướng dẫn cài đặt và dùng

OpenUI là framework full-stack, độc lập framework, giúp mô hình AI sinh giao diện có cấu trúc và hiển thị dần khi dữ liệu streaming về. Bạn có thể dựng nhanh một ứng dụng chat bằng CLI hoặc cài từng gói cho React, Vue, Svelte, Angular và LangChain. Việc bắt đầu khá đơn giản nếu máy có đúng phiên bản Node; README chưa ghi đầy đủ lệnh chạy ứng dụng sau khi scaffold.

Repo & Skill · 13/11/2026 · 11 phút đọc

Ruflo: điều phối nhóm agent AI cho Claude Code và Codex — hướng dẫn cài đặt và dùng

Ruflo (trước đây là Claude Flow) là một agent harness: lớp công cụ bao quanh Claude Code và Codex, bổ sung nhiều agent chuyên biệt, bộ nhớ qua các phiên và khả năng chia việc cho nhóm agent. Cài bằng một lệnh `npx ruflo@latest init` trong thư mục dự án, cần Node 20 trở lên. Cài khá dễ, nhưng hệ thống rất rộng nên bạn nên bắt đầu từ một tác vụ nhỏ.