Tiếp quản một chạm các công cụ lập trình AI

Tiếp quản một chạm (Takeover) cho phép bạn định hướng các công cụ CLI lập trình AI thường dùng đến cổng AI cục bộ mà không cần chỉnh sửa thủ công bất kỳ tệp cấu hình nào. Sau khi tiếp quản, các yêu cầu từ những công cụ này sẽ được định tuyến thống nhất qua http://127.0.0.1:11580 đến kênh nhà cung cấp bạn đã cấu hình trong cổng, đồng thời được đưa vào thống kê mức sử dụng và chi phí tập trung.

Nguyên lý hoạt động

Khi thực hiện tiếp quản một chạm cho mỗi công cụ, cổng sẽ lần lượt:

1. Kiểm tra tình trạng hoạt động của cổng, xác nhận điểm cuối proxy khả dụng.
2. Tự động tạo một khóa ảo riêng (cổng sẽ ghi vào cấu hình công cụ; bản rõ có thể lấy lại bất cứ lúc nào tại trang khóa).
3. Sao lưu tệp cấu hình gốc thành tệp có hậu tố .bak (ví dụ ~/.claude/settings.json.bak).
4. Ghi chính xác / hợp nhất sâu cấu hình trỏ đến cổng, giữ nguyên các thiết lập khác của bạn.
5. Làm mới trạng thái giao diện, hiển thị tình trạng tiếp quản hiện tại.

Khi dừng tiếp quản cũng là "gỡ bỏ chính xác": chỉ khi cấu hình thực sự trỏ đến cổng này, các khóa tương ứng mới bị gỡ bỏ, tránh xóa nhầm các thiết lập khác bạn tự cấu hình; đồng thời khóa ảo được tạo tự động khi tiếp quản sẽ bị thu hồi.

Trạng thái tiếp quản

Mỗi công cụ tại trang Cổng AI → Quản lý kết nối → Client sẽ hiển thị một trong bốn trạng thái:

Trạng thái	Ý nghĩa
Đã tiếp quản (cổng này)	Công cụ đã trỏ đến cổng AI cục bộ
Đã kết nối (địa chỉ khác)	Công cụ đã được cấu hình địa chỉ khác (bạn tự cấu hình hoặc trỏ đến cổng khác), cổng sẽ không tự ý ghi đè
Chưa tiếp quản	Đã phát hiện công cụ, nhưng chưa trỏ đến cổng
Không phát hiện	Không tìm thấy thư mục cấu hình của công cụ này trên máy cục bộ

Điều kiện tiên quyết

• Đã đăng nhập tài khoản ServBay và đã cấu hình ít nhất một kênh khả dụng tại trang Kênh.
• Công cụ AI mục tiêu đã được cài đặt trên máy cục bộ (cổng dựa vào thư mục cấu hình của nó để xác định có tồn tại hay không).

Thao tác tiếp quản một chạm

Truy cập trang Cổng AI → Quản lý kết nối → Client, tìm công cụ mục tiêu trong danh sách, nhấp Tiếp quản một chạm. Sau khi tiếp quản thành công, trạng thái chuyển thành "Đã tiếp quản (cổng này)". Nếu muốn thu hồi, nhấp Dừng tiếp quản.

Chi tiết tiếp quản từng công cụ

Bảng dưới đây liệt kê tệp cấu hình và nội dung thực tế bị sửa đổi khi mỗi công cụ được tiếp quản, giúp bạn hiểu và khắc phục sự cố:

Công cụ	Tệp cấu hình	Nội dung ghi	Địa chỉ cổng
Claude Code	~/.claude/settings.json	env.ANTHROPIC_BASE_URL + env.ANTHROPIC_AUTH_TOKEN	http://127.0.0.1:11580 (không có /v1)
Codex	~/.codex/config.toml	Phần [model_providers.servbay] + model_provider = "servbay" cấp cao nhất	http://127.0.0.1:11580/v1
Qwen Code	~/.qwen/.env	OPENAI_BASE_URL + OPENAI_API_KEY (tương thích OpenAI)	http://127.0.0.1:11580/v1
Kimi CLI	~/.kimi/config.toml	Phần [model_providers.servbay] + định nghĩa mô hình	http://127.0.0.1:11580/v1
CodeBuddy	~/.codebuddy/models.json	Hợp nhất sâu nút mô hình servbay	http://127.0.0.1:11580/v1
opencode	~/.config/opencode/opencode.json	Hợp nhất sâu nút provider.servbay (tổng hợp mô hình các kênh)	http://127.0.0.1:11580/v1
Crush	~/.config/crush/crush.json	Hợp nhất sâu nút providers.servbay	http://127.0.0.1:11580/v1

Tại sao địa chỉ của Claude Code không có /v1

Claude Code sử dụng giao thức Anthropic, cổng sẽ tự ghép các đường dẫn như /v1/messages, do đó ANTHROPIC_BASE_URL phải là địa chỉ gốc của cổng (không có /v1). Hầu hết các công cụ còn lại đi theo giao thức tương thích OpenAI, cần có hậu tố /v1. Tiếp quản một chạm sẽ tự động điền theo quy ước của từng công cụ, bạn không cần phân biệt thủ công.

Khôi phục và khắc phục sự cố

• Khôi phục cấu hình gốc — Nhấp Gỡ bỏ, cổng sẽ gỡ bỏ chính xác cấu hình trỏ đến cổng này. Bạn cũng có thể khôi phục thủ công bằng tệp sao lưu .bak trong cùng thư mục.
• Trạng thái hiển thị "Đã kết nối (địa chỉ khác)" — Nghĩa là công cụ hiện đang trỏ đến địa chỉ khác (bạn tự cấu hình hoặc trỏ đến cổng khác). Để tránh ghi đè thiết lập của bạn, cổng sẽ không tự động tiếp quản; bạn có thể dọn dẹp cấu hình đó thủ công trước rồi tiếp quản.
• Sau khi tiếp quản công cụ vẫn báo lỗi — Xác nhận dịch vụ proxy của cổng đang chạy, kênh tương ứng khỏe mạnh, khóa ảo chưa bị thu hồi, đồng thời có thể xem tại trang Thống kê và giám sát để kiểm tra yêu cầu có đến cổng hay không.

Câu hỏi thường gặp (FAQ)

• Hỏi: Tiếp quản một chạm có làm hỏng cấu hình công cụ sẵn có của tôi không?
  • Đáp: Không. Cổng chỉ ghi chính xác / hợp nhất các khóa liên quan đến cổng, và sao lưu tệp gốc thành .bak trước khi ghi. Các thiết lập khác được giữ nguyên.
• Hỏi: Sau khi tiếp quản tôi có thể tự sửa lại thủ công không?
  • Đáp: Có. Nhấp "Gỡ bỏ" để cổng thu hồi, hoặc dùng bản sao lưu .bak để khôi phục thủ công.
• Hỏi: Khóa ảo dùng để tiếp quản ở đâu?
  • Đáp: Cổng sẽ tự động tạo khóa ảo riêng cho mỗi công cụ được tiếp quản, có thể xem và quản lý tại trang Khóa.
• Hỏi: Công cụ trong danh sách hiển thị "Không phát hiện"?
  • Đáp: Nghĩa là không tìm thấy thư mục cấu hình của công cụ này trên máy cục bộ. Vui lòng cài đặt và chạy công cụ đó một lần để tạo thư mục cấu hình rồi tiếp quản.

Tổng kết

Tiếp quản một chạm biến việc "chỉnh sửa thủ công tệp cấu hình của từng công cụ" vốn rườm rà và dễ sai sót thành một cú nhấp: tự động tạo khóa, tự động sao lưu, ghi chính xác, khôi phục bất cứ lúc nào. Kết hợp với kênh thống nhất và thống kê mức sử dụng, bạn có thể để tất cả công cụ lập trình AI trong tay dùng chung một bộ cấu hình nhà cung cấp và góc nhìn chi phí. Nếu bạn muốn gọi cổng trong mã của riêng mình, vui lòng tham khảo Điểm cuối và biến môi trường.