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

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

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.

```repo
- repo | openai/codex-security
- kind | CLI
- desc | 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.
- 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, 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.

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

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

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

```steps
- Kiểm tra môi trường | Xem Node.js và Python đã đúng phiên bản chưa
- Cài CLI | Cài gói @openai/codex-security bằng npm
- Đă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 hoặc Linux). Gõ hai lệnh sau để xem phiên bản đang có:

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

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

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

### Đăng nhập

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

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

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

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

```bash
npx @openai/codex-security login
npx @openai/codex-security scan .
```

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

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

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

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

```bash
cs scans show
```

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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