Công cụ dòng lệnh và tác tử
Chọn công cụ phát triển phù hợp cho AGTCloud theo tình huống sử dụng, giao thức và phạm vi quyền.
AGTCloud có thể tích hợp với tác tử dòng lệnh, tiện ích mở rộng IDE, ứng dụng máy tính và công cụ quản lý cấu hình. Khi chọn công cụ, hãy xác định cách làm việc và giao thức trước, sau đó đánh giá các tệp, lệnh và dịch vụ bên ngoài mà công cụ có thể truy cập.
Trang này giúp bạn chọn nhanh hướng dẫn, không lặp lại các bước cài đặt và cấu hình của từng công cụ. Trong hướng dẫn cụ thể, hãy tuân theo yêu cầu về Base URL, xác thực và mô hình.
Công cụ tác tử có thể thực hiện thao tác trên máy cục bộ
Một số công cụ có thể đọc và sửa tệp, chạy lệnh Shell hoặc truy cập mạng. Khi kết nối lần đầu, hãy dùng thư mục thử nghiệm không chứa dữ liệu nhạy cảm, tắt phê duyệt tự động và bắt đầu bằng tác vụ chỉ đọc.
Chọn theo công cụ
| Công cụ | Hình thức sử dụng | Giao thức kết nối AGTCloud | Phù hợp hơn với |
|---|---|---|---|
| Claude Code | Tác tử lập trình trong terminal | Anthropic Messages | Quy trình Claude Code hiện có cần giữ cấu trúc Messages và Content Blocks |
| Codex | CLI và ứng dụng máy tính | OpenAI Responses | Responses, Typed Items hoặc quy trình dự án Codex |
| Gemini CLI | Tác tử trong terminal | Gemini Generate Content | Quy trình đã dùng cấu trúc Gemini Contents và Parts |
| Cline | Tiện ích mở rộng IDE | OpenAI Chat Completions | Xem xét thao tác của tác tử trong trình soạn thảo tương thích VS Code hoặc JetBrains |
| Cherry Studio | Ứng dụng trò chuyện trên máy tính | OpenAI Chat Completions | Trò chuyện với nhiều mô hình qua giao diện đồ họa và kiểm tra kết nối cơ bản |
| OpenClaw | Gateway tự lưu trữ, TUI và Control UI | OpenAI Chat Completions | Gateway cục bộ và môi trường tác tử cá nhân có thể mở rộng |
| CC-Switch | Công cụ quản lý cấu hình cục bộ | Anthropic Messages, OpenAI Responses | Lưu và chuyển đổi cấu hình Provider cho Claude Code và Codex |
| Hermes Agent | Tác tử trong terminal | OpenAI Chat Completions | Custom Endpoint, phiên terminal và quy trình gọi công cụ |
Tên giao thức không đại diện cho nhà cung cấp mô hình. Một mô hình có thể có nhiều điểm vào giao thức, nhưng khả năng gọi công cụ, đa phương thức, suy luận và ngữ cảnh vẫn phụ thuộc vào phạm vi hỗ trợ thực tế của mô hình hiện tại.
Chọn theo tác vụ
| Mục tiêu | Hướng dẫn nên xem trước | Lý do lựa chọn |
|---|---|---|
| Phân tích và sửa mã trong terminal | Claude Code, Codex, Gemini CLI | Cả ba đều có quy trình terminal đầy đủ, nhưng dùng cấu trúc giao thức khác nhau |
| Xem xét từng thao tác trên tệp và lệnh trong IDE | Cline | Kế hoạch thao tác, thay đổi tệp và quá trình cấp quyền nằm trong trình soạn thảo |
| Trò chuyện thông thường qua giao diện đồ họa | Cherry Studio | Có thể kiểm tra kết nối từ giao diện trò chuyện sau khi cấu hình nhà cung cấp và mô hình |
| Chạy tác tử tự lưu trữ trên máy cục bộ | OpenClaw, Hermes Agent | Cung cấp Gateway hoặc tác tử CLI, cần kiểm soát quyền trên máy chủ chặt chẽ hơn |
| Quản lý nhiều cấu hình Claude Code hoặc Codex | CC-Switch | Lưu và chuyển đổi Provider trên máy cục bộ, không thay thế máy khách thực sự gửi yêu cầu |
| Kết nối công cụ và nguồn dữ liệu bên ngoài | Kết nối MCP và bảo mật | MCP là giao thức giữa máy khách và dịch vụ công cụ, không phải API mô hình |
Kiểm tra trước khi kết nối
1. Xác định hình thức sử dụng
Quyết định bạn cần terminal, IDE, ứng dụng trò chuyện trên máy tính hay Gateway tự lưu trữ. Đừng chọn chỉ dựa vào tên công cụ; hãy kiểm tra khả năng phù hợp với quy trình phê duyệt và quản lý quyền của nhóm.
2. Xác định giao thức
Sao chép ID mô hình mà API Key hiện tại có thể sử dụng từ danh mục mô hình và xác nhận mô hình hỗ trợ điểm vào Chat Completions, Responses, Anthropic Messages hoặc Gemini Generate Content mà hướng dẫn yêu cầu.
3. Chuẩn bị thông tin xác thực riêng
Tạo API Key dễ nhận diện và vô hiệu hóa trên trang API Keys. Không đưa Key thật vào kho mã, ảnh chụp màn hình, nhật ký hoặc cấu hình dùng chung.
4. Đọc thông tin về quyền
Kiểm tra các thư mục, lệnh, mạng và dịch vụ bên ngoài mà công cụ có thể truy cập. Tắt phê duyệt tự động theo mặc định và chỉ mở phạm vi tối thiểu cần thiết cho tác vụ hiện tại.
Kiểm tra theo từng giai đoạn
| Giai đoạn | Tác vụ đề xuất | Tiêu chí đạt |
|---|---|---|
| Kết nối cơ bản | Chỉ trả lời một đoạn văn bản cố định, không gọi công cụ | Có nội dung trả về; Provider, Base URL và mô hình đúng như dự kiến |
| Đọc tệp | Đọc và tóm tắt README.md trong thư mục thử nghiệm | Không ghi tệp hoặc chạy lệnh chưa được phê duyệt |
| Công cụ có kiểm soát | Thực hiện một thao tác có thể hoàn tác với phạm vi ảnh hưởng rõ ràng | Máy khách hiển thị thao tác để xác nhận, kết quả đúng như dự kiến |
| Tác vụ dự án | Xử lý dự án thực tế dưới sự bảo vệ của hệ thống quản lý phiên bản | Thay đổi có thể xem xét, hoàn tác và vượt qua các bước kiểm tra hiện có của dự án |
Không coi việc máy khách khởi động thành công là kết nối đã hoàn tất. Ít nhất hãy xác nhận yêu cầu thực tế dùng đúng Provider, mô hình và giao thức, đồng thời kiểm tra công cụ không vượt quá phạm vi được cấp quyền.
Câu hỏi thường gặp khi lựa chọn
| Vấn đề | Cách xử lý đề xuất |
|---|---|
| Công cụ trò chuyện được nhưng không gọi được công cụ | Kiểm tra mô hình và giao thức hỗ trợ gọi công cụ, sau đó kiểm tra phiên bản máy khách và quyền công cụ |
| Cùng một mô hình hoạt động khác nhau trong các công cụ | So sánh giao thức, lời nhắc hệ thống, Schema công cụ, ngữ cảnh và tham số mặc định của máy khách |
| Cấu hình đúng nhưng vẫn gửi yêu cầu đến Provider khác | Khởi động lại hoàn toàn máy khách và kiểm tra cấu hình cấp người dùng, biến môi trường cùng Provider đang bật |
Base URL trả về 404 | Theo hướng dẫn cụ thể, xác định cần API Origin, Base URL có /v1 hay đường dẫn do máy khách tự ghép |
| Không chắc có nên bật phê duyệt tự động | Giữ ở trạng thái tắt; chỉ mở từng quyền khi tác vụ, thư mục và ranh giới lệnh đều rõ ràng |
| Cần kết nối cơ sở dữ liệu, hệ thống tệp hoặc dịch vụ nghiệp vụ | Đọc Kết nối MCP và bảo mật trước, rồi kiểm tra nguồn dịch vụ và quyền |
Khuyến nghị bảo mật
- Tải gói hoặc lệnh cài đặt từ kênh chính thức của công cụ; đọc ghi chú phiên bản trước khi nâng cấp;
- Dùng API Key riêng cho từng công cụ để có thể vô hiệu hóa và kiểm toán độc lập;
- Dùng quản lý phiên bản hoặc bản sao lưu để bảo vệ tác vụ sửa tệp;
- Không gửi mật khẩu, dữ liệu khách hàng, dữ liệu trong môi trường production hoặc thông tin nhạy cảm không cần thiết khác cho mô hình;
- Kiểm tra Key, đường dẫn hoặc dữ liệu nghiệp vụ trong nhật ký, bản xuất phiên và báo cáo sự cố;
- Khi ngừng dùng công cụ, xóa thông tin xác thực đã lưu và thu hồi các quyền không còn cần thiết.
Nếu đã chọn công cụ, hãy bắt đầu với hướng dẫn tích hợp CC-Switch hoặc chọn công cụ tương ứng trong bảng trên. Tham khảo API Reference để biết các trường và cấu trúc phản hồi.