Cài đặt Command Code BYOK

Kết nối TokenHub thông qua Command Code BYOK và xác thực mô hình mã hóa compatible trước khi bật chỉnh sửa.

Command Code là gì?

Command Code là một tác nhân mã hóa dòng lệnh với luồng BYOK dành cho các nhà cung cấp mô hình OpenAI-compatible và Anthropic-wire.

Hướng dẫn Command Code BYOK này tuân theo quy trình làm việc /connect chính thức. Nó sử dụng root OpenAI-compatible API, lưu trữ thông tin xác thực trong cửa hàng xác thực cục bộ và cho phép ID mô hình thủ công khi không thể khám phá. Luồng BYOK chính thức lưu trữ thông tin xác thực của nhà cung cấp cục bộ và cho phép người dùng chọn mô hình kết quả với /model. Chọn dây API một cách có chủ ý, nhập ID mô hình đầy đủ khi khám phá trống và xác minh việc đọc mã và lệnh gọi công cụ trước khi cho phép Command Code thay đổi kho lưu trữ đang hoạt động.

Command Code hiện đánh dấu BYOK là Beta. Trình hướng dẫn nhà cung cấp tùy chỉnh của nó yêu cầu ID, giao thức dây, gốc, khóa và mô hình API theo trình tự; nó không phải là một dạng ba trường chung.

Thêm TokenHub bằng trình hướng dẫn BYOK chính thức

  1. Chạy /connect trong Command Code.
  2. Chọn (BYOK) Add your own provider.
  3. Tại Name it, nhập ID chữ thường tokenhub. Tên này trở thành tên mục nhập trong ~/.commandcode/providers.json và các mẫu được định tuyến là tokenhub/<model-id>.
  4. Tại Pick the wire, chọn dây OpenAI-compatible mặc định là openai-completions. Chỉ chọn anthropic-messages cho Anthropic Messages.
  5. Tại Point at the endpoint, nhập API gốc https://us-api.tokenhub.com/v1. Command Code có thể cắt bớt /chat/completions được dán vô tình, nhưng bạn nên nhập trực tiếp vào đúng gốc.
  6. Tại Add the key, dán khóa TokenHub API của bạn. Trình hướng dẫn lưu nó vào ~/.commandcode/auth.json; không cam kết một khóa cho một kho lưu trữ.
  7. Tại Declare the models, hãy để trình hướng dẫn yêu cầu /models. Nếu việc khám phá không trả về kết quả nào, hãy nhập ID mẫu TokenHub chính xác theo cách thủ công.

Trên màn hình không nhập liệu, nhấn h để được trợ giúp ngắn gọn hoặc esc để quay lại bước trước đó. Khi quá trình thiết lập kết thúc, Command Code sẽ mở /model, nơi nhà cung cấp mới xuất hiện cùng với các mô hình tích hợp sẵn.

Chỉ chỉnh sửa nhà cung cấp.json khi cần thay đổi thủ công

Định nghĩa nhà cung cấp có trong ~/.commandcode/providers.json. Mở lại /connect hoặc /model để tải lại các thay đổi:

{
  "provider": {
    "tokenhub": {
      "name": "TokenHub",
      "baseURL": "__API_BASE_URL__/v1",
      "api": "openai-completions",
      "apiKey": "$TOKENHUB_API_KEY",
      "models": {
        "YOUR_TOKENHUB_MODEL_ID": {}
      }
    }
  }
}

Nếu /connect đã lưu khóa, đừng sao chép nó trong tệp nhà cung cấp. Một mô hình cũng có thể khai báo contextWindow, maxOutput, reasoningEffortsoptions nhưng chỉ thêm các khả năng đã được xác minh cho mô hình TokenHub đó.

Duy trì kết nối từ thẻ Nhà cung cấp của nó

Chạy lại /connect và chọn tokenhub. Thẻ Nhà cung cấp hiển thị điểm cuối, số lượng mẫu và trạng thái khóa:

  • r: thay thế hoặc lưu chìa khóa.
  • u: tìm nạp lại mô hình mà không thay đổi dây, tiêu đề hoặc tham chiếu khóa.
  • c: xóa khóa đã lưu.
  • d: xóa nhà cung cấp và thông tin đăng nhập cục bộ của nhà cung cấp đó.

Một nhà cung cấp khỏe mạnh hiển thị séc màu xanh lá cây và số lượng mô hình. Nếu providers.json không hợp lệ, Command Code bỏ qua mục nhập xấu mà không ghi đè tệp và báo cáo đường dẫn của nó trong /connect hoặc --list-models.

Xác minh định tuyến từ/model

Chạy /model, chọn một mô hình trong nhóm TokenHub và đặt câu hỏi về kho lưu trữ chỉ đọc. Xác nhận ID mẫu và /v1/chat/completions trong nhật ký TokenHub. Đối với 401, quay lại thẻ Nhà cung cấp và nhấn r; đối với 404, hãy kiểm tra baseURLapi; nếu mô hình vắng mặt, nhấn u hoặc khai báo nó trong providers.json.

Tài liệu tham khảo chính thức

Chọn mô hình

Khối lượng công việcLựa chọn mô hìnhLý do phù hợp
Tác vụ phức tạpMô hình suy luận hỗ trợ công cụPhù hợp với lập kế hoạch, nhiều bước và ngữ cảnh dài.
Sử dụng hằng ngàyMô hình cân bằngCân bằng chất lượng, tốc độ và chi phí.
Tóm tắt và tác vụ nhẹMô hình nhanh, chi phí thấpGiảm chi phí cho tóm tắt và lặp lại đơn giản.
Xem mô hình TokenHub

Command Code BYOK FAQ

Tôi nên chọn dây nào cho TokenHub?

Chọn OpenAI-compatible khi sử dụng root TokenHub API kết thúc bằng /v1.

Command Code lưu khóa API ở đâu?

Luồng /connect lưu trữ khóa của nhà cung cấp trong bộ lưu trữ xác thực cục bộ của Command Code. Tránh nhập khóa vào providers.json.

Nếu danh sách mô hình trống thì sao?

Nhập ID mẫu TokenHub chính xác theo cách thủ công trong luồng BYOK hoặc providers.json, sau đó chọn ID đó trong /model.

Làm cách nào để kiểm tra Command Code một cách an toàn sau khi thiết lập BYOK?

Chọn mô hình TokenHub với /model và bắt đầu bằng câu hỏi về kho lưu trữ chỉ đọc. Xác minh nhật ký yêu cầu trước khi cấp quyền chỉnh sửa hoặc lệnh.

Tại sao Command Code lại đến sai điểm cuối?

Kiểm tra dây được chọn trong /connect. Root TokenHub /v1 thuộc về dây OpenAI-compatible trừ khi bạn cố tình định cấu hình điểm cuối Anthropic Messages.

Tài liệu tham khảo

Cấu hình này dựa trên TokenHub và tài liệu chính thức; lần xác minh gần nhất: 2026-09-08。