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

11 phút đọcCập nhật
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 để tìm, kiểm chứng và sửa 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ụ bảo mật mã nguồn của OpenAI. Nó giúp bạn tìm lỗ hổng trong code, kiểm tra xem lỗi đó có thật không, rồi đề xuất bản vá. Bạn dùng nó theo ba cách: nhờ trong một phiên Codex, gõ lệnh cs trong terminal, hoặc gọi bằng SDK TypeScript và GitHub Action khi muốn tự động hoá.

Repo này hợp với lập trình viên, nhóm làm sản phẩm nhỏ, hoặc người phụ trách kỹ thuật trong doanh nghiệp. Họ muốn có người "rà soát bảo mật" cho code mà không có sẵn chuyên gia. Bạn không cần hiểu sâu về an ninh mạng để chạy lần quét đầu tiên. Chỉ cần một thư mục dự án và một tài khoản đăng nhập được.

Điều đáng giá nhất là công cụ không dừng ở việc liệt kê cảnh báo. Nó có các bước kiểm chứng phát hiện, tạo bản vá và xác nhận bản sửa có hiệu quả. Kết quả cuối cùng là một file báo cáo Markdown có dẫn chứng từ mã nguồn, và có ghi rõ phần nào chưa được quét. Hiện repo có khoảng 12.353 sao và 974 fork, giấy phép Apache-2.0, và vẫn được cập nhật trong 3 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, kiểm chứng lỗ hổng bảo mật, tạo bản vá và xuất báo cáo.

★ 12kTypeScriptApache-2.0
Xem repo trên GitHub

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

A.Quét theo phạm vi bạn chọn

Bạn có thể quét cả repo, chỉ vài thư mục, hoặc chỉ những thay đổi Git so với một nhánh gốc. Có hai chế độ: Standard và Deep. Deep lặp lại các lần quét Standard rồi trả về danh sách phát hiện đã loại trùng. Lợi ích thực tế: khi code lớn, bạn không phải quét lại tất cả mỗi lần, mà chỉ quét phần vừa sửa.

B.Kiểm chứng, vá và xác minh bản sửa

Công cụ kiểm chứng các phát hiện ứng viên để bớt báo động giả. Nó cũng tạo bản vá và kiểm tra những bản sửa có sẵn. Với người không chuyên, đây là phần tiết kiệm thời gian nhất, vì bạn không phải tự đoán cảnh báo nào đáng lo.

C.Soạn SECURITY.md và lưu mô hình mối đe doạ

Lệnh policy giúp soạn mới hoặc cập nhật file SECURITY.md cho repo. Các lần quét và soạn chính sách đều lưu lại mô hình mối đe doạ (threat model), và bạn có thể xuất ra file Markdown để xem lại hoặc chia sẻ cho nhóm.

D.Quản lý kết quả đã lưu

Bạn xem lại các lần quét và phát hiện đã lưu, 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 và lịch sử Git. Nhờ vậy báo cáo biến thành việc cụ thể giao cho đúng người.

E.Nhập kết quả từ công cụ khác và xuất ra hệ thống theo dõi

Bạn xem trước phát hiện từ các công cụ quét bên thứ ba, lưu cục bộ hoặc đăng lên Codex Security Cloud (với báo cáo được hỗ trợ). Kết quả có thể được theo dõi trên Linear, Jira hoặc GitHub, hoặc xuất ra SARIF, JSON và CSV. Có cả hướng dẫn xuất sang ServiceNow Application Vulnerability Response.

F.Tự động hoá trong CI và container

Repo có GitHub Action, cấu hình Docker Compose để quét hàng loạt nhiều repo, và hỗ trợ nhiều nhà cung cấp mô hình: OpenAI, 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 Python 3.10 thì cần thêm gói tomli.
  • Đăng nhập: chạy cs login sau khi cài. Với máy không có màn hình, README nhắc đến đăng nhập bằng thiết bị hoặc SSH (xem tài liệu trong repo).
  • Khoá API cho CI: đặ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 Action, dùng secret tên CODEX_SECURITY_API_KEY.
  • Amazon Bedrock: dùng thông tin xác thực AWS, không cần đăng nhập OpenAI riêng.

Tư liệu không nêu yêu cầu về GPU hay cấu hình máy cụ thể. Có đề cập rằng một số yêu cầu an ninh mạng và phát hiện được bảo vệ cần Trusted Access for Cyber.

Quét code gọi mô hình AI nên có thể phát sinh chi phí theo tài khoản hoặc API key bạn dùng. Ví dụ GitHub Action trong README đặt hạn mức ước tính 5 USD mỗi lần quét, nhưng các yêu cầu đang chạy vẫn có thể vượt hạn mức. Đừng dán API key vào file trong repo; hãy dùng biến môi trường hoặc secret.

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

  1. Kiểm tra môi trườngĐảm bảo có Node.js và Python đúng phiên bản
  2. Cài CLICài gói @openai/codex-security toàn cục bằng npm
  3. Đăng nhậpChạy cs login để xác thực
  4. Quét thửChạy cs scan . trong thư mục dự án
  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 dưới để xem phiên bản. Hai lệnh này là lệnh phổ thông, không nằm trong README.

Terminal
node --version
python --version

Node phải thuộc dải README nêu ở trên, Python từ 3.10 trở lên. Nếu máy dùng lệnh python3 thì gõ python3 --version. Người mới hay vấp ở đây: máy có Node bản cũ nên lệnh cài báo lỗi hoặc chạy sai.

B.Cài CLI toàn cục

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

Lệnh này cài chương trình để bạn gọi được cs ở bất cứ thư mục nào. Chạy ở đâu cũng được. README cho biết cs và codex-security là cùng một CLI. Nếu tên cs trùng với lệnh khác trên máy, hãy dùng codex-security.

C.Đăng nhập

Terminal
cs login

Làm theo hướng dẫn trên màn hình. Nếu máy không có trình duyệt (máy chủ, SSH), xem phần "device or SSH login" trong tài liệu của repo.

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

Dùng cd vào thư mục repo bạn muốn quét, rồi chạy:

Terminal
cs scan .

Dấu chấm nghĩa là quét thư mục hiện tại. Khi xong, terminal in ra đường dẫn REPORT. Mở file Markdown ở đường dẫn đó để đọc kết quả.

E.Cách không cần cài toàn cục

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

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

Cách kiểm tra đơn giản nhất là chạy lệnh trợ giúp:

Terminal
cs --help

Nếu terminal in danh sách lệnh thì CLI đã cài xong. Để biết các tuỳ chọn quét, hạn mức chi phí và việc vá sau khi quét, gõ cs scan --help.

Bước kiểm tra thật sự là chạy cs scan . rồi xem kết quả. Theo README, khi quét xong bạn mở file Markdown ở đường dẫn REPORT. Sau này, nếu muốn tìm lại lần quét mới nhất của repo, chạy lệnh sau trong cùng thư mục repo:

Terminal
cs scans show

Báo cáo có phần bằng chứng từ mã nguồn và phần loại trừ (những gì chưa được quét). Đọc phần loại trừ cho kỹ để biết lần quét bao phủ đến đâu.

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

A.Chủ sản phẩm nhỏ muốn rà trước khi ra mắt

Bạn có một web app nhỏ do vài người làm, sắp cho khách dùng thật. Bạn chưa có chuyên gia bảo mật. Hãy vào thư mục dự án và quét toàn bộ:

Terminal
cs scan .

Sau đó mở file báo cáo. Bạn nhận được danh sách phát hiện kèm bằng chứng trong code và phần ghi chú phạm vi quét. Nếu muốn quét sâu hơn, thêm chế độ Deep:

Terminal
cs scan . --mode deep

Quét xong không chỉ có cảnh báo, bạn còn có bằng chứng trong code và ghi chú rõ phần nào chưa được kiểm tra.

Ông T

B.Lập trình viên muốn kiểm tra riêng phần vừa sửa

Bạn vừa làm xong một nhánh tính năng và muốn rà trước khi gộp. Quét chỉ các thay đổi đã commit so với nhánh gốc:

Terminal
cs scan . --diff origin/main

Nếu chỉ quan tâm vài thư mục, chỉ định đường dẫn:

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

Kết quả là báo cáo gọn hơn, tập trung vào phần bạn vừa động tới. Bạn cũng có thể giới hạn thời gian bằng cs scan . --max-time 15, là khoảng thời gian điều tra tham khảo 15 phút cho chế độ Standard.

C.Nhóm cần có SECURITY.md cho repo

Bạn phụ trách một repo mã nguồn mở nhỏ và chưa có chính sách báo lỗi bảo mật. Chạy:

Terminal
cs policy .

Lệnh lưu bản nháp ở ngoài repo và không đụng vào file hiện có. Bạn xem bản nháp cùng ghi chú, chỉnh sửa, rồi chỉ chép file SECURITY.md vào Policy target mà lệnh hiển thị. Nếu repo có nhiều thành phần, chọn riêng từng phần:

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

Các lần quét sau sẽ dùng chính file SECURITY.md này làm hướng dẫn.

D.Xuất mô hình mối đe doạ để họp với nhóm

Sau khi quét, bạn muốn đưa mô hình mối đe doạ vào tài liệu nội bộ để cả nhóm xem. Xuất ra file Markdown mà không phải phân tích lại:

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

Thay SCAN_ID bằng mã lần quét bạn cần. Bỏ --scan thì lệnh dùng lần quét hoàn tất gần nhất của repo hiện tại.

E.Dùng ngay trong phiên Codex

Nếu bạn đã dùng Codex, mở repo trong phiên có bật plugin Codex Security rồi nhờ bằng ngôn ngữ thường. Câu mẫu theo README:

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

Quét xong, bạn đọc báo cáo, rồi nhờ Codex tạo bản vá hoặc xác minh một bản sửa có sẵn.

F.Dùng trong lập trình bằng SDK TypeScript

Với dự án TypeScript, cài gói cục bộ:

Terminal
npm install @openai/codex-security

Rồi gọi trong code:

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 mã quét một repo và in đường dẫn báo cáo. Hãy luôn gọi close() ở khối finally, như mẫu.

G.Quét hằng tuần bằng GitHub Actions

README mô tả ba bước để chạy quét hằng tuần trên Ubuntu do GitHub cung cấp: thêm khoá API OpenAI làm secret CODEX_SECURITY_API_KEY của repo; chép workflow mẫu vào .github/workflows/codex-security.yml và thay REPLACE_WITH_REVIEWED_COMMIT bằng mã SHA của bản phát hành Action đã được bạn xem xét; rồi vào Actions → Codex Security repository → Run workflow để chạy thử. Ví dụ này chỉ báo cáo phát hiện mà không làm job thất bại. Muốn đặt ngưỡng mức độ nghiêm trọng hay kiểm tra trên pull request, xem hướng dẫn Action trong repo.

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

A.Lệnh cs không nhận ra hoặc trùng tên lệnh khác

Sau khi cài toàn cục, terminal có thể báo không tìm thấy cs, hoặc cs chạy ra chương trình khác. Hãy mở lại terminal. Nếu vẫn trùng tên, dùng codex-security thay cho cs như README gợi ý, hoặc dùng npx @openai/codex-security.

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

Đây là lỗi README có nhắc. Cách xử lý an toàn là không cài toàn cục mà dùng npx @openai/codex-security thay cho cs, cả lúc đăng nhập lẫn lúc quét.

C.Phiên bản Node hoặc Python không đúng

Nếu cài hoặc chạy báo lỗi lạ, kiểm tra lại bằng node --version và python --version. Node phải đúng dải README ghi, Python từ 3.10. Với Python 3.10, đừng quên cài thêm tomli. Nâng phiên bản cho đúng trước rồi mới cài lại.

D.Đăng nhập không được trên máy chủ không có màn hình

Trên máy chủ hoặc kết nối SSH, đăng nhập bằng trình duyệt thường không mở được. README có nhắc đăng nhập bằng thiết bị hoặc SSH; hãy xem phần đó trong tài liệu. Với CI thì đặt OPENAI_API_KEY hoặc CODEX_API_KEY trong môi trường của tiến trình quét thay vì đăng nhập.

E.Báo cáo thiếu một số phần mình mong đợi

Đừng vội kết luận code sạch. Mở phần loại trừ và giới hạn phạm vi trong báo cáo để xem phần nào chưa được quét. Có thể bạn đã giới hạn bằng --path hoặc --diff, hoặc cần chạy --mode deep. Với một số yêu cầu an ninh mạng, README cho biết có thể cần Trusted Access for Cyber.

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

Điểm mạnh. Bạn có cả chuỗi việc: quét, kiểm chứng, vá, xác minh, rồi xuất báo cáo. Lệnh đơn giản, dùng được ở terminal, trong Codex, trong code TypeScript và trong CI. Hỗ trợ nhiều nhà cung cấp mô hình, xuất được SARIF, JSON, CSV và kết nối Linear, Jira, GitHub. Giấy phép Apache-2.0 và repo cò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ần đăng nhập hoặc API key, và việc quét có thể tốn chi phí. Kết quả do AI tạo ra nên vẫn cần người xem lại trước khi áp bản vá vào code thật. Báo cáo cũng nói rõ phạm vi quét, nên đừng coi một lần quét là bảo đảm tuyệt đối. Ngoài ra README cho biết lệnh serve và bảng điều khiển trên trình duyệt đã bị gỡ bỏ, dù dữ liệu và kết quả quét cũ vẫn còn.

Khi nên chọn cách khác. Nếu bạn không thể gửi mã nguồn tới dịch vụ AI vì quy định nội bộ, hãy hỏi bộ phận pháp lý hoặc bảo mật trước. Tư liệu chưa nói rõ về xử lý dữ liệu theo từng nhà cung cấp. Nếu bạn cần kiểm thử xâm nhập chuyên sâu hay đánh giá tuân thủ chính thức, một công cụ AI không thay thế được chuyên gia. Còn nếu chỉ muốn một lần rà soát nhanh trước khi ra mắt, hoặc muốn gắn quét bảo mật vào quy trình hằng tuần, đây là lựa chọn đáng thử.

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 nên mã nguồn mở. Tuy nhiên việc quét gọi mô hình AI qua tài khoản hoặc API key của bạn, nên có thể phát sinh chi phí theo gói đó. Tư liệu chưa nêu bảng giá cụ thể.

Cần GPU để chạy không?

Tư liệu không nêu yêu cầu GPU hay cấu hình phần cứng riêng. Yêu cầu được ghi là Node.js (22.13.0+ trong 22.x, hoặc 24.x, 26.x) và Python 3.10+. Phần phân tích do dịch vụ mô hình bạn chọn xử lý.

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

README không liệt kê hệ điều hành cụ thể. Nó chỉ nêu yêu cầu Node.js và Python, và cách cài là lệnh npm thông thường. Tư liệu chưa khẳng định rõ về Windows, nên bạn nên thử và xem phần tài liệu trong repo.

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

README cho biết kết quả quét và mô hình mối đe doạ được lưu cục bộ, và chế độ cloud là tuỳ chọn: quét cục bộ vẫn chạy khi không dùng Cloud. Tuy vậy mã của bạn vẫn được phân tích bởi nhà cung cấp mô hình bạn chọn. Tư liệu chưa có chi tiết về chính sách dữ liệu, nên hãy kiểm tra điều khoản của nhà cung cấp.

Có dùng được mô hình ngoài OpenAI không?

Có. README nói việc quét hỗ trợ OpenAI, Amazon Bedrock, OpenRouter, Fireworks AI và Cheaper Inference. Bedrock dùng thông tin AWS và không cần đăng nhập OpenAI riêng. Các nhà cung cấp còn lại cần đặt API key riêng của họ.

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

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. Với GitHub Action, thêm secret CODEX_SECURITY_API_KEY và chép workflow mẫu vào .github/workflows/codex-security.yml. Ví dụ trong README chạy quét hằng tuần với hạn mức ước tính 5 USD mỗi lần.

Quét nhiều repo cùng lúc được không?

Được. README đề cập quét hàng loạt bằng cấu hình Docker Compose đi kèm, giữ kết quả và đăng nhập giữa các lần chạy. Tư liệu cũng nhắc việc rà soát một hệ thống trải trên nhiều repo, nhưng các lệnh chi tiết nằm trong tài liệu của repo và chưa có trong tư liệu này.

Chuyển nhanh tới mục

  1. I.Codex Security làm được gì
    1. A.Quét theo phạm vi bạn chọn
    2. B.Kiểm chứng, vá và xác minh bản sửa
    3. C.Soạn SECURITY.md và lưu mô hình mối đe doạ
    4. D.Quản lý kết quả đã lưu
    5. E.Nhập kết quả từ công cụ khác và xuất ra hệ thống theo dõi
    6. F.Tự động hoá trong CI và container
  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ách không cần cài toàn cục
  4. IV.Kiểm tra đã chạy được chưa
  5. V.Dùng vào việc thật
    1. A.Chủ sản phẩm nhỏ muốn rà trước khi ra mắt
    2. B.Lập trình viên muốn kiểm tra riêng phần vừa sửa
    3. C.Nhóm cần có SECURITY.md cho repo
    4. D.Xuất mô hình mối đe doạ để họp với nhóm
    5. E.Dùng ngay trong phiên Codex
    6. F.Dùng trong lập trình bằng SDK TypeScript
    7. G.Quét hằng tuần bằng GitHub Actions
  6. VI.Lỗi hay gặp và cách xử lý
    1. A.Lệnh cs không nhận ra hoặc trùng tên lệnh khác
    2. B.Báo lỗi EEXIST khi cài bằng npm
    3. C.Phiên bản Node hoặc Python không đúng
    4. D.Đăng nhập không được trên máy chủ không có màn hình
    5. E.Báo cáo thiếu một số phần mình mong đợi
  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ỏ.