Quản lý adapter và mô hình

Hướng dẫn này chỉ cách kết nối nhà cung cấp mô hình và chọn thứ mà agent chạy trên đó.

Mọi thứ ở đây nằm trên một trang: Cài đặt → Máy chủ → Nhà cung cấp mô hình. Mục trong thanh điều hướng phụ ghi “Nhà cung cấp mô hình”; tiêu đề trang ghi “Bộ điều hợp”.

Adapter là gì

Adapter là runner thực thi một lượt agent. Có hai adapter và danh sách này cố định — bạn không thể thêm cái thứ ba.

Adapter	CLI	Truyền tải
Control Center (tích hợp sẵn)	không có	Vòng lặp agent trong tiến trình, nói chuyện với nhà cung cấp qua HTTP
Claude Code	claude	claude -p --output-format stream-json

Cursor, Codex, Anthropic, OpenAI và những cái còn lại là nhà cung cấp trên adapter tích hợp sẵn, không phải CLI riêng. Thứ bạn có thể thêm là một nhà cung cấp khác — bất kỳ endpoint tương thích OpenAI hoặc Anthropic nào. Đó là phần tiếp theo.

Việc phát hiện thăm dò máy chủ, không phải máy của bạn

Thẻ Runner đã phát hiện liệt kê những gì cc_server tìm thấy trên PATH của máy chủ. Trên máy khách mỏng hoặc máy khách web, đó là một máy khác với máy bạn đang nhìn. Hãy cài CLI trên máy chạy cc_server.

Kết nối nhà cung cấp mô hình

Adapter tích hợp sẵn cần ít nhất một nhà cung cấp đã kết nối trước khi có thể chạy. Có mười bốn nhà cung cấp có sẵn trong danh mục.

1. Mở Cài đặt → Máy chủ → Nhà cung cấp mô hình
2. Cuộn xuống Nhà cung cấp & mô hình
3. Tìm nhà cung cấp của bạn và kết nối:

Nhà cung cấp	Cách kết nối
Anthropic	Khóa API. Gói đăng ký Claude Pro/Max không phải là đăng nhập API Anthropic — hãy dùng adapter Claude Code cho gói đó
OpenAI, Codex, Cursor	Đăng nhập OAuth qua trình duyệt, hoặc dùng khóa API. Codex là ChatGPT Plus/Pro thông qua backend Codex Responses, không phải một CLI được khởi chạy
Kimi Code	Chỉ OAuth qua trình duyệt — luồng mã thiết bị. Đây là gói cước trọn gói nên không có giá theo token
OpenRouter, Google Gemini, DeepSeek, Mistral, xAI, z.ai, z.ai GLM Coding Plan, Moonshot (Kimi API)	Khóa API

Điểm kiểm tra: nhãn của hàng chuyển thành Đã kết nối và khi mở rộng, hàng đó liệt kê các mô hình mà nhà cung cấp phục vụ, kèm giá trên mỗi triệu token và cửa sổ ngữ cảnh của từng mô hình.

Token OAuth được lưu vào kho thông tin xác thực của chính máy chủ và được làm mới trước khi hết hạn. Thông tin xác thực của nhà cung cấp có phạm vi toàn máy chủ — mọi không gian làm việc trên bản cài đều dùng chung, chứ không riêng cho một không gian làm việc.

Thêm nhà cung cấp tùy chỉnh

Dùng mục này cho Ollama, LM Studio, vLLM hoặc một triển khai riêng.

1. Trong Nhà cung cấp & mô hình, ở mục Nhà cung cấp tùy chỉnh, nhấn Thêm nhà cung cấp
2. Điền tên, chọn loại API (tương thích OpenAI hoặc tương thích Anthropic) và nhập URL gốc (ví dụ http://localhost:11434/v1)
3. Thêm khóa API nếu endpoint cần, rồi nhấn Thêm nhà cung cấp

Nhà cung cấp tùy chỉnh xuất hiện trong cùng danh sách, kèm nút xóa mà những nhà cung cấp tích hợp sẵn không có.

Chọn mô hình cho agent

1. Mở Cài đặt → Không gian làm việc → Agent và chọn agent
2. Trên tab Cài đặt, chọn adapter
3. Chọn mô hình từ danh sách thả xuống bên cạnh

Với adapter tích hợp sẵn, danh sách thả xuống được tổng hợp trực tiếp từ danh mục riêng của từng nhà cung cấp đã kết nối. Nhà cung cấp không có thông tin xác thực nào được lưu sẽ đóng góp 0 mô hình, vì vậy một danh sách trống gần như luôn có nghĩa là “chưa kết nối gì” chứ không phải “không có gì khả dụng”.

models.dev chỉ bổ sung thông tin, không bao giờ là nguồn id

Danh mục models.dev đi kèm cung cấp giá và cửa sổ ngữ cảnh cho một mô hình đã có trong danh sách trực tiếp. Nó không bao giờ thêm id mô hình. Nếu một mô hình bạn mong đợi bị thiếu, endpoint của nhà cung cấp đang không trả về mô hình đó.

Id mô hình cho adapter tích hợp sẵn có dạng đủ điều kiện provider/model và có thể mang chuỗi dự phòng phân tách bằng |. Khi dùng dự phòng, chi phí được tính theo mô hình thực sự phục vụ lượt chạy, không phải mô hình bạn yêu cầu.

Agent không có adapter sẽ chạy trên vòng lặp tích hợp sẵn

Mỗi không gian làm việc tạo sẵn năm agent — một CEO cùng qa, architect, engineer và librarian — không có adapter và không có mô hình. Việc điều phối sẽ quay về Control Center (tích hợp sẵn), chứ không dùng cài đặt Runner mặc định trên trang này, vốn là tùy chọn của máy khách mà luồng điều phối không bao giờ đọc. Nhật ký chạy ghi cc-harness cho những lần chạy đó, nên bản ghi nêu rõ thứ thực sự đã chạy.

Khi cũng không có mô hình, vòng lặp tích hợp sẵn sẽ hỏi Anthropic mô hình mặc định của nó. Vì vậy một agent để trống hoàn toàn sẽ chạy nếu bạn đã kết nối tài khoản Anthropic, còn nếu không thì thất bại với No credential for provider "anthropic".

Khi hoàn tất bước adapter trong quá trình thiết lập ban đầu, hệ thống sẽ gán bù cặp bạn đã chọn cho mọi agent vẫn còn thiếu adapter hoặc mô hình — cả CEO lẫn các agent chuyên môn, trong mọi không gian làm việc tồn tại tại thời điểm đó. Những không gian làm việc tạo sau vẫn tạo sẵn cả năm agent ở trạng thái chưa đặt. Hãy đặt adapter và mô hình một cách rõ ràng cho mọi agent bạn định dùng.

Cài đặt CLI runner

Adapter tích hợp sẵn không cần cài đặt gì. Với Claude Code, hãy cài CLI của nó trên máy chủ bằng trình quản lý gói của chính công cụ đó, ví dụ:

npm install -g @anthropic-ai/claude-code

Sau đó nhấn Làm mới ở đầu trang. Mỗi hàng được phát hiện hiển thị phiên bản và đường dẫn đã phân giải, cùng các chip cho biết nó có hỗ trợ chế độ JSON và chọn mô hình hay không.

CLI bên ngoài giữ thông tin xác thực riêng, trong cấu hình riêng của nó, trên máy chủ. Control Center không quản lý chúng.

Tham số thêm và Biến môi trường của adapter chỉ nằm trên thiết bị này

Mỗi hàng adapter có trường Tham số thêm và hộp thoại Biến môi trường. Những giá trị đó được lưu trên thiết bị của bạn. Máy chủ đọc argv và biến môi trường khi khởi chạy từ kho cài đặt của chính nó. Hãy đặt khóa nhà cung cấp trên máy chủ (OAuth hoặc trường khóa trên trang Nhà cung cấp mô hình), không đặt trong hai trường đó.

Hạn chế nhà cung cấp mà không gian làm việc được dùng

Việc quản trị nhà cung cấp được thực hiện theo từng không gian làm việc và được đánh giá theo kiểu kết quả khớp cuối cùng thắng.

1. Trong Nhà cung cấp & mô hình, tắt công tắc Cho phép trên hàng của một nhà cung cấp

Thao tác đó ghi một câu lệnh deny cho nhà cung cấp đó trong không gian làm việc đang hoạt động và các mô hình của nó bị loại khỏi danh mục cho không gian làm việc đó. Bật lại công tắc sẽ xóa câu lệnh đó.

Xử lý sự cố

Runner hiển thị là không tìm thấy

• Kiểm tra xem CLI có nằm trên PATH của máy chủ hay không, chứ không chỉ trên PATH của bạn
• Ứng dụng desktop khởi chạy từ GUI sinh tiến trình máy chủ với PATH tối thiểu; một CLI chỉ được cài trong đường dẫn dành riêng cho shell có thể không hiển thị với nó
• Nhấn Làm mới sau khi cài

Danh sách thả xuống mô hình trống

• Adapter đang là loại tích hợp sẵn và chưa có nhà cung cấp nào được kết nối — hãy kết nối một nhà cung cấp trong Nhà cung cấp & mô hình
• Hoặc nhà cung cấp đã được kết nối nhưng bị công tắc quản trị của không gian làm việc này từ chối

Mô hình chạy được nhưng giá hiển thị là không xác định

Danh sách mô hình trực tiếp mang id; giá và ngữ cảnh đến từ models.dev. Một mô hình hoàn toàn mới, hoặc đến từ nhà cung cấp tùy chỉnh, chưa có mục trong danh mục.

Hướng dẫn liên quan

• Tạo và cấu hình một agent
• Quản lý khóa API
• Chẩn đoán một agent
• Quản lý chi phí

Khái niệm liên quan

• Mô hình agent
• Vòng đời điều phối agent