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 để 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.

1. Cấu hình Claude Code

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

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

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

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

Xác minh cài đặt:

claude --version

Bước 2: Tạo API Key

Đăng nhập bảng điều khiển yycode, vào trang Quản lý token, nhấp Thêm token.

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

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

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

Windows (PowerShell):

$env:ANTHROPIC_BASE_URL = "https://yycode.net"
$env:ANTHROPIC_AUTH_TOKEN = "YOUR_API_KEY"

macOS / Linux:

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

[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):

echo 'export ANTHROPIC_BASE_URL="https://yycode.net"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"' >> ~/.zshrc
source ~/.zshrc

Linux (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:

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) và dùng CC Switch để nhanh chóng chuyển giữa nhiều cấu hình.