Hướng dẫn cấu hình Grok Build: kết nối NextHub API

Grok Build là trợ lý lập trình terminal do xAI phát triển. Theo tài liệu chính thức, file cấu hình chính của nó là ~/.grok/config.toml, và bạn có thể chuyển các yêu cầu model sang nhóm Grok của NextHub (0.55x, kênh chính thức).

Các bước kết nối

1. Cài đặt Grok Build

Windows (PowerShell)

irm https://x.ai/cli/install.ps1 | iex

macOS / Linux / WSL

curl -fsSL https://x.ai/cli/install.sh | bash

Sau khi cài xong, mở lại terminal và chạy lệnh sau để xác nhận đã dùng được:

grok --version

2. Mở thư mục cấu hình

Windows (CMD)

start "" "%USERPROFILE%\.grok"

macOS / Linux

mkdir -p ~/.grok

Nếu trong thư mục chưa có config.toml, hãy tự tạo một file cùng tên.

3. Ghi cấu hình

Ghi nội dung sau vào config.toml:

[models]
default = "grok-4.6"
web_search = "grok-4.6"

[endpoints]
models_base_url = "https://api.nexthub.cc/v1"

[model."grok-4.6"]
model = "grok-4.6"
name = "Grok 4.6"
description = "Grok 4.6 via NextHub"
api_key = "ApiKey NextHub của bạn"
api_backend = "responses"
context_window = 500000
supports_backend_search = false

Hai công tắc tương thích

supports_backend_search = false để tắt tìm kiếm backend của Grok (gateway không cung cấp khả năng này; nếu không tắt, yêu cầu sẽ bị gắn thêm tham số tìm kiếm backend và có thể báo lỗi). Nếu muốn dùng lệnh /effort và tham số --effort để điều chỉnh mức độ suy luận, hãy thêm một dòng supports_reasoning_effort = true vào cùng khối cấu hình. Sau khi sửa cấu hình cần khởi động lại Grok Build thì mới tải lại được.

Base URL nhớ kèm /v1

models_base_url điền endpoint tương thích OpenAI của NextHub https://api.nexthub.cc/v1. API Key dùng khóa (API) của nhóm Grok; hiện nhóm Grok cung cấp các model dòng grok-4.5, grok-4.6, grok-4.3, grok-4.20 và grok-build-0.1, v.v., danh sách đầy đủ lấy dữ liệu thời gian thực của Model Plaza làm chuẩn.

Nếu không muốn ghi trực tiếp khóa vào file cấu hình, hãy thay dòng api_key = "..." bằng env_key = "NEXTHUB_API_KEY", rồi cấu hình NEXTHUB_API_KEY trong biến môi trường hệ thống. Lưu ý env_key điền là tên biến môi trường, không phải bản thân khóa.

4. Xác minh cấu hình

grok inspect
grok -p "chỉ trả lời ok" -m grok-4.6

Nếu grok inspect đọc được cấu hình và lệnh kiểm tra nhận được phản hồi ok là đã kết nối thành công.

Các vấn đề thường gặp

/effort điều chỉnh mức độ suy luận không có hiệu lực

Model chưa khai báo supports_reasoning_effort = true (xem "Hai công tắc tương thích" ở trên), nên lệnh /effort và tham số --effort sẽ không có hiệu lực với model đó. Sau khi sửa cấu hình cần khởi động lại Grok Build thì mới tải lại được.

Báo model không tồn tại hoặc không có quyền

Kiểm tra lần lượt: ApiKey có phải của nhóm Grok không, models_base_url có phải https://api.nexthub.cc/v1 không, model có khớp với ID trong danh sách model không, khóa có được copy đầy đủ không (không có khoảng trắng thừa ở đầu hoặc cuối).