🚀 Hướng dẫn sử dụng API

Nghimmo API - Tương thích Cursor / Cline / Claude Code

📌 Thông tin chung

Mục	Giá trị
Base URL	https://api.nghimmo.com/v1
API Key	sk-xxxxxxxxxxxx (đã cấp riêng)
Trang kiểm tra token	api.nghimmo.com/check
Format hỗ trợ	OpenAI & Anthropic compatible

🤖 Danh sách Model

Mạnh nhất — dùng cho việc khó, cần suy luận sâu.

nghi/claude-opus-4.8
nghi/claude-opus-4.8-thinking
nghi/claude-opus-4.7
nghi/claude-opus-4.7-thinking
nghi/claude-opus-4.6
nghi/claude-opus-4.6-thinking
nghi/claude-opus-4.5
nghi/claude-opus-4.5-thinking

Cân bằng giữa chất lượng và chi phí — khuyên dùng hằng ngày.

nghi/claude-sonnet-4.6
nghi/claude-sonnet-4.6-thinking
nghi/claude-sonnet-4.5
nghi/claude-sonnet-4.5-thinking
nghi/claude-sonnet-4
nghi/claude-sonnet-4-thinking

Nhanh, rẻ token — dùng cho việc nhẹ (sửa typo, đổi tên, hỏi nhanh).

nghi/claude-haiku-4.5
nghi/claude-haiku-4.5-thinking

GPT, DeepSeek, GLM, Qwen, MiniMax... và nghi/auto (tự chọn).

nghi/gpt-4o
nghi/gpt-4
nghi/deepseek-3.2
nghi/deepseek-3.2-thinking
nghi/glm-5
nghi/glm-5-thinking
nghi/qwen3-coder-next
nghi/qwen3-coder-next-thinking
nghi/minimax-m2.5
nghi/minimax-m2.5-thinking
nghi/minimax-m2.1
nghi/minimax-m2.1-thinking
nghi/auto

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

Chọn tab tương ứng với công cụ bạn đang dùng. Mọi cấu hình đều dùng chung:

Base URL: https://api.nghimmo.com/v1
API Key: sk-... (đã cấp riêng)

Cách nhanh nhất: tải file dưới đây, copy vào thư mục code rồi double-click. Nhập API Key là dùng được ngay (không cần cài gì thêm).

⬇️ Tải file .bat (Windows) 🍎 Tải file .command (Mac)

Các bước dùng (Windows)

Tải file CLAUDE-CODE-CLI.bat ở trên.
Copy file vào thư mục project (chỗ bạn muốn code).
Double-click file đó.
Nhập API Key (sk-...) rồi Enter.
Claude Code tự mở tại thư mục đó, dùng luôn.

Các bước dùng (Mac)

Tải file CLAUDE-CODE-CLI.command ở trên.
Copy file vào thư mục project (chỗ bạn muốn code).
Lần đầu cần cấp quyền chạy: mở Terminal tại thư mục đó và gõ:
```
chmod +x CLAUDE-CODE-CLI.command
```
Double-click file đó. Nếu macOS báo "không mở được", chuột phải → Open → Open.
Nhập API Key (sk-...) rồi Enter. Claude Code tự mở tại thư mục đó.

File .command tự trỏ về server Nghimmo trong phiên đó, không cần sửa settings.json. Nếu thích cấu hình cố định, xem mục dưới.

Cấu hình Mac / Linux thủ công (tùy chọn)

Tạo file ~/.claude/settings.json:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.nghimmo.com",
    "ANTHROPIC_API_KEY": "sk-xxxxxxxxxxxx",
    "ANTHROPIC_MODEL": "nghi/claude-opus-4.8",
    "ANTHROPIC_SMALL_FAST_MODEL": "nghi/claude-haiku-4.5"
  }
}

Quan trọng:

ANTHROPIC_BASE_URL không có /v1
ANTHROPIC_SMALL_FAST_MODEL bắt buộc — thiếu sẽ lỗi Bash / Auto mode
Model phải có prefix nghi/

Hoặc biến môi trường (Windows CMD)

set ANTHROPIC_BASE_URL=https://api.nghimmo.com
set ANTHROPIC_API_KEY=sk-xxxxxxxxxxxx
set ANTHROPIC_MODEL=nghi/claude-opus-4.8
set ANTHROPIC_SMALL_FAST_MODEL=nghi/claude-haiku-4.5
claude

Mẹo dùng ổn định

Gõ /compact mỗi 30–50 lượt chat để giảm context
Mở session mới khi đổi project
Opus cho việc khó; Sonnet/Haiku cho edit file thường — tiết kiệm token

Cần cài Node.js và Claude Code trước: npm install -g @anthropic-ai/claude-code

Dành cho khách dùng Claude Code extension trong VS Code, Cursor hoặc Antigravity. Cài extension một lần, rồi tải file .bat tương ứng với công cụ bạn dùng, double-click là tự mở.

📌 Bước chung (làm 1 lần): Cài extension Claude Code (của Anthropic) từ Marketplace của công cụ bạn dùng (VS Code / Cursor / Antigravity đều có).

Các bước dùng (Windows)

Cài extension Claude Code trong công cụ của bạn (VS Code / Cursor / Antigravity).
Tải đúng file .bat ở trên (tương ứng công cụ bạn dùng).
Đóng hết công cụ đó đang chạy.
Double-click file .bat, nhập API Key (sk-...) rồi Enter.
Công cụ tự mở lên, bấm icon Claude Code ở thanh bên là dùng được.

Các bước dùng (Mac)

Cài extension Claude Code trong công cụ của bạn (VS Code / Cursor / Antigravity).
Tải đúng file .command ở trên, copy vào thư mục project.
Lần đầu cấp quyền chạy bằng Terminal (đổi tên file cho đúng công cụ):
```
chmod +x MO-CLAUDE-VSCODE.command
```
Đóng hết công cụ đó đang chạy.
Double-click file .command. Nếu macOS báo chặn, chuột phải → Open → Open.
Nhập API Key (sk-...) rồi Enter. Công cụ tự mở, bấm icon Claude Code ở thanh bên là dùng được.

Phải đóng hết công cụ (VS Code / Cursor / Antigravity) trước khi mở file. Nếu đã có cửa sổ đang chạy, biến môi trường mới sẽ không có hiệu lực và Claude Code không trỏ về server Nghimmo được.

Cursor dùng định dạng OpenAI. Cấu hình trong phần Models của Settings.

Các bước

Mở Cursor, vào Settings → Models (hoặc nhấn Ctrl + Shift + J).
Kéo xuống mục OpenAI API Key.
Bật Override OpenAI Base URL và dán:

https://api.nghimmo.com/v1

Dán API Key sk-... vào ô OpenAI API Key.
Bấm Verify để xác nhận, rồi bật key lên.
Thêm model thủ công, ví dụ nghi/claude-sonnet-4.6, rồi chọn để dùng.

Cursor chỉ gọi qua base URL tùy chỉnh khi bạn thêm model thủ công và tắt các model mặc định của Cursor.

Cline là extension trong VS Code. Hỗ trợ cả định dạng OpenAI và Anthropic.

Cách 1 - OpenAI Compatible (khuyên dùng)

Mở Cline, bấm icon Settings (⚙️) ở góc trên.
Mục API Provider chọn OpenAI Compatible.
Base URL:

https://api.nghimmo.com/v1

API Key: dán sk-...
Model ID: nhập ví dụ nghi/claude-sonnet-4.6
Bấm Done rồi chat thử.

Cách 2 - Anthropic

API Provider chọn Anthropic.
Bật Use custom base URL, dán https://api.nghimmo.com
API Key: dán sk-..., chọn model rồi dùng.

Roo Code (bản fork của Cline) cũng là extension VS Code, cấu hình tương tự.

Các bước

Mở Roo Code, bấm icon Settings (⚙️).
API Provider chọn OpenAI Compatible.
Base URL:

https://api.nghimmo.com/v1

API Key: dán sk-...
Model: nhập nghi/claude-sonnet-4.6 (hoặc model khác).
Lưu lại và chat thử.

Continue (extension VS Code / JetBrains) cấu hình qua file config.json.

Các bước

Mở Continue, bấm icon Settings (⚙️) để mở file config.json.
Thêm model vào mảng models như dưới:

{
  "models": [
    {
      "title": "Nghimmo Sonnet",
      "provider": "openai",
      "model": "nghi/claude-sonnet-4.6",
      "apiBase": "https://api.nghimmo.com/v1",
      "apiKey": "sk-xxxxxxxxxxxx"
    }
  ]
}

Lưu file, chọn model "Nghimmo Sonnet" ở thanh chat rồi dùng.

Bất kỳ app nào hỗ trợ OpenAI hoặc Anthropic compatible đều dùng được (ChatBox, LobeChat, NextChat, Open WebUI...).

Định dạng OpenAI

Base URL : https://api.nghimmo.com/v1
API Key  : sk-xxxxxxxxxxxx
Model    : nghi/claude-sonnet-4.6

Định dạng Anthropic

Base URL : https://api.nghimmo.com
API Key  : sk-xxxxxxxxxxxx
Model    : nghi/claude-sonnet-4.6

Nếu app yêu cầu endpoint đầy đủ: /v1/chat/completions (OpenAI) hoặc /v1/messages (Anthropic).

💰 Mẹo tiết kiệm token

Token chủ yếu bị tiêu hao ở context (lịch sử + file đính kèm), không phải ở câu trả lời. Mỗi lần chat, toàn bộ hội thoại được gửi lại — phiên càng dài, mỗi lượt càng tốn. Áp dụng các mẹo dưới để dùng được lâu hơn.

1. Quản lý phiên chat

/clear khi đổi chủ đề — mở phiên mới, bỏ lịch sử cũ không liên quan.
/compact mỗi 30–50 lượt — nén hội thoại nhưng giữ ý chính.
Một việc = một phiên. Đừng dồn nhiều task khác nhau vào cùng một phiên dài.

2. Hạn chế file & ngữ cảnh thừa

Chỉ đính kèm đúng file cần thiết, đừng dán cả thư mục.
Dán log/output thì cắt gọn phần liên quan, bỏ đoạn lặp dài.
Tách việc lớn thành các bước nhỏ có mục tiêu rõ ràng.

3. Chọn model hợp lý

Haiku: việc nhẹ (sửa typo, đổi tên, hỏi nhanh) — rẻ token nhất.
Sonnet: việc thường ngày, cân bằng giữa chất lượng và chi phí.
Opus: chỉ dùng cho việc khó, cần suy luận sâu.
Bản -thinking tốn nhiều token hơn — chỉ dùng khi thật sự cần.

💡 Server tự động bỏ phần suy luận cũ (thinking) và nén lịch sử khi context quá lớn, nhưng cách tiết kiệm tốt nhất vẫn là chủ động /clear và /compact.

Nếu thấy báo lỗi "Context quá dài": gõ /compact hoặc /clear rồi gửi lại. Đây là lỗi phía bạn (context vượt giới hạn model), không phải lỗi server.

🔍 Kiểm tra token còn lại

Truy cập trang dưới đây, dán API Key, bấm "Kiểm tra" để xem:

Token đã dùng / còn lại / tổng quota
Hạn sử dụng còn bao nhiêu ngày
Giới hạn request / phút
Trạng thái key

🔑 Mở trang kiểm tra key

🚀 Hướng dẫn sử dụng API

📌 Thông tin chung

🤖 Danh sách Model

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

Các bước dùng (Windows)

Các bước dùng (Mac)

Cấu hình Mac / Linux thủ công (tùy chọn)

Hoặc biến môi trường (Windows CMD)

Mẹo dùng ổn định

1️⃣ VS Code

2️⃣ Cursor

3️⃣ Antigravity

Các bước dùng (Windows)

Các bước dùng (Mac)

Các bước

Cách 1 - OpenAI Compatible (khuyên dùng)

Cách 2 - Anthropic

Các bước

Các bước

Định dạng OpenAI

Định dạng Anthropic

💰 Mẹo tiết kiệm token

1. Quản lý phiên chat

2. Hạn chế file & ngữ cảnh thừa

3. Chọn model hợp lý

🔍 Kiểm tra token còn lại