Tổng quan về các công cụ CLI
CLI là công cụ dòng lệnh, không phải là một phần mềm cụ thể. Claude Code, Codex CLI, Gemini CLI, OpenClaw và OpenCode đều thuộc danh mục này: bạn nhập ngôn ngữ tự nhiên vào terminal và chúng có thể đọc dự án, giải thích mã, tạo tệp, chạy lệnh hoặc giúp bạn hoàn thành các tác vụ phát triển.
Thông tin chính thức Bản tải về và tài liệu tham khảo dựa trên trang chính thức.
CLI là gì và dùng để làm gì
Các công cụ CLI mạnh hơn phần mềm trò chuyện thông thường và cũng dễ bị sử dụng sai cách hơn. Khi người mới bắt đầu cấu hình lần đầu, chỉ nên chạy chúng trong các dự án thử nghiệm và đặt chúng ở chế độ "chỉ giải thích, không sửa đổi và không thực thi lệnh".
Cần chuẩn bị những gì trước tiên
| Mục chuẩn bị | Mô tả | Tại sao điều này quan trọng |
|---|---|---|
| Terminal | Windows dùng PowerShell, macOS / Linux dùng Terminal | CLI chạy hoàn toàn trong terminal |
| Bản thân công cụ | Trước tiên hãy cài đặt Claude Code, Codex CLI, Gemini CLI, OpenClaw hoặc OpenCode | Tệp cấu hình chỉ có hiệu lực với các công cụ đã được cài đặt |
| Key / Phương thức đăng nhập | Có thể là đăng nhập chính thức, API Key, OAuth hoặc Key từ nhà cung cấp AI | Phương thức xác thực của mỗi CLI là khác nhau |
| Base URL | Chỉ cần thiết khi sử dụng qua nhà cung cấp AI hoặc proxy | Hậu tố địa chỉ có thể khác nhau tùy theo giao thức, vì vậy bạn không thể chỉ thay đổi mỗi tên miền. |
| Dự án thử nghiệm | Tạo một thư mục trống mới hoặc sao chép dự án. | Tránh làm xáo trộn dự án thực tế trong lần cấu hình đầu tiên |
URL trong tài liệu của nhà cung cấp AI thường chỉ là ví dụ của riêng họ. Khi điền thực tế, bạn cần thay thế bằng địa chỉ API và Key do chính nhà cung cấp của bạn cung cấp; nếu nhà cung cấp cung cấp riêng biệt các giao diện OpenAI, Claude và Gemini, đừng nhầm lẫn ba địa chỉ này với nhau.
Lối vào trang chi tiết
Cấu hình Claude Code Key, Base URL, mô hình và settings.json của Claude Code.
Cấu hình Codex CLI config.toml, Provider tùy chỉnh và các phương pháp kiểm thử cho công cụ terminal Codex.
Cấu hình Gemini CLI Lưu ý về đăng nhập Google, API Key và nhà cung cấp AI cho Gemini CLI.
Cấu hình OpenClaw Các trường baseUrl và api của OpenClaw được cấu hình theo cặp.
Cấu hình OpenCode Trình hướng dẫn kết nối, vị trí tệp cấu hình và các lưu ý khi cấu hình thủ công cho OpenCode.
Cách chọn trang để xem
| Bạn muốn làm gì bây giờ | Đề xuất mở | Lý do |
|---|---|---|
| Chỉ muốn chuyển đổi đồng nhất giữa nhiều nhà cung cấp CLI | Các bước chung cho CC-Switch | CC-Switch phù hợp hơn để quản lý tập trung các Provider, sau đó phân phối tới các công cụ như Claude, Codex, Gemini, v.v. |
| Chỉ cấu hình Claude Code | Cấu hình Claude Code | Đối với Claude Code, hãy tập trung vào Key, Base URL, tên mô hình liên quan đến Anthropic / Claude và settings.json |
| Chỉ cấu hình Codex CLI | Cấu hình Codex | Đối với Codex, hãy tập trung vào config.toml, các Provider tương thích OpenAI, tên mô hình và biến môi trường |
| Chỉ cấu hình Gemini CLI | Cấu hình Gemini | Phương thức đăng nhập, Key và giao diện Vertex / Gemini của Gemini khác với các giao diện tương thích OpenAI |
| Sử dụng OpenClaw / OpenCode | OpenClaw / OpenCode | Trường Provider của hai công cụ này có thể thay đổi theo phiên bản, bạn nên tham khảo trang tương ứng và tài liệu chính thức |
Các rủi ro cần lưu ý trước khi cấu hình
| Rủi ro | Nơi dễ xảy ra | Khuyến nghị |
|---|---|---|
| Công cụ có thể đọc các tệp dự án | Claude Code, Codex, Gemini, OpenClaw, OpenCode | Chạy trong thư mục thử nghiệm vào lần đầu tiên, không mở trực tiếp các dự án sản xuất thực tế |
| Mô hình có thể thực thi hoặc đề xuất lệnh | Tất cả các CLI code | Bật chế độ xác nhận trước, đồng thời kiểm tra cẩn thận từng hành động khi gặp các lệnh xóa, di chuyển, cài đặt, tải lên, v.v. |
| Các mục cấu hình ghi đè lẫn nhau | Biến môi trường hệ thống, cấu hình dự án, cấu hình người dùng, CC-Switch | Khi cấu hình không có hiệu lực, hãy kiểm tra thứ tự ưu tiên trước, không sửa đổi nhiều nơi cùng lúc |
| Sử dụng lẫn lộn các giao thức | Giao diện tương thích OpenAI, Claude, Gemini, Vertex, nhà cung cấp AI | Điền vào trang công cụ dựa trên giao diện mà backend nhà cung cấp hỗ trợ |
| Sao chép ví dụ của người khác | Hướng dẫn bên thứ ba, ảnh chụp màn hình, tài liệu cũ | URL, Key và tên mô hình trong ví dụ phải được thay thế bằng thông tin từ backend nhà cung cấp của bạn |
Cách thực hiện bài kiểm tra bảo mật đầu tiên
Sau khi hoàn tất cấu hình, đừng để CLI sửa đổi dự án thực tế ngay lập tức. Trước tiên, hãy tạo một thư mục trống, đặt một tệp thử nghiệm đơn giản vào đó và chỉ cho phép công cụ đọc và giải thích mà không sửa đổi tệp.
Các câu lệnh kiểm tra an toàn có thể gửi cho CLI
Read only the current directory first. Tell me which files are here. Do not modify any files, run any commands, or install any dependencies.Nếu bước này không thể trả về kết quả bình thường, hãy chuyển đến trang khắc phục sự cố tương ứng. Không để CLI tự động xử lý dự án thực tế trước khi xác nhận cấu hình đã thành công.