Grok CLI

Grok CLI là một công cụ dòng lệnh, dùng giao diện tương thích OpenAI, có thể trực tiếp trỏ địa chỉ API tùy chỉnh về làm dịch vụ backend của nó.

Chuẩn bịSao chép liên kết neo

Cần cài trước Node.js 18+ và npm.

Khuyến nghị cài từ trang tải chính thức của Node.js: https://nodejs.org/en/download

• macOS/Windows: tải và cài bản LTS
• Linux: cài theo cách của bản phân phối

Người dùng macOS cũng có thể dùng Homebrew:

brew install node

Sau khi cài xong, xác nhận:

node -v
npm -v

Cài đặt Grok CLISao chép liên kết neo

Cài toàn cục bằng npm:

npm install -g @vibe-kit/grok-cli

Sau khi cài xong, kiểm tra:

grok --version

Cấu hình kết nốiSao chép liên kết neo

Grok CLI cung cấp ba cách cấu hình, thứ tự ưu tiên: tham số dòng lệnh > biến môi trường > file cấu hình.

Cách 1: Biến môi trường (khuyến nghị)Sao chép liên kết neo

Thiết lập các biến môi trường sau:

export GROK_BASE_URL="https://aicentos.com/v1"
export GROK_API_KEY="your_api_key_here"

Thử tạm thời thì chỉ cần chạy export trong shell hiện tại. Muốn hiệu lực vĩnh viễn, thêm các câu lệnh trên vào ~/.zshrc hoặc ~/.bashrc, rồi chạy source ~/.zshrc để có hiệu lực.

Cách 2: File cấu hìnhSao chép liên kết neo

Sửa ~/.grok/user-settings.json:

{
  "apiKey": "your_api_key_here",
  "baseURL": "https://aicentos.com/v1",
  "defaultModel": "gpt-4o"
}

Cách 3: Tham số dòng lệnhSao chép liên kết neo

Khi khởi động, chỉ định qua tham số:

grok --base-url https://aicentos.com/v1

Khởi động và sử dụngSao chép liên kết neo

Sau khi cấu hình xong, chạy trực tiếp:

grok

Sau khi khởi động, mở hội thoại trong Grok CLI, nếu nhận được phản hồi bình thường nghĩa là kết nối thành công.

Xác minh và xử lý sự cốSao chép liên kết neo

Nếu gặp lỗi xác thực, hãy kiểm tra:

• GROK_API_KEY có đúng không
• GROK_BASE_URL / baseURL có trỏ đúng địa chỉ dịch vụ không (cần có hậu tố /v1)

Sau khi xác nhận cấu hình không sai, khởi động lại là được.

Lưu ýSao chép liên kết neo

• Grok CLI dùng giao diện tương thích OpenAI, cấu hình đơn giản trực tiếp
• Ba cách cấu hình có thể chọn linh hoạt, khuyến nghị dùng cách biến môi trường
• Địa chỉ API bắt buộc phải chứa hậu tố /v1
• Hỗ trợ tùy chỉnh mô hình mặc định

Liên kết liên quanSao chép liên kết neo

• Tài liệu chính thức: https://docs.aicentos.com/clients/grok-cli.html