# 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

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

- Tác giả: Ông T (https://ongt.vn/gioi-thieu)
- Chủ đề: Repo & Skill
- Đăng: 2026-10-21 · Cập nhật: 2026-11-13
- URL: https://ongt.vn/bai-viet/codex-security-quet-lo-hong-bao-mat-bang-ai

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.

```repo
- repo | openai/codex-security
- kind | CLI
- desc | 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á.
- stars | 13k
- lang | TypeScript
- license | Apache-2.0
```

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

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

```note
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.
```

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

```steps
- Kiểm tra môi trường | Chắc chắn máy có Node.js và Python đúng phiên bản
- Cài CLI | Chạy npm install --global để có lệnh cs
- Đăng nhập | Chạy cs login
- Quét lần đầu | Vào thư mục dự án và chạy cs scan .
- Đọc báo cáo | Mở file Markdown ở đường dẫn REPORT
```

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

```bash
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`.

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

```bash
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.

### Đăng nhập

```bash
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.

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

```bash
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.

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

```bash
# 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`.

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

```bash
npm install @openai/codex-security
```

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

```ts
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.

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

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

### 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:

```bash
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

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

### 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:

```bash
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.

### 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:

```bash
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.

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

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

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

### 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ạ.

### Đă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.

### 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í.

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