HH TechSetup Mở bot mua key
HH Tech API Gateway · Setup Center

Setup một lần — dùng Provider Claude, Codex và Claude App.

Trang này dành riêng cho cài đặt. Dán API key, chọn gói, rồi copy lệnh hoặc cấu hình tương ứng với app bạn dùng.

Tạo lệnh

Generator cài đặt nhanh

Dán key chỉ để sinh lệnh ngay trên trình duyệt. Trang không gửi key đi đâu và không lưu plaintext.

Claude

Claude Code / VS Code / Desktop CLI

Dán key để tạo lệnh…
Codex

Codex CLI / Codex App

Dán key để tạo lệnh…
Claude App

Cấu hình Claude App / Desktop đầy đủ

Claude Desktop chính thức có màn hình cấu hình nhà cung cấp thứ ba. Làm đúng các bước dưới đây để trỏ app về HH Tech.

ProviderGateway / Anthropic-compatible

Trong cửa sổ third-party inference, chọn Gateway.

Base URLhttps://hhtechapi.net

Base URL mặc định: https://hhtechapi.net.

API keysk-... / ark-...

Dán nguyên key nhận từ bot. Không thêm dấu nháy, không xuống dòng.

Auth schemebearer

Credential kind để Static API key. Sau đó Test connection và Apply Changes.

  1. Bước 1 · Bật Developer Mode

    Mở Claude Desktop → menu HelpTroubleshooting → chọn Enable Developer Mode.

    Menu Help Troubleshooting Enable Developer Mode
    Help → Troubleshooting → Enable Developer Mode
  2. Bước 2 · Xác nhận Enable

    Khi hộp thoại “Enable Developer Mode?” hiện ra, bấm Enable.

    Hộp thoại Enable Developer Mode
    Bấm Enable để bật chế độ Developer
  3. Bước 3 · Mở Configure third-party inference

    Quay lại menu → DeveloperConfigure third-party inference. Chọn mục Connection.

  4. Bước 4 · Điền Gateway và test

    Điền Base URL đúng server, dán API key, chọn auth scheme bearer, bấm Test connection. Khi cả Model discovery và Inference báo xanh, bấm Apply Changes.

    Configure third-party inference Gateway base URL API key Test connection Apply Changes
    Gateway · Base URL · API key · Test connection · Apply Changes
  5. Bước 5 · Quit và mở lại app

    Thoát hẳn Claude Desktop bằng Quit, mở lại app, chọn model Provider Claude rồi chat thử. Nếu không thấy model, kiểm tra lại server/key và test connection.

Kiểm tra

Gửi request đầu tiên

Nếu app chưa có UI test, dùng cURL để kiểm tra key và server.

curl https://hhtechapi.net/v1/messages \
  -H "x-api-key: YOUR_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-opus-4-8","max_tokens":128,"messages":[{"role":"user","content":"Xin chào"}]}'

Kết quả đúng là response JSON có nội dung trả lời và Usage hiển thị thêm một request mới.

Tham khảo

Các app khác — bấm để xem hướng dẫn chi tiết

Cline / Roo CodeVS Code extension · Anthropic-compatible
  1. Cài extension Cline hoặc Roo Code từ VS Code Marketplace.
  2. Mở Settings của extension → mục API Provider.
  3. Chọn Anthropic hoặc Anthropic-compatible.
  4. Bật Use custom base URL, nhập https://hhtechapi.net.
  5. Dán API key HH Tech, model nhập claude-opus-4-8 hoặc model được cấp.
Nếu dùng nhóm Codex/GPT/Grok trong extension có OpenAI-compatible mode, chuyển provider sang OpenAI-compatible và dùng base URL https://hhtechapi.net/v1.
Cursor / WindsurfCustom model endpoint
  1. Mở phần Models hoặc AI Provider trong Settings.
  2. Bật custom provider / override endpoint nếu app hỗ trợ.
  3. Với Provider Claude: Base URL dùng https://hhtechapi.net.
  4. Với Codex/GPT/Grok chat: Base URL dùng https://hhtechapi.net/v1, API key là key HH Tech.
  5. Nhập model ID đúng catalog, ví dụ claude-opus-4-8, gpt-5.6-sol, grok-4.5.
Continue.devconfig.json / config.yaml

Continue phù hợp khi bạn muốn cấu hình bằng file. Ví dụ Provider Claude:

{
  "models": [
    {
      "title": "HH Tech Provider Claude",
      "provider": "anthropic",
      "model": "claude-opus-4-8",
      "apiBase": "https://hhtechapi.net",
      "apiKey": "YOUR_API_KEY"
    }
  ]
}

Nếu dùng OpenAI-compatible cho GPT/Codex/Grok, đổi provider sang OpenAI-compatible và base URL https://hhtechapi.net/v1.

OpenAI SDKCodex / GPT / Grok chat

Dùng endpoint tương thích OpenAI cho nhóm Codex/GPT/Grok:

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.HHTECH_API_KEY,
  baseURL: "https://hhtechapi.net/v1"
});

const res = await client.chat.completions.create({
  model: "gpt-5.6-sol",
  messages: [{ role: "user", content: "Xin chào" }]
});
Anthropic SDKProvider Claude

Dùng khi SDK/app cho phép override base URL:

import Anthropic from "@anthropic-ai/sdk";

const client = new Anthropic({
  apiKey: process.env.HHTECH_API_KEY,
  baseURL: "https://hhtechapi.net"
});

const msg = await client.messages.create({
  model: "claude-opus-4-8",
  max_tokens: 256,
  messages: [{ role: "user", content: "Xin chào" }]
});
HTTP / cURLTest nhanh, CI, backend riêng

Provider Claude:

curl https://hhtechapi.net/v1/messages \
  -H "x-api-key: YOUR_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-opus-4-8","max_tokens":128,"messages":[{"role":"user","content":"Xin chào"}]}'

OpenAI-compatible:

curl https://hhtechapi.net/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "content-type: application/json" \
  -d '{"model":"gpt-5.6-sol","messages":[{"role":"user","content":"Xin chào"}]}'
Sửa lỗi

Sự cố thường gặp

401 hoặc báo key sai

Kiểm tra key có thừa khoảng trắng/xuống dòng không, và Base URL đã đặt https://hhtechapi.net chưa.

Không thấy request trong Usage

Mở trang Usage tại https://hhtechapi.net/usage, dán API key và kiểm tra lại. Request mới có thể mất vài giây để hiển thị.

Model không khả dụng

Model có thể chưa nằm trong catalog của key hoặc cần entitlement riêng. Mở bot để kiểm tra gói hiện tại.

Windows chặn script

Chạy CMD/PowerShell bằng quyền user bình thường, copy đúng một dòng lệnh. Nếu antivirus hỏi, kiểm tra URL script thuộc đúng domain HH Tech.