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

Claude Code là tác nhân terminal của Anthropic: đọc trực tiếp kho mã, sửa tệp và chạy lệnh. Mặc định nó kết nối với API chính thức, chỉ cần trỏ cổng sang LLMoxy.

Trước khi bắt đầu, hãy chuẩn bị một mã thông báo LLMoxy, nên dùng nhóm auto.

Cài đặt

Ưu tiên dùng script chính thức (npm không còn được khuyến nghị):

# macOS / Linux / WSL
curl -fsSL https://claude.ai/install.sh | bash

# Windows PowerShell
irm https://claude.ai/install.ps1 | iex
BASH

Cũng có thể dùng:

brew install --cask claude-code          # macOS
winget install Anthropic.ClaudeCode      # Windows
BASH

Kiểm tra:

claude --version
BASH

Kết nối LLMoxy

Claude Code dùng giao diện tương thích Anthropic, địa chỉ không có /v1.

BiếnGiá trị
ANTHROPIC_BASE_URLhttps://llmoxy.com
ANTHROPIC_AUTH_TOKENAPI Key LLMoxy của bạn

Cách 1: CC Switch (khuyến nghị)

Chuyển đổi nhà cung cấp bằng giao diện đồ họa, không cần sửa biến môi trường thủ công. Xem phần tải xuống và ảnh chụp từng bước tại Hướng dẫn CC Switch.

  • Tên nhà cung cấp: LLMoxy
  • API Key: mã thông báo của trang
  • Địa chỉ yêu cầu: https://llmoxy.com
  • Mô hình chính: claude-opus-5-5

Cách 2: Biến môi trường

macOS / Linux (Zsh dùng ~/.zshrc, Bash dùng ~/.bashrc):

{
echo ''
echo '# LLMoxy'
echo 'export ANTHROPIC_BASE_URL="https://llmoxy.com"'
echo 'export ANTHROPIC_AUTH_TOKEN="API Key LLMoxy của bạn"'
} >> ~/.zshrc
source ~/.zshrc
BASH

Windows PowerShell (sau khi thiết lập phải mở cửa sổ mới):

[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL","https://llmoxy.com","User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN","API Key LLMoxy của bạn","User")
POWERSHELL

Kiểm tra: echo "$ANTHROPIC_BASE_URL" phải in ra https://llmoxy.com.

Khởi động

Vào thư mục dự án:

claude
BASH

Nhập /model, chọn tên mô hình vừa cấu hình (ví dụ claude-opus-5-5). Nhập / để xem tất cả lệnh.

Màn hình chào

Lệnh gạch chéo

Tùy chọn: chạy claude doctor để kiểm tra môi trường.

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

claude: command not found Xác nhận claude --version có kết quả, rồi mở lại terminal.

Vẫn yêu cầu đăng nhập tài khoản Claude Xác nhận ANTHROPIC_BASE_URL và ANTHROPIC_AUTH_TOKEN đã có hiệu lực. Khi đã cấu hình cổng tùy chỉnh thì dùng API Key, không cần đăng nhập claude.ai.

Lỗi quyền khi cài npm toàn cục Không dùng sudo npm install -g. Hãy dùng script chính thức, Homebrew hoặc nvm.

Không kết nối được Dùng curl -I https://llmoxy.com để kiểm tra mạng; khi cần proxy, đặt HTTPS_PROXY.