canonical_url: https://yycode.net/docs/vi/codex-quickstart
lang: vi
updated_at: 2026-07-04T13:33:48.616Z
source_html: https://yycode.net/docs/vi/codex-quickstart

# Hướng dẫn bắt đầu nhanh yycode × Codex

## Điều kiện tiên quyết: cài đặt môi trường Node.js

Codex phụ thuộc vào môi trường chạy Node.js, vui lòng tham khảo [Hướng dẫn cài đặt môi trường Node.js](nodejs-setup) để hoàn tất cài đặt và xác minh.

## Cách tiện hơn: cấu hình tự động

Nếu bạn không muốn cài đặt thủ công và viết từng cấu hình, khuyến nghị dùng trực tiếp [công cụ cấu hình tự động](auto-config-tool).

---

## 1. Cài đặt Codex

```bash
# Windows
npm install -g @openai/codex@latest

# macOS / Linux
sudo npm install -g @openai/codex@latest
```

Xác minh cài đặt:

```bash
codex --version
```

Nếu xuất ra số phiên bản, tức là cài đặt thành công.

---

## 2. Tạo API Key

Đăng nhập [bảng điều khiển yycode](https://yycode.net/console/token), vào trang **Quản lý token**, nhấp **Thêm token**.

![](https://r2.yycode.net/yycode/i9bq1Ik.png)
![](https://r2.yycode.net/yycode/9KXR1Ik.png)

Điền tên khóa, chọn nhóm Codex (mô hình và hệ số), cấu hình giới hạn IP, giới hạn hạn mức, giới hạn mô hình và thời hạn hiệu lực theo nhu cầu. Người mới nên dùng trực tiếp cấu hình mặc định.

> **Lưu ý bảo mật**: API Key tương đương thông tin xác thực tài khoản, hãy bảo quản cẩn thận, tuyệt đối không commit vào kho mã hoặc chia sẻ công khai.

---

## 3. Nhập khóa vào Codex



#### Tạo thư mục cấu hình

```powershell
# Windows (PowerShell)
if (Test-Path "$env:USERPROFILE\.codex") { Remove-Item -Recurse -Force "$env:USERPROFILE\.codex" }
mkdir "$env:USERPROFILE\.codex"
```

```bash
# macOS / Linux
rm -rf ~/.codex && mkdir -p ~/.codex
```

#### Tạo `config.toml`

Tạo `config.toml` trong thư mục `~/.codex/` (trên Windows là `%USERPROFILE%\.codex\`):

```toml
model = "gpt-5.5"
model_provider = "yycode"

[model_providers.yycode]
name = "yycode New API"
base_url = "https://yycode.net/v1"
wire_api = "responses"
requires_openai_auth = true
```

#### Tạo `auth.json`

Nhấp nút **Sao chép** cạnh khóa để lấy API Key:

![](https://r2.yycode.net/yycode/EDOv1Ik.png)

Tạo `auth.json` trong cùng thư mục, thay `YOUR_API_KEY` bằng khóa bạn đã tạo trong bảng điều khiển:

```json
{
  "auth_mode": "apikey",
  "OPENAI_API_KEY": "这里填你在平台创建的 API Key"
}
```

---

## 4. Bắt đầu sử dụng

Vào bất kỳ thư mục dự án nào, chạy:

```bash
codex
```

Codex sẽ tự động phân tích mã trong thư mục hiện tại và cung cấp hỗ trợ lập trình thông minh. Cách dùng thêm vui lòng tham khảo [tài liệu chính thức OpenAI](https://github.com/openai/codex).

---

## Câu hỏi thường gặp (FAQ)

**Q: Chạy `npm install -g` báo không đủ quyền?**
A: macOS / Linux thêm `sudo` trước lệnh; Windows chạy PowerShell với quyền quản trị viên.

**Q: `codex --version` báo không tìm thấy lệnh?**
A: Xác nhận thư mục global của npm đã được thêm vào `PATH` hệ thống; có thể chạy `npm bin -g` để xem đường dẫn rồi thêm thủ công.

**Q: Kết nối thất bại hoặc trả về lỗi 401?**
A: Kiểm tra `base_url` trong `config.toml` có phải `https://yycode.net` không, và API Key trong `auth.json` có đúng và chưa hết hạn không.

**Q: Làm sao chuyển mô hình hoặc hệ số khác?**
A: Tạo khóa thuộc nhóm khác trong [bảng điều khiển yycode](https://yycode.net/console/token), cập nhật Key trong `auth.json`, hoặc dùng CC Switch để nhanh chóng chuyển giữa nhiều cấu hình.