Bản chụp tài liệu · CLI 7.30.1 · SDK 2.6.53. Desktop dùng môi trường chạy đi kèm bản phát hành riêng. Các lệnh và ví dụ được giữ nguyên từ bản tiếng Anh. Bản tiếng Anh

Kết nối nhà cung cấp mô hình đầu tiên

Chọn cách kết nối

Nhà cung cấp là kết nối tới dịch vụ mô hình; mô hình là lựa chọn cụ thể qua kết nối đó. Kết nối nhà cung cấp không chọn tất cả mô hình hay cấp quyền truy cập tài khoản.

Trong giao diện terminal, nhập /connect rồi chọn một cách bên dưới. Desktop có thiết lập nhà cung cấp và môi trường chạy đi kèm riêng; các lệnh dấu gạch chéo này dành cho terminal.

API đám mây: chọn API Cloud Provider, chọn dịch vụ và làm theo hướng dẫn nhập thông tin xác thực. Gói đăng ký trò chuyện không nhất thiết có quyền dùng API hoặc tín dụng API.
CLI lập trình: cài đặt và đăng nhập CLI được hỗ trợ trước, rồi chọn CLI Provider. AX Code dùng lại phiên đăng nhập cục bộ đó; khả năng tùy thuộc bộ điều hợp.
Mô hình cục bộ: khởi động Ollama hoặc LM Studio, nạp mô hình hỗ trợ gọi công cụ, rồi chọn Local LLM runtime và xác nhận điểm cuối. AX-Engine runtime có quy trình thiết lập và tải mô hình riêng trên máy Mac được hỗ trợ.
Cổng trung gian: chọn AX Trust cho điểm cuối AX Trust, API Cloud Provider → Custom API provider cho cổng khác, hoặc Private GPU cloud cho triển khai tương thích chuyên dụng. Nhập URL dịch vụ, mã thông báo và ID mô hình chính xác mà dịch vụ công bố.

Kiểm tra kết nối

Chạy các lệnh sau trong terminal tương tác. Lệnh đăng nhập sẽ hỏi nhà cung cấp và thông tin xác thực; không dán khóa thật vào lệnh chia sẻ hoặc tệp trong kho mã.

ax-code providers login
ax-code providers list
ax-code models

Bạn sẽ thấy nhà cung cấp và các ID mô hình dùng được. Lưu thông tin xác thực hay lấy danh sách thành công chưa chứng minh quyền suy luận. Tiếp tục với chọn mô hình và gửi một yêu cầu thử nhỏ.

Quản lý thông tin xác thực và cấu hình

Dùng /providers để quản lý kết nối và /connect để thay khóa. Vô hiệu hóa giữ lại thông tin đã lưu; ngắt kết nối xóa chúng. Biến môi trường và khóa cấu hình vẫn có thể cung cấp quyền truy cập.

Dùng ax-code.json của dự án cho thiết lập chung không bí mật, hoặc ~/.config/ax-code/ax-code.json toàn cục cho mặc định cá nhân. Không đưa bí mật vào quản lý phiên bản; dùng lời nhắc xác thực hoặc tham chiếu môi trường trong hướng dẫn cổng trung gian. Khởi động lại sau khi sửa cấu hình thủ công.

Nếu thiết lập thất bại

Lỗi xác thực: kiểm tra khóa thuộc đúng dịch vụ, điểm cuối và gói API đã chọn. Với CLI lập trình, kiểm tra đăng nhập của chính CLI trước.
Danh sách trống hoặc kết nối bị từ chối: kiểm tra máy chủ cục bộ đang chạy, mô hình đã nạp, URL và cổng đúng. Ollama thường dùng http://localhost:11434/v1; LM Studio dùng http://localhost:1234/v1.
Mô hình bị từ chối: dùng ID chính xác từ điểm cuối và kiểm tra quyền tài khoản. Tên hiển thị qua cổng có thể khác ID gửi đến dịch vụ phía trên.
Không thấy nhà cung cấp: kiểm tra enabled_providers và disabled_providers. Để chẩn đoán cài đặt, chạy ax-code doctor; lệnh này không xác thực tài khoản nhà cung cấp.

Bước tiếp theo

Danh mục nhà cung cấp và cách đăng nhập · Cổng tùy chỉnh và điểm cuối GPU riêng · Chọn mô hình · Tạo AX Wiki · Trang tài liệu