KozeKoze
← Quay lại Blog
Hướng dẫn2026年3月23日·管理员

Hướng dẫn cấu hình mã Claude

Hướng dẫn cấu hình mã Claude

📋 Các bước chuẩn bị

Trước khi bắt đầu, vui lòng đảm bảo bạn đã:

  • Đăng ký tài khoản Koze và đăng nhập
  • Tạo khóa API trên trang Quản lý API
  • Cài đặt Claude Code (npm install -g @anthropic-ai/claude-code)

🚀 Bước 1: Thiết lập biến môi trường

Thực hiện các lệnh sau trong terminal để thiết lập địa chỉ API và khóa API làm biến môi trường:

# Thiết lập địa chỉ proxy Koze thành URL cơ sở
export ANTHROPIC_BASE_URL='https://api.kozeai.com/v1'

# Thiết lập khóa API bạn đã tạo trong phần quản trị Koze
export ANTHROPIC_AUTH_TOKEN="API của bạn" "Key"

💡 Mẹo: Thay thế https://api.kozeai.com bằng tên miền dịch vụ thực tế của bạn. Bạn có thể xem hoặc tạo khóa API trên trang "Quản lý API → Khóa hiện có".

🔧 Bước Hai: Cấu hình Plugin VSCode (Tùy chọn)

Nếu bạn đang sử dụng plugin Claude cho VSCode, bạn cần cấu hình nó trong `~/.claude/config.json`:

{

"primaryApiKey": "Khóa API của bạn",

"apiBaseUrl": "https://api.kozeai.com/v1"

}

Nếu tệp không tồn tại, vui lòng tạo thủ công.

  • macOS / Linux: ~/.claude/config.json
  • Windows: C:\Users\Your Username\.claude\config.json

🎯 Bước 3: Khởi chạy Claude Code

Sau khi cấu hình các biến môi trường, hãy khởi chạy trực tiếp trong terminal:

claude

Claude Code sẽ tự động sử dụng địa chỉ proxy Koze mà bạn đã cấu hình để thực hiện các yêu cầu.

📌 Biến môi trường cố định

Để tránh phải đặt lại các biến mỗi khi bạn mở terminal, bạn nên ghi các biến vào tệp cấu hình shell:

# Người dùng Bash

echo 'export ANTHROPIC_BASE_URL='https://api.kozeai.com/v1' >>> ~/.bashrc

echo 'export ANTHROPIC_AUTH_TOKEN='your API key' >>> ~/.bashrc

source ~/.bashrc

# Người dùng Zsh

echo 'export ANTHROPIC_BASE_URL='https://api.kozeai.com/v1' >>> ~/.zshrc

echo 'export ANTHROPIC_AUTH_TOKEN='your API key' >> ~/.zshrc

source ~/.zshrc

✅ Xác minh kết nối

Sau khi khởi động Claude Code, nếu bạn thấy giao diện hộp thoại bình thường, cấu hình đã thành công.

Bạn có thể xem nhật ký cuộc gọi theo thời gian thực trên trang "Thống kê sử dụng" của Koze.

⚠️ Câu hỏi thường gặp

Vấn đề Giải pháp
Mẹo: Khóa API không hợp lệ Kiểm tra xem Khóa API đã được sao chép chính xác chưa, đảm bảo không có khoảng trắng thừa
Lỗi kết nối hết thời gian chờ Xác nhận xem URL cơ sở có chính xác và chứa hậu tố /v1
Mẫu không khả dụng Kiểm tra danh sách các mẫu khả dụng cho gói hiện tại trong Koze Model Sảnh chờ

 

Hướng dẫn cấu hình mã Claude | Koze AI