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

OpenCode là một công cụ lập trình AI chạy trên terminal, hỗ trợ kết nối nhiều mô hình. Dưới đây hướng dẫn bạn kết nối kênh Claude của NextHub.

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

1. Cài đặt OpenCode

Đảm bảo đã cài đặt Node.js, sau đó cài đặt OpenCode toàn cục:

npm i -g opencode-ai

Sau khi cài đặt xong, chạy một lần trước để nó tạo thư mục cấu hình mặc định:

opencode

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

Windows (CMD)

start "" "%USERPROFILE%\.config\opencode"

macOS (Terminal)

open "$HOME/.config/opencode"

3. Chỉnh sửa opencode.json, nhập cấu hình Claude

Trong thư mục cấu hình, tìm tệp opencode.json (chưa có thì tạo mới), theo schema chính thức của OpenCode, nhập ApiKey của bạn và địa chỉ kết nối NextHub vào provider.anthropic.options:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "anthropic": {
      "options": {
        "apiKey": "ApiKey NextHub của bạn",
        "baseURL": "https://api.nexthub.cc"
      }
    }
  }
}

Base URL không được thêm /v1

OpenCode sẽ tự động nối /v1/messages vào phía sau baseURL, nên ở đây chỉ cần điền tên miền trần https://api.nexthub.cc, không thêm /v1 ở cuối.

4. Kiểm tra xem cấu hình đã thành công chưa

Chạy opencode, nhập lệnh /models, nếu thấy mô hình Claude xuất hiện trong danh sách tức là thành công:

opencode
# Chạy sau khi vào giao diện tương tác
# /models

Cũng kết nối được kênh GPT

Thêm nhà cung cấp openai vào cùng một tệp opencode.json là dùng được dòng mô hình GPT / Codex:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "anthropic": {
      "options": {
        "apiKey": "ApiKey NextHub của bạn",
        "baseURL": "https://api.nexthub.cc"
      }
    },
    "openai": {
      "options": {
        "apiKey": "ApiKey NextHub của bạn",
        "baseURL": "https://api.nexthub.cc/v1"
      }
    }
  }
}

Cách điền địa chỉ cho hai nhóm là khác nhau

anthropic dùng giao thức Anthropic, baseURL điền tên miền trần https://api.nexthub.cc (tự động nối thêm /v1/messages); openai dùng giao thức tương thích OpenAI, baseURL phải kèm /v1. Hai ApiKey thì chọn nhóm tương ứng cho từng cái (nhóm dòng Claude với nhóm GPT-Azure / GPT-Pro), cũng có thể dùng chung một ApiKey — nhưng nhóm quyết định mô hình dùng được, nên thường tách ra cấu hình sẽ rõ ràng hơn.