Chào mừng đến với ModelGate

Gateway giao diện mô hình lớn thống nhất. Giá tốt hơn, ổn định hơn, mang lại trải nghiệm tích hợp hiệu quả cho các công cụ phổ biến như Claude Code, Codex, Gemini CLI.

ModelGate là gateway mô hình thống nhất chuyển đổi subscription thành API, cung cấp cho developer dịch vụ truy cập mô hình AI ổn định và hiệu quả. Hỗ trợ các mô hình phổ biến như Claude, GPT, Gemini — chỉ cần một API Key là truy cập được nhiều khả năng AI.

Vì sao chọn trợ lý lập trình AI?

Các công cụ autocomplete code truyền thống không còn đáp ứng được nhu cầu phức tạp của phát triển hiện đại. Trợ lý lập trình AI thế hệ mới sẽ định hình lại workflow của bạn:

• Hiểu ngữ cảnh dự án: không chỉ autocomplete code mà còn phân tích sâu toàn bộ codebase, đưa ra gợi ý kiến trúc chính xác.
• Tự động sinh code: chỉ cần mô tả logic là sinh được code chức năng chất lượng cao, dễ bảo trì theo yêu cầu nghiệp vụ.
• Sửa Bug thông minh: nhanh chóng khoanh vùng lỗ hổng logic, cung cấp giải pháp sửa một chạm, nâng rõ rệt hiệu quả debug.
• Refactor và tối ưu code: tự động nhận diện technical debt và phần dư thừa, liên tục nâng cao chất lượng code, độ dễ đọc và hiệu năng hệ thống.

Các công cụ lập trình AI phổ biến

Trạm trung chuyển (relay API) là gì?

Đây là một dịch vụ proxy API giúp tăng tốc độ phản hồi request, cho phép bạn truy cập thống nhất nhiều mô hình AI mà không cần đăng ký riêng từng nền tảng.

Tạo tài khoản và nạp tiền vào tài khoản của bạn.

Đăng ký tài khoản

1. Truy cập trang chủ: mở trình duyệt, truy cập https://ai.jtht.vn
2. Nhấn đăng ký: nhấn nút đăng nhập ở góc trên bên phải trang, điền email và mật khẩu để hoàn tất đăng nhập.

   

Nạp tiền

1. Vào ví: sau khi đăng nhập, nhấn mục "Nạp tiền/Subscription" ở sidebar để vào trang nạp tiền.
2. Chọn phương thức nạp: chọn số tiền nạp và thanh toán bằng Alipay.

   

Tạo API Key để truy cập dịch vụ.

Thêm token

1. Vào trang token: nhấn "API Key" ở sidebar, sau đó nhấn "Tạo key".

   

2. Điền thông tin key: chỉ cần điền tên token và chọn group (bắt buộc chọn group, không được để trống nếu không sẽ báo lỗi); các mục khác không cần thay đổi, không cần đặt giới hạn nào.

   

3. Gửi token: tạo xong, hệ thống tự sinh key, chính là API Key (định dạng sk-xxxxxxxxx).

Điều kiện tiên quyết

Claude Code cần các môi trường sau, hãy kiểm tra từng mục:

Cài Git

Git là dependency bắt buộc của Claude Code, dùng để phân tích lịch sử dự án, thực hiện commit code, v.v.

1. Tải Git: truy cập trang chủ Git (https://git-scm.com/downloads/win) để tải bộ cài Windows.

   

2. Chạy trình cài đặt: nhấp đúp bộ cài, giữ nguyên lựa chọn mặc định và nhấn "Next" đến khi hoàn tất.
3. Xác minh cài đặt: mở lại terminal và chạy lệnh: git -v

Cài Node.js

Cách 1: tải bộ cài từ trang chủ

1. Tải Node.js từ trang chủ (https://nodejs.org/zh-cn/download).

   

2. Chạy bộ cài, hoàn tất thì xác minh trong terminal: node -v

Cách 2: cài bằng fnm (khuyên dùng)

fnm (Fast Node Manager, https://github.com/Schniz/fnm) là trình quản lý phiên bản Node.js nhanh, hỗ trợ cài và chuyển đổi nhiều phiên bản Node.js dễ dàng.

1. Tải fnm: vào trang release (https://github.com/Schniz/fnm/releases/latest), tải gói fnm-windows.zip.
2. Giải nén vào thư mục cố định: giải nén fnm.exe vào một vị trí cố định, ví dụ C:\fnm.
3. Thêm biến môi trường: nhấn Win + R, nhập SystemPropertiesAdvanced rồi Enter để mở System Properties. Nhấn "Environment Variables", trong "User variables" tìm Path, nhấp đúp để sửa, thêm dòng mới là thư mục chứa fnm (ví dụ C:\fnm), nhấn OK để lưu.
4. Cài Node.js: mở lại terminal, chạy lệnh cài bản LTS mới nhất:

fnm install --lts
node -v

Cài Claude Code

1. Mở terminal: nhấn Win + R, nhập powershell hoặc cmd.

   

2. Chạy lệnh cài đặt:

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

3. Xác minh cài đặt: chạy claude --version để xác nhận cài đặt thành công.
4. Mở Claude: nhập claude trong terminal.

Yêu cầu hệ thống

• macOS 10.15 (Catalina) trở lên
• Git (macOS thường cài sẵn; chạy git -v trong terminal để kiểm tra)
• Node.js 18+

Các bước cài đặt

1. Cài Node.js (bỏ qua nếu đã cài)

Cách 1: tải bộ cài macOS từ trang chủ Node.js, cài xong chạy node -v để xác minh.

Cách 2 (khuyên dùng): fnm — trình quản lý phiên bản Node.js nhanh, tiện chuyển đổi và quản lý nhiều phiên bản:

# Cài fnm
curl -fsSL https://fnm.vercel.app/install | bash

# Cài bản LTS mới nhất
fnm install --lts
node -v

Cách 3: Homebrew:

brew install node

2. Cài Claude Code

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

Nếu cài báo error, hãy cài với quyền quản trị:

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

Nhập mật khẩu mở máy rồi Enter để bắt đầu cài.

3. Mở Claude

Nhập claude trong terminal.

Yêu cầu hệ thống

• Các bản phân phối phổ biến: Ubuntu 18.04+, CentOS 7+, Debian 9+...
• Git 2.23+ (chạy git -v để kiểm tra)
• Node.js 18+

Các bước cài đặt

0. Cài Git (nếu chưa có)

# Ubuntu / Debian
sudo apt-get update && sudo apt-get install -y git

# CentOS / RHEL
sudo yum install -y git

1. Cài Node.js

Cách 1: tải bộ cài/binary Linux từ trang chủ Node.js, cài xong chạy node -v.

Cách 2 (khuyên dùng): fnm — không cần sudo, không làm bẩn môi trường hệ thống:

# Cài fnm
curl -fsSL https://fnm.vercel.app/install | bash

# Nạp lại cấu hình shell
source ~/.bashrc

# Cài bản LTS mới nhất
fnm install --lts
node -v

Cách 3: NodeSource (Ubuntu/Debian):

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

2. Cài Claude Code

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

3. Mở Claude

Nhập claude trong terminal.

Cấu hình thủ công các biến môi trường API cho Claude Code.

Windows

1. Mở thư mục cấu hình: nhấn Win + R, nhập %userprofile%\.claude.

   

2. Sửa file cấu hình: tìm hoặc tạo settings.json, ghi nội dung sau:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://ai.jtht.vn",
    "ANTHROPIC_AUTH_TOKEN": "sk-token-của-bạn"
  }
}

3. Khởi động Claude Code: mở lại terminal, nhập claude là khởi động được.

   

macOS

Người dùng Zsh (mặc định của macOS):

echo 'export ANTHROPIC_AUTH_TOKEN="sk-token-của-bạn"' >> ~/.zshrc
echo 'export ANTHROPIC_BASE_URL="https://ai.jtht.vn"' >> ~/.zshrc
source ~/.zshrc

Người dùng Bash:

echo 'export ANTHROPIC_AUTH_TOKEN="sk-token-của-bạn"' >> ~/.bash_profile
echo 'export ANTHROPIC_BASE_URL="https://ai.jtht.vn"' >> ~/.bash_profile
source ~/.bash_profile

Linux

echo 'export ANTHROPIC_AUTH_TOKEN="sk-token-của-bạn"' >> ~/.bashrc
echo 'export ANTHROPIC_BASE_URL="https://ai.jtht.vn"' >> ~/.bashrc
source ~/.bashrc

Quản lý cấu hình API bằng công cụ đồ họa.

CC-Switch là cách cấu hình được khuyên dùng, hỗ trợ chuyển đổi nhiều cấu hình API chỉ với một cú nhấp.

Tính năng

• Chuyển đổi cấu hình API một chạm, chuyển nhanh giữa nhiều nhà cung cấp
• Quản lý cấu hình trực quan qua giao diện đồ họa
• Quản lý MCP server
• Thao tác nhanh từ system tray

Tải và cài đặt

Vào trang tải CC-Switch (https://github.com/farion1231/cc-switch/releases/latest); người dùng Windows nên tải bộ cài .msi.

Cấu hình API

1. Chạy CC-Switch: cài xong thì khởi động chương trình.

   

2. Thêm cấu hình: nhấn "Thêm cấu hình", chọn cấu hình tùy chỉnh, kéo xuống dưới.

   

3. Hoàn thiện cấu hình: điền API Key (lấy ở mục token, định dạng sk-xxxxxx) và địa chỉ request https://ai.jtht.vn.

   

4. Điền mô hình: mở tùy chọn nâng cao và điền tên mô hình — copy tên từ "model plaza" (quảng trường mô hình) trên trang chủ, đừng gõ tay; nên điền cùng một mô hình vào cả năm ô để tránh Claude tự dùng lung tung.

   

5. Kích hoạt cấu hình: nhấn "Kích hoạt" để hoàn tất.

Hướng dẫn dưới đây lấy VSCode làm ví dụ; các IDE khác có thể tham khảo tương tự.

Cài extension

1. Mở chợ extension: trong VSCode nhấn Ctrl+Shift+X.
2. Tìm và cài: tìm "Claude" và cài extension chính thức.

   

3. Bắt đầu dùng: sẽ thấy biểu tượng Claude Code ở sidebar.

   

4. Vấn đề thường gặp: nếu đã cấu hình môi trường và khởi động lại IDE mà plugin vẫn không bỏ qua màn hình đăng nhập, hãy quay lại bước trước (dùng terminal) và cài Claude Code trong terminal trước — plugin chỉ là lối tắt của terminal, hoạt động dựa trên nền terminal.

Cách khởi động

1. Mở terminal: Win + R, nhập powershell hoặc cmd.
2. Nhập claude để khởi động.

   

3. Lần đầu khởi động, chọn Yes để tin tưởng thư mục.

   

Lệnh cơ bản

Quản lý session

Tùy chọn nâng cao

Công cụ AI lập trình của OpenAI.

Điều kiện tiên quyết

• Node.js 18+ (xem mục cài đặt)
• Git 2.23+

Cài đặt

npm install -g @openai/codex

Cấu hình

macOS / Linux:

export OPENAI_API_KEY="sk-token-của-bạn"
export OPENAI_BASE_URL="https://ai.jtht.vn/v1"

Windows (PowerShell):

$env:OPENAI_API_KEY="sk-token-của-bạn"
$env:OPENAI_BASE_URL="https://ai.jtht.vn/v1"

Kết nối giao diện ModelGate trong OpenCode và bắt đầu sử dụng.

1. Mở cài đặt: mở OpenCode, nhấn nút cài đặt ở góc dưới bên trái, chọn nhà cung cấp (provider), kéo xuống chọn nhà cung cấp tùy chỉnh rồi nhấn kết nối.

   

2. Thêm nhà cung cấp: tên đặt tùy ý; Base URL điền https://ai.jtht.vn/v1; copy API Key từ mục token dán vào OpenCode (định dạng sk-xxxxxx).
3. Lưu và bắt đầu dùng: lưu xong quay lại màn hình chat, chọn mô hình vừa thêm ở góc dưới bên trái.

   

Công cụ AI lập trình của Google, mạnh về frontend.

Điều kiện tiên quyết

• Node.js 18+

Cài đặt

npm install -g @google/gemini-cli

Cấu hình

macOS / Linux:

export GEMINI_API_KEY="sk-token-của-bạn"
export GEMINI_BASE_URL="https://ai.jtht.vn"

Windows (PowerShell):

$env:GEMINI_API_KEY="sk-token-của-bạn"
$env:GEMINI_BASE_URL="https://ai.jtht.vn"

Kết nối ModelGate trong Cherry Studio và bắt đầu chat.

1. Mở cài đặt: nhấn nút cài đặt ở góc trên bên phải.

   

2. Vào mục mô hình: chọn "Mô hình dịch vụ" (Model Services), nhấn nút thêm bên dưới để thêm nhà cung cấp tùy chỉnh.

   

3. Thêm nhà cung cấp: tên tùy ý, loại nhà cung cấp chọn OpenAI.

   

4. Lấy mô hình: copy key ở mục token dán vào ô API Key (định dạng sk-xxxxxx); điền địa chỉ API https://ai.jtht.vn; nhấn lấy mô hình (nếu thất bại, kiểm tra token đã chọn group chưa).

   

5. Thêm mô hình: nhấn dấu cộng bên phải để chọn mô hình muốn dùng, có thể thêm nhiều mô hình.

   

6. Đổi mô hình: lưu cấu hình, về trang chủ và chọn mô hình vừa thêm ở phía trên.

   

7. Kích hoạt mô hình: chọn mô hình muốn dùng.

   

8. Bắt đầu dùng: nhập câu hỏi và gửi; nếu nhận được nội dung trả về bình thường nghĩa là cấu hình hoàn tất.

   

Kết nối giao diện ModelGate trong Hermes Agent và hoàn tất cài đặt/cấu hình.

Cài trên Windows

1. Chạy lệnh cài: mở PowerShell và chạy:

irm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1 | iex

2. Cài uv: nếu báo thiếu uv, cài uv trước rồi chạy lại lệnh cài Hermes ở trên:

# Cách 1: cài uv bằng pip
pip install uv

# Cách 2: không có pip thì dùng winget
winget install astral-sh.uv

# Cách 3: cả hai không được thì tải qua mirror GitHub
Invoke-WebRequest -Uri "https://ghfast.top/https://github.com/astral-sh/uv/releases/latest/download/uv-x86_64-pc-windows-msvc.zip" -OutFile "$env:TEMP\uv.zip"
Expand-Archive "$env:TEMP\uv.zip" -DestinationPath "$env:LOCALAPPDATA\uv" -Force
$env:Path = "$env:LOCALAPPDATA\uv;" + $env:Path
uv --version

Cài trên macOS và Linux

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

Chờ cài hoàn tất

Sau khi chạy lệnh sẽ vào màn hình cài đặt — chờ cài xong là được.

Cấu hình

1. Chọn cấu hình nhanh: cài xong nhập 1 rồi Enter.

   

2. Chọn endpoint tùy chỉnh: nhập 28 để chọn custom endpoint.

   

3. Điền địa chỉ giao diện: copy link trang web dán vào ô URL.

   

4. Điền API Key: copy API Key từ mục token dán vào Hermes Agent (định dạng sk-xxxxxx); key dán vào sẽ không hiển thị — đừng dán lặp lại nhiều lần.
5. Chọn mô hình: danh sách mô hình khả dụng hiện ra, nhập số thứ tự rồi Enter.

   

6. Đặt độ dài context: tự đặt trong mục context length, khuyên điền 128000 — context quá lớn sẽ giảm hiệu năng về sau.

   

7. Lưu cấu hình: Display Name có thể bỏ trống rồi Enter; thấy Saved là hoàn tất.
8. Kết nối nền tảng chat: tùy nhu cầu, 1 là kết nối, 2 là bỏ qua.

   

9. Chọn nền tảng chat: nếu kết nối tiếp, nhập số chọn nền tảng đích; các thiết lập sau chọn theo nhu cầu, 1 là mặc định khuyên dùng.

   

10. Mở Hermes Agent: cấu hình xong nhập Y để mở, hoặc sau này chạy hermes trong PowerShell/terminal.

    

11. Cấu hình lại hoặc sửa file: trên Windows nhấn Win + R, nhập %LOCALAPPDATA%\hermes để mở thư mục cấu hình và sửa file config; hoặc chạy hermes setup trong PowerShell để cấu hình lại.

Không kết nối được dịch vụ

Nếu gặp màn hình lỗi kết nối như dưới đây, làm theo các bước (Windows):

1. Mở Command Prompt: Win + R, nhập cmd rồi Enter.
2. Chạy lệnh sửa:

powershell -Command "$f='%USERPROFILE%\.claude.json';$j=Get-Content $f|ConvertFrom-Json;$j|Add-Member -NotePropertyName 'hasCompletedOnboarding' -NotePropertyValue $true -Force;$j|ConvertTo-Json|Set-Content $f"

3. Khởi động lại Claude CLI: đóng terminal, mở lại và chạy claude.

Token không hợp lệ hoặc không đủ số dư

• Kiểm tra token đã copy đúng chưa (phải gồm tiền tố sk-)
• Đăng nhập nền tảng để kiểm tra số dư tài khoản
• Xác nhận group của token có hỗ trợ mô hình bạn dùng không

Phản hồi chậm

• Kiểm tra mạng có ổn định không
• Thử chuyển sang mô hình nhanh hơn (ví dụ Gemini Flash)
• Giảm độ dài context mỗi request

Cấu hình khuyên dùng

Thêm các biến môi trường sau vào file cấu hình của Claude Code để dùng ổn định hơn. Mở settings.json (tại ~/.claude/settings.json; trên Windows là %userprofile%\.claude\settings.json) và thêm vào env:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://ai.jtht.vn",
    "ANTHROPIC_AUTH_TOKEN": "sk-token-của-bạn",
    "CLAUDE_CODE_ATTRIBUTION_HEADER": "0",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}

Người dùng CC-Switch không cần sửa file thủ công — quản lý biến môi trường ngay trong giao diện đồ họa.

Các mô hình khuyên dùng

Giải thích các group

• Pool tài khoản Claude Max: gồm các tài khoản Claude Max, độ ổn định cao
• Group Codex: hỗ trợ các mô hình họ OpenAI
• Group Gemini: hỗ trợ các mô hình họ Google
• Group AWS Bedrock: dùng dịch vụ chính thức của AWS, phản hồi nhanh

Cache là gì?

Cache là cơ chế tối ưu:

• Request đầu tiên: khi gửi nội dung sẽ tạo cache (có phí thêm)
• Cache hit: các request tương tự về sau đọc từ cache, giá cực rẻ
• Thời gian cache: 5 phút hợp khi chuyển đổi thường xuyên; 1 giờ hợp khi tập trung một dự án

Context là gì?

Context là độ dài nội dung mà mô hình xử lý được:

• Context mặc định: 200K–256K tokens
• Group giá đặc biệt: context có thể ngắn hơn
• Context 1M: hợp xử lý nội dung siêu dài