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

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

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.

```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, kiểm chứng lỗ hổng bảo mật, tạo bản vá và xuất báo cáo.
- stars | 12k
- lang | TypeScript
- license | Apache-2.0
```

## Codex Security làm được gì

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

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

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

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

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

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

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

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

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

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

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

### Cài CLI toàn cục

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

### Đăng nhập

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

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

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

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

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

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

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

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

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

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

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

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

```bash
cs scan . --diff origin/main
```

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

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

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

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

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

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

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

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

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

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

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

Rồi gọi trong code:

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

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

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

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

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

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

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

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

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