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 — hướng dẫn cài đặt và dùng

11 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 — 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.

CLI

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á.

★ 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 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 policy soạn bản nháp SECURITY.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 login dù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_KEY hoặc CODEX_API_KEY trong môi trường của tiến trình quét. Với GitHub Actions, README dùng secret tên CODEX_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

  1. Kiểm tra môi trườngChắc chắn máy có Node.js và Python đúng phiên bản
  2. Cài CLIChạy npm install --global để có lệnh cs
  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 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.

Terminal
node --version
python --version

Nế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.

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

Chỗ 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

Terminal
cs login

Là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.

Terminal
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.

Terminal
# 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 deep

Lệ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.

Terminal
npm install @openai/codex-security

Sau đó dùng đoạn code mẫu trong README:

TypeScript
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 --help hiệ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 show trong 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:

Terminal
cs scan . --diff origin/main

Kế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:

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

Lệ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:

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

Thay 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.

4.9/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?

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.

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 toàn cục
    3. C.Đăng nhập
    4. D.Chạy lần quét đầu tiên
    5. E.Các tuỳ chọn quét hay dùng
    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.Dev kiểm tra code mới trước khi gộp nhánh
    2. B.Chủ sản phẩm quét tập trung vào đăng nhập và phân quyền
    3. C.Nhóm nhỏ viết chính sách bảo mật cho repo
    4. D.Xuất mô hình đe dọa để gửi cho người khác xem
  6. VI.Lỗi hay gặp và cách xử lý
    1. A.Gõ cs báo không tìm thấy lệnh
    2. B.npm báo lỗi EEXIST khi cài
    3. C.Báo thiếu phiên bản Node.js hoặc Python
    4. D.Đăng nhập không được trên máy chủ không có trình duyệt
    5. E.Quét tốn quá lâu hoặc vượt ngân sách
  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ỏ.