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

Claude Code

AI coding assistant chạy trong terminal, phù hợp khi muốn sửa code trực tiếp trong repo.

Bạn cần: Claude Code đã cài, terminal macOS/Linux hoặc Windows PowerShell, API key Premium Shop dạng sk_shop_....<secret> và model đang hoạt động.

Thông tin dùng chung

Secret đầy đủ có dạng sk_shop_....<secret> và chỉ hiện một lần.

Base URL: https://api.premiumshop.tech/v1
API key: sk_shop_....<secret>
Model: gpt-5.6-luna

Cài Claude Code

Cài CLI chính thức rồi kiểm tra phiên bản.

Cài Claude Codeconfig

curl -fsSL https://claude.ai/install.sh | bash
claude --version

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

Nạp biến môi trường

Premium Shop dùng secret đầy đủ có dấu chấm giữa mã key và phần bí mật.

Nạp biến môi trườngconfig

export ANTHROPIC_API_KEY="sk_shop_....<secret>"
export ANTHROPIC_AUTH_TOKEN="sk_shop_....<secret>"
export ANTHROPIC_BASE_URL="https://api.premiumshop.tech/v1"
claude

PowerShell

Dùng session hiện tại hoặc lưu vào profile riêng của bạn.

PowerShellconfig

$env:ANTHROPIC_API_KEY="sk_shop_....<secret>"
$env:ANTHROPIC_AUTH_TOKEN="sk_shop_....<secret>"
$env:ANTHROPIC_BASE_URL="https://api.premiumshop.tech/v1"
claude

Settings.json cho Claude Opus 5 1M context

Cấu hình khuyến nghị: mọi tier (Haiku/Sonnet/Opus) và subagent đều dùng Claude Opus 5 bản 1M context, tắt auto-compact để giữ trọn ngữ cảnh. Đặt vào ~/.claude/settings.json (Windows: %USERPROFILE%\.claude\settings.json), hoặc .claude/settings.json trong repo nếu chỉ muốn áp dụng cho một dự án. Lưu ý ANTHROPIC_BASE_URL ở đây KHÔNG kèm /v1 vì Claude Code tự nối /v1/messages.

Settings.json cho Claude Opus 5 1M contextconfig

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk_shop_....<secret>",
    "ANTHROPIC_BASE_URL": "https://api.premiumshop.tech",
    "CLAUDE_CODE_AUTO_COMPACT_WINDOW": "400000",
    "ANTHROPIC_MODEL": "claude-opus-5[1m]",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-opus-5[1m]",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-opus-5[1m]",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5[1m]",
    "CLAUDE_CODE_SUBAGENT_MODEL": "claude-opus-5[1m]",
    "DISABLE_AUTO_COMPACT": "1"
  }
}

Giải thích từng biến

ANTHROPIC_AUTH_TOKEN là secret sk_shop_ đầy đủ. ANTHROPIC_BASE_URL trỏ về gateway Premium Shop. Hậu tố [1m] bật cửa sổ ngữ cảnh 1 triệu token; bỏ hậu tố nếu muốn dùng context mặc định. Bốn biến ANTHROPIC_MODEL / DEFAULT_HAIKU / DEFAULT_SONNET / DEFAULT_OPUS ép mọi tier về cùng một model để /model hay tác vụ nền không tự rơi về model khác. CLAUDE_CODE_SUBAGENT_MODEL áp dụng cho subagent. DISABLE_AUTO_COMPACT=1 tắt nén ngữ cảnh tự động, còn CLAUDE_CODE_AUTO_COMPACT_WINDOW=400000 là ngưỡng dự phòng nếu bạn bật lại auto-compact.

Settings tùy chọn khác

Thêm helper key và permissions khi cần. Có thể gộp chung vào cùng file settings.json ở trên.

Settings tùy chọn khácconfig

{
  "apiKeyHelper": "echo $ANTHROPIC_AUTH_TOKEN",
  "permissions": {
    "allow": ["Bash(npm test:*)", "Bash(git status:*)"],
    "deny": []
  }
}

Lệnh hữu ích

Dùng /status để kiểm tra kết nối và model đang chạy, /model để đổi model, /clear khi muốn bắt đầu ngữ cảnh mới. Nếu đã đặt DISABLE_AUTO_COMPACT=1 thì hãy tự dùng /compact khi hội thoại quá dài.

Kiểm tra sau khi cấu hình

Gửi một yêu cầu ngắn, kiểm tra lượt gọi mới trong trang quản lý và xác nhận mã model phù hợp với gói của bạn.

Xử lý lỗi thường gặp

401: kiểm tra secret đầy đủ bắt đầu bằng sk_shop_ và có phần bí mật sau dấu chấm.
Model not found: gọi GET /v1/models rồi sao chép đúng mã model.
Connection error: kiểm tra proxy/VPN/firewall và base URL.