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

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

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

Claude Code 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ấu hình Claude Code

### Bước 1: Cài đặt Claude Code

```bash
npm install -g @anthropic-ai/claude-code
```

Khi macOS / Linux gặp vấn đề quyền hạn, thêm `sudo`:

```bash
sudo npm install -g @anthropic-ai/claude-code
```

Xác minh cài đặt:

```bash
claude --version
```

---

### Bước 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 (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.

---

### Bước 3: Nhập khóa vào Claude Code


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

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

Cần thiết lập hai biến môi trường sau:

| Tên biến | Giá trị |
|---|---|
| `ANTHROPIC_BASE_URL` | `https://yycode.net` |
| `ANTHROPIC_AUTH_TOKEN` | API Key của bạn |

**Thiết lập tạm thời (có hiệu lực trong phiên terminal hiện tại)**

Windows (PowerShell):
```powershell
$env:ANTHROPIC_BASE_URL = "https://yycode.net"
$env:ANTHROPIC_AUTH_TOKEN = "YOUR_API_KEY"
```

macOS / Linux:
```bash
export ANTHROPIC_BASE_URL="https://yycode.net"
export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"
```

**Thiết lập vĩnh viễn (vẫn có hiệu lực sau khi khởi động lại)**

Windows (PowerShell):
```powershell
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://yycode.net", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "YOUR_API_KEY", [System.EnvironmentVariableTarget]::User)
```

macOS (Zsh):
```bash
echo 'export ANTHROPIC_BASE_URL="https://yycode.net"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"' >> ~/.zshrc
source ~/.zshrc
```

Linux (Bash):
```bash
echo 'export ANTHROPIC_BASE_URL="https://yycode.net"' >> ~/.bashrc
echo 'export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"' >> ~/.bashrc
source ~/.bashrc
```

---

### Bước 4: Bắt đầu sử dụng

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

```bash
claude
```

Claude Code 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â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: `claude --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 `ANTHROPIC_BASE_URL` có phải `https://yycode.net` không, và `ANTHROPIC_AUTH_TOKEN` có điền đú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)) và dùng CC Switch để nhanh chóng chuyển giữa nhiều cấu hình.