Tiếp Quản Một Chạm Công Cụ Lập Trình AI

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

Nguyên Lý Hoạt Động

Khi thực hiện tiếp quản từng công cụ, cổng AI sẽ tự động thực hiện các bước sau:

1. Kiểm tra tình trạng cổng để đảm bảo điểm truy cập proxy khả dụng.
2. Tự động tạo một khóa ảo riêng biệt (chỉ hiển thị một lần duy nhất khi tạo, cổng sẽ ghi trực tiếp vào cấu hình công cụ).
3. Sao lưu file cấu hình gốc với đuôi .bak (ví dụ: ~/.claude/settings.json.bak).
4. Ghi/ghép cấu hình chính xác trỏ về cổng AI, giữ nguyên các thiết lập khác của bạn.
5. Cập nhật trạng thái giao diện để hiển thị tình trạng tiếp quản hiện tại.

Khi gỡ tiếp quản, cũng sẽ thực hiện "gỡ chính xác": Chỉ xóa mục liên quan tới cổng AI nếu thực sự đang trỏ về đó, tránh làm mất các cài đặt bạn đã tự chỉnh tay.

Trạng Thái Tiếp Quản

Mỗi công cụ trong trang AI Gateway → Endpoints (Điểm cuối) sẽ hiển thị một trong bốn trạng thái sau:

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

Điều Kiện Tiên Quyết

• Đã đăng nhập tài khoản ServBay, và đã thiết lập ít nhất một kênh khả dụng trong Quản lý kênh.
• Công cụ AI mục tiêu đã được cài đặt trên máy (việc phát hiện dựa vào thư mục cấu hình).

Cách Tiếp Quản Một Chạm

Vào AI Gateway → Endpoints (Điểm cuối), tìm công cụ mong muốn và nhấn Tiếp quản một chạm. Nếu thành công, trạng thái sẽ chuyển thành "Đã tiếp quản (Cổng này)". Để hoàn tác, chỉ cần nhấn Gỡ/Bỏ khôi phục.

Chi Tiết Tiếp Quản Từng Công Cụ

Bảng dưới liệt kê đường dẫn file cấu hình và nội dung được chỉnh sửa khi tiếp quản từng công cụ, giúp bạn theo dõi hoặc xử lý sự cố dễ dàng hơn:

Công cụ	File cấu hình	Nội dung ghi thêm	Địa chỉ cổng AI
Claude Code	~/.claude/settings.json	Thêm env.ANTHROPIC_BASE_URL + env.ANTHROPIC_AUTH_TOKEN	http://127.0.0.1:11580 (không có /v1)
Codex	~/.codex/config.toml	Thêm mục [model_providers.servbay] + trường model_provider = "servbay"	http://127.0.0.1:11580/v1
Gemini CLI	~/.gemini/.env	Thêm hai dòng GOOGLE_GEMINI_BASE_URL + GEMINI_API_KEY	http://127.0.0.1:11580
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	Thêm mục [model_providers.servbay] + mô hình	http://127.0.0.1:11580/v1
CodeBuddy	~/.codebuddy/models.json	Ghép node model servbay	http://127.0.0.1:11580/v1
opencode	~/.config/opencode/opencode.json	Ghép node provider.servbay (tổng hợp các kênh model)	http://127.0.0.1:11580/v1
Crush	~/.config/crush/crush.json	Ghép node providers.servbay	http://127.0.0.1:11580/v1

Vì sao Claude Code không có /v1

Claude Code sử dụng giao thức Anthropic; cổng AI sẽ tự động nối thêm /v1/messages và các đường dẫn khác khi cần. Do đó, biến ANTHROPIC_BASE_URL phải là gốc cổng AI (không có /v1). Đa phần công cụ khác dùng chuẩn OpenAI nên cần hậu tố /v1. Chế độ tiếp quản một chạm sẽ tự động điền đúng quy ước cho 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ấn Gỡ/Bỏ khôi phục, cổng sẽ xóa chính xác phần cấu hình đã thêm. Bạn cũng có thể phục hồi thủ công từ file .bak cùng thư mục.
• Trạng thái “Đã kết nối (Địa chỉ khác)” — Có nghĩa công cụ đang dùng địa chỉ khác (bạn tự chỉnh hoặc trỏ sang cổng khác). Để tránh ghi đè, cổng AI sẽ không tiếp quản tự động. Bạn cần xóa cấu hình đó trước rồi tiếp quản lại.
• Sau tiếp quản mà công cụ vẫn báo lỗi — Hãy kiểm tra proxy của cổng AI đã chạy, kênh mục tiêu hoạt động tốt và khóa ảo chưa bị thu hồi. Bạn cũng có thể vào mục Thống kê & giám sát để xác nhận yêu cầu đã gửi đến cổng AI.

Câu Hỏi Thường Gặp (FAQ)

• Hỏi: Tiếp quản một chạm có làm thay đổi các cài đặt gốc của công cụ không?
  • Trả lời: Không. Cổng chỉ ghi/ghép chính xác các mục liên quan đến cổng AI, và luôn sao lưu file cũ thành .bak. Các thiết lập khác giữ nguyên.
• Hỏi: Tiếp quản xong có hoàn tác thủ công được không?
  • Trả lời: Được. Nhấn "Gỡ" do cổng AI tự động xử lý hoặc tự phục hồi từ file .bak.
• Hỏi: Khóa ảo dùng để tiếp quản nằm đâu?
  • Trả lời: Cổng sẽ tự động tạo khóa ảo riêng biệt cho từng công cụ khi tiếp quản; bạn có thể quản lý tại trang Khóa.
• Hỏi: Trong danh sách báo “Chưa phát hiện công cụ”?
  • Trả lời: Nghĩa là không tìm thấy thư mục cấu hình; hãy cài và chạy công cụ ít nhất một lần để khởi tạo cấu hình rồi mới tiếp quản.

Tổng Kết

Tính năng tiếp quản một chạm giúp loại bỏ hoàn toàn sự rườm rà và rủi ro khi phải chỉnh sửa thủ công tệp cấu hình cho từng công cụ AI. Chỉ với một lần nhấn, hệ thống sẽ tự động tạo khóa, sao lưu, ghi chính xác và cho phép khôi phục bất cứ lúc nào. Kết hợp quản trị kênh và thống kê dùng lượng tập trung, bạn có thể dùng chung mọi công cụ AI với duy nhất một bộ cấu hình và theo dõi chi phí hiệu quả. Nếu bạn muốn tích hợp cổng AI trong code của mình, hãy xem thêm tại Điểm cuối và biến môi trường.