Claude Code

Claude Code là agent lập trình trong terminal của Anthropic, chạy trực tiếp với gói Claude của TeamSocLo. Extension Claude Code trong VS Code / JetBrains dùng chung cấu hình với CLI.

Key gói nào cũng dùng được: key gói Claude chạy model Claude, key gói GPT chạy model GPT (gateway tự chuyển giao thức). Base URL cho Claude Code là https://gpt.teamsoclo.site không có /v1, khác với các app OpenAI‑compatible.

Không bắt buộc dùng Claude Code. Gateway tự chuyển giao thức, nên key gói Claude cũng chạy được trong Codex (--model claude-opus-5 khi cài, hoặc sửa model trong config.toml), Cursor, Cline, Chatbox và mọi app OpenAI‑compatible: chỉ cần Base URL https://gpt.teamsoclo.site/v1, key của bạn và tên model claude-.... Khách chọn công cụ nào tuỳ thích.

Không muốn dùng terminal thì dùng TeamSocLo Key Tool: app cho Windows và macOS, dán key một lần là cấu hình xong Claude Code, Codex và hơn 20 công cụ khác.

Cài bằng 1 lệnh

Thay sk-xxx bằng key gói Claude, dán vào terminal và Enter. Script kiểm tra key, liệt kê các model Claude key được phép gọi để bạn chọn model chính (Enter = claude-opus-5), cài Claude Code và ghi cấu hình.

macOS / Linux
Windows

curl -fsSL https://redeem.teamsoclo.site/install/claude.sh | bash -s -- --key sk-xxx

Script hỏi ngôn ngữ trước (1 = Tiếng Việt, 2 = English; bỏ hỏi bằng --lang vi hoặc --lang en). Không truyền --key thì script hỏi. Muốn ép model chính: thêm --model claude-fable-5-1.

Mở PowerShell:

$env:TSL_KEY="sk-xxx"; irm https://redeem.teamsoclo.site/install/claude.ps1 | iex

Muốn ép model chính: thêm $env:TSL_MODEL="claude-fable-5-1"; trước irm.

Mã nguồn: claude.sh, claude.ps1. Script chỉ chạy trên máy bạn, key chỉ gửi tới gpt.teamsoclo.site để kiểm tra.

Script làm gì

Kiểm tra key với gateway; key không có model Claude thì dừng, không đụng máy bạn.
Chọn model: chính là claude-opus-5 (nếu key có), model nhanh cho tác vụ phụ là claude-haiku-4-5, còn lại theo thứ tự ưu tiên có trong key.
Cần Node.js 18+; cài hoặc nâng cấp Claude Code bằng npm install -g @anthropic-ai/claude-code.
Sao lưu ~/.claude/settings.json cũ thành settings.json.bak.<thời gian>, rồi ghi khối env trỏ về gateway. Các cài đặt khác trong file (permissions, hooks…) được giữ nguyên.

Chạy lại lệnh bất cứ lúc nào để đổi key.

Sau khi cài

Mở terminal mới, vào thư mục dự án, gõ claude

cd du-an-cua-ban
claude

Lần đầu Claude Code có thể hỏi cách đăng nhập: chọn dùng API key (đã có sẵn trong cấu hình), không đăng nhập tài khoản Anthropic.

Đổi model trong phiên

Gõ /model rồi chọn. Model có trong gói: claude-fable-5-1, claude-fable-5, claude-opus-5, claude-opus-5-5, claude-opus-4-8 / 4-7 / 4-6, claude-sonnet-5, claude-sonnet-4-6, claude-haiku-4-5. Model càng mạnh trừ credit càng nhanh, xem Model và gói.

Extension VS Code / JetBrains

Cài extension Claude Code rồi mở lại editor; extension đọc cùng ~/.claude/settings.json.

Cấu hình tay

~/.claude/settings.json (Windows: %USERPROFILE%\.claude\settings.json) cần khối env như sau, giữ nguyên các mục khác nếu đã có:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://gpt.teamsoclo.site",
    "ANTHROPIC_AUTH_TOKEN": "sk-xxx",
    "ANTHROPIC_MODEL": "claude-opus-5",
    "ANTHROPIC_SMALL_FAST_MODEL": "claude-haiku-4-5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}

Hoặc đặt biến môi trường cùng tên trong shell. ANTHROPIC_SMALL_FAST_MODEL quan trọng: Claude Code dùng model nhỏ cho tác vụ nền, để trống nó gọi tên model không có trong gói và báo lỗi.

Dùng với SDK Anthropic

import anthropic

client = anthropic.Anthropic(
    base_url="https://gpt.teamsoclo.site",
    auth_token="sk-xxx",
)
msg = client.messages.create(
    model="claude-opus-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Xin chào"}],
)
print(msg.content[0].text)

curl https://gpt.teamsoclo.site/v1/messages \
  -H "Authorization: Bearer sk-xxx" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-opus-5","max_tokens":1024,"messages":[{"role":"user","content":"Xin chào"}]}'

Key Claude cũng gọi được qua chuẩn OpenAI (/v1/chat/completions, model claude-...) cho Cursor, Cline, Chatbox, xem cURL / Python.

Gỡ cấu hình

macOS / Linux
Windows

rm -rf ~/.claude/settings.json; npm uninstall -g @anthropic-ai/claude-code

Muốn giữ Claude Code nhưng bỏ gateway: xoá các dòng ANTHROPIC_* trong settings.json, hoặc copy bản settings.json.bak.<thời gian> đè lại.

Remove-Item "$env:USERPROFILE\.claude\settings.json"; npm.cmd uninstall -g @anthropic-ai/claude-code

Không chạy thì kiểm tra

Key là gói Claude (trang check hiện model claude-...).
ANTHROPIC_BASE_URL không có /v1 ở cuối.
Đã mở terminal mới sau khi cài.
Lỗi model not found cho model lạ: đặt ANTHROPIC_SMALL_FAST_MODEL như trên.
Còn lại xem Lỗi thường gặp.

Bắt đầu

Cài đặt

Hỗ trợ

Cài bằng 1 lệnh

Script làm gì

Sau khi cài

Cấu hình tay

Dùng với SDK Anthropic

Gỡ cấu hình

Không chạy thì kiểm tra

​Cài bằng 1 lệnh

​Script làm gì

​Sau khi cài

​Cấu hình tay

​Dùng với SDK Anthropic

​Gỡ cấu hình

​Không chạy thì kiểm tra

Cài bằng 1 lệnh

Script làm gì

Sau khi cài

Cấu hình tay

Dùng với SDK Anthropic

Gỡ cấu hình

Không chạy thì kiểm tra