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

# Công cụ cấu hình tự động YYCode

Tài liệu này giải quyết một việc: dùng một lệnh để cài đặt `Claude Code` hoặc `Codex` và kết nối vào `YYCode`; ngay cả khi máy của bạn chưa có Node.js, bạn vẫn có thể tiếp tục.

---

## 1. Tạo API Key

Trong quá trình chạy script, hệ thống sẽ nhắc bạn nhập API Key, vì vậy hãy tạo sẵn trong bảng điều khiển YYCode trước.

Đă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, rồi chọn nhóm theo công cụ muốn sử dụng:

- Cấu hình **Claude Code**: chọn nhóm liên quan đến Claude
- Cấu hình **Codex**: chọn nhóm `codex`
- Cấu hình cả hai: cần tạo riêng hai Key, mỗi Key tương ứng với một nhóm ở trên

Whitelist IP, giới hạn hạn mức, giới hạn mô hình và thời gian hết hạn có thể cấu hình theo nhu cầu; người mới nên dùng trực tiếp cấu hình mặc định.

Sau khi tạo xong, nhấp nút **Sao chép** cạnh khóa trong danh sách để lấy API Key đầy đủ, lát nữa dán vào tương tác của script.

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

---

## 2. Cách dùng khuyến nghị

### macOS / Linux

Chạy trực tiếp:

```bash
curl -fsSL https://yycode.net/auto-config/install.sh | bash
```

Script sẽ tự động hoàn tất các thao tác sau:

- Kiểm tra hệ thống hiện tại đã có Node.js khả dụng hay chưa
- Nếu chưa có, cài runtime Node.js cục bộ vào thư mục người dùng hiện tại
- Chuyển npm mirror sang nguồn trong nước để giảm tỷ lệ tải thất bại khi không có proxy
- Cài đặt `Claude Code` và `Codex`
- Ghi các file cấu hình tương ứng
- Cuối cùng chạy kiểm tra phiên bản để xác nhận lệnh có thể chạy

### Windows PowerShell

Chạy trực tiếp:

```powershell
irm https://yycode.net/auto-config/install.ps1 | iex
```

---

## 3. Tham số thường dùng

Nếu bạn muốn chạy hoàn toàn không tương tác, có thể viết thẳng tham số vào lệnh.

> **Lưu ý:** Claude Code và Codex dùng API Key khác nhau; khi cấu hình `all`, cần cung cấp riêng hai Key.

### Chỉ cấu hình Claude Code

macOS / Linux:

```bash
curl -fsSL https://yycode.net/auto-config/install.sh | bash -s -- --api-key YOUR_CLAUDE_KEY --tools claude
```

Windows PowerShell (chế độ pipe truyền tham số qua biến môi trường):

```powershell
$env:YYCODE_CLAUDE_API_KEY='YOUR_CLAUDE_KEY'; $env:YYCODE_TOOLS='claude'; irm https://yycode.net/auto-config/install.ps1 | iex
```

Windows PowerShell (tải xuống rồi chạy trực tiếp):

```powershell
.\install.ps1 --api-key YOUR_CLAUDE_KEY --tools claude
```

### Chỉ cấu hình Codex

macOS / Linux:

```bash
curl -fsSL https://yycode.net/auto-config/install.sh | bash -s -- --codex-api-key YOUR_CODEX_KEY --tools codex
```

Windows PowerShell (chế độ pipe):

```powershell
$env:YYCODE_CODEX_API_KEY='YOUR_CODEX_KEY'; $env:YYCODE_TOOLS='codex'; irm https://yycode.net/auto-config/install.ps1 | iex
```

Windows PowerShell (tải xuống rồi chạy trực tiếp):

```powershell
.\install.ps1 --codex-api-key YOUR_CODEX_KEY --tools codex
```

### Cấu hình đồng thời Claude Code và Codex

macOS / Linux:

```bash
curl -fsSL https://yycode.net/auto-config/install.sh | bash -s -- --api-key YOUR_CLAUDE_KEY --codex-api-key YOUR_CODEX_KEY
```

Windows PowerShell (chế độ pipe):

```powershell
$env:YYCODE_CLAUDE_API_KEY='YOUR_CLAUDE_KEY'; $env:YYCODE_CODEX_API_KEY='YOUR_CODEX_KEY'; irm https://yycode.net/auto-config/install.ps1 | iex
```

Windows PowerShell (tải xuống rồi chạy trực tiếp):

```powershell
.\install.ps1 --api-key YOUR_CLAUDE_KEY --codex-api-key YOUR_CODEX_KEY
```

### Tùy chỉnh địa chỉ API

Nếu bạn triển khai tên miền tùy chỉnh, có thể ghi đè địa chỉ mặc định:

```bash
curl -fsSL https://yycode.net/auto-config/install.sh | bash -s -- --api-key YOUR_CLAUDE_KEY --base-url https://your-domain.example.com
```

---

## 4. Script sẽ ghi những file nào

### Claude Code

Script sẽ ghi:

```text
~/.claude/settings.json
```

Các trường cốt lõi như sau:

```json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://yycode.net",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY"
  }
}
```

### Codex

Script sẽ ghi:

```text
~/.codex/auth.json
~/.codex/config.toml
```

`auth.json`:

```json
{
  "auth_mode": "apikey",
  "OPENAI_API_KEY": "YOUR_API_KEY"
}
```

`config.toml`:

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

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

---

## 5. Không cần quyền quản trị viên sao?

Mặc định là không cần.

Script ưu tiên dùng Node.js đã có trong hệ thống; nếu không có, sẽ cài Node.js vào thư mục người dùng hiện tại:

- macOS / Linux: `~/.yycode/node`
- Windows: `%USERPROFILE%\.yycode\node`

Gói client cũng sẽ được cài vào thư mục người dùng hiện tại, không phải thư mục global của hệ thống.

---

## 6. Sau lần chạy đầu tiên cần làm gì?

### macOS / Linux

Sau khi script kết thúc, khuyến nghị chạy:

```bash
source ~/.zshrc
```

Nếu bạn không dùng `zsh`, hãy chạy `source` theo file profile thực tế mà script in ra ở cuối.

### Windows

Chỉ cần mở lại một cửa sổ PowerShell mới.

---

## 7. Làm sao xác nhận đã thành công?

### Claude Code

```bash
claude --version
```

### Codex

```bash
codex --version
```

Chỉ cần lệnh có thể xuất ra số phiên bản, thông thường nghĩa là chuỗi cài đặt đã thông.

---

## 8. Sao lưu và rollback

Nếu máy của bạn đã có cấu hình cũ, script sẽ tự động tạo bản sao lưu `.bak` trước lần ghi đè đầu tiên, ví dụ:

- `~/.claude/settings.json.bak`
- `~/.codex/auth.json.bak`
- `~/.codex/config.toml.bak`

Nếu cần rollback, chỉ cần khôi phục file `.bak` tương ứng.

---

## 9. Câu hỏi thường gặp

### Windows báo cần git-bash

Claude Code trên Windows phụ thuộc vào git-bash để chạy. Script sẽ tự động kiểm tra và cài Git for Windows (ưu tiên tải từ mirror npmmirror trong nước), không cần thao tác thủ công.

### Chế độ pipe Windows (`irm | iex`) truyền tham số thế nào?

Sau `irm ... | iex` **không thể trực tiếp nối tham số**, cần truyền bằng biến môi trường:

```powershell
$env:YYCODE_TOOLS='claude'; $env:YYCODE_CLAUDE_API_KEY='YOUR_KEY'; irm https://yycode.net/auto-config/install.ps1 | iex
```

Nếu không truyền biến môi trường, script sẽ tương tác hỏi API Key.

### Không có proxy, script có chạy được không?

Script mặc định ưu tiên dùng mirror trong nước:

- Node.js ưu tiên tải từ `npmmirror`
- npm registry mặc định chuyển sang `https://registry.npmmirror.com`

Nếu mirror thất bại, script còn thử lại bằng nguồn chính thức.

### Tôi chỉ muốn ghi cấu hình, không muốn cài client

Có thể thêm:

```bash
--skip-client-install
```

Phù hợp khi bạn đã cài sẵn `claude` hoặc `codex` và chỉ muốn ghi lại file cấu hình.

### Địa chỉ API không phải `https://yycode.net`

Dùng `--base-url` để ghi đè là được.

### Cấu hình cũ bị ghi đè thì làm sao?

Ưu tiên kiểm tra file sao lưu `.bak` trong cùng thư mục; phiên bản đầu của script đã chừa đường rollback cho việc ghi đè cấu hình.

---

## 10. Bước tiếp theo

- Muốn xem cài đặt thủ công và giải thích từng bước: tiếp tục xem [Hướng dẫn bắt đầu nhanh Claude Code](claude-code-quickstart) và [Hướng dẫn bắt đầu nhanh Codex](codex-quickstart)
- Chưa chuẩn bị xong môi trường local: xem [Hướng dẫn cài đặt môi trường Node.js](nodejs-setup)
- Gặp vấn đề thường gặp khác: xem [Câu hỏi thường gặp](faq)