Crazyrouter
Hướng Dẫn Sử Dụng Gemini CLI - Google AI Trong Terminal Của Bạn
Gemini CLI là một công cụ AI dòng lệnh mã nguồn mở do Google cung cấp, đưa sức mạnh của Gemini trực tiếp vào terminal của bạn. Nó cung cấp một cách truy cập Gemini nhẹ nhàng, mang lại con đường trực tiếp nhất từ prompt đến mô hình. Bằng cách cấu hình proxy, bạn có thể sử dụng các dịch vụ Gemini CLI ngay cả trong môi trường bị giới hạn mạng.
Tại Sao Nên Chọn Gemini CLI?#
- Gemini 2.5 Pro mạnh mẽ: Truy cập cửa sổ ngữ cảnh 1 triệu token
- Công cụ tích hợp sẵn: Google Search grounding, thao tác file, lệnh Shell, web scraping
- Có thể mở rộng: Hỗ trợ MCP (Model Context Protocol) cho các tích hợp tùy chỉnh
- Ưu tiên Terminal: Thiết kế cho các nhà phát triển làm việc trên dòng lệnh
- Mã nguồn mở: Giấy phép Apache 2.0
Cài Đặt#
Cài Nhanh#
Chạy Ngay Với npx (Không Cần Cài Đặt)#
# Use official repository
npx https://github.com/google-gemini/gemini-cli
Cài Đặt Toàn Cục Với npm#
npm install -g @google/gemini-cli
Cài Đặt Với Homebrew (macOS/Linux)#
brew install gemini-cli
Yêu Cầu Hệ Thống#
- Node.js phiên bản 20 hoặc cao hơn
- macOS, Linux, hoặc Windows
Cấu Hình Proxy#
Thiết Lập Biến Môi Trường#
Trước khi sử dụng proxy, hãy cấu hình các biến môi trường sau:
Linux / macOS#
# Set API Key
export GEMINI_API_KEY=sk-your-api-key-here
# Set API Proxy URL
export GOOGLE_GEMINI_BASE_URL=https://crazyrouter.com/
Windows CMD#
set GEMINI_API_KEY=sk-your-api-key-here
set GOOGLE_GEMINI_BASE_URL=https://crazyrouter.com/
Windows PowerShell#
$env:GEMINI_API_KEY = "sk-your-api-key-here"
$env:GOOGLE_GEMINI_BASE_URL = "https://crazyrouter.com/"
Mẹo: Thêm các biến môi trường này vào .bashrc, .zshrc, hoặc file cấu hình shell của bạn để chúng được tự động thiết lập mỗi khi bạn mở terminal.
Bắt Đầu Nhanh#
Cách Dùng Cơ Bản#
Khởi Chạy Trong Thư Mục Hiện Tại#
gemini
Bao Gồm Nhiều Thư Mục#
gemini --include-directories ../lib,../docs
Sử Dụng Một Mô Hình Cụ Thể#
gemini -m gemini-2.5-flash
Chế Độ Script Không Tương Tác#
Nhận phản hồi dạng văn bản đơn giản:
gemini -p "Explain the architecture of this codebase"
Nhận đầu ra JSON có cấu trúc:
gemini -p "Explain the architecture of this codebase" --output-format json
Ví Dụ Nhanh#
Bắt Đầu Một Dự Án Mới#
cd new-project/
gemini
> Write me a Discord bot that answers questions using the FAQ.md file I provided
Phân Tích Mã Nguồn Hiện Có#
git clone https://github.com/google-gemini/gemini-cli
cd gemini-cli
gemini
> Give me a summary of all changes from yesterday
Tính Năng Chính#
Hiểu Và Sinh Mã#
- Truy vấn và chỉnh sửa các codebase lớn
- Tạo ứng dụng mới từ PDF, hình ảnh, hoặc bản phác thảo bằng khả năng đa phương thức
- Gỡ lỗi và xử lý sự cố bằng ngôn ngữ tự nhiên
Tự Động Hóa Và Tích Hợp#
- Tự động hóa các tác vụ vận hành như truy vấn pull request hoặc xử lý các thao tác rebase phức tạp
- Kết nối các khả năng mới thông qua các MCP server
- Chạy không tương tác trong script để tự động hóa quy trình làm việc
Tính Năng Nâng Cao#
- Nhận thông tin thời gian thực bằng Google Search tích hợp sẵn
- Checkpoint hội thoại để lưu và khôi phục các phiên làm việc phức tạp
- File ngữ cảnh tùy chỉnh (GEMINI.md) để điều chỉnh hành vi cho dự án của bạn
Các Lệnh Phổ Biến Và Ví Dụ#
Khám Phá Codebase#
> Describe the main components of this system architecture
> What security mechanisms are in place?
> Provide a step-by-step onboarding document for new developers
Làm Việc Với Mã Nguồn Hiện Có#
> Implement a first draft for GitHub issue #123
> Help me migrate this codebase to the latest version of Java. Start with a plan
Tự Động Hóa Quy Trình#
> Create a slideshow showing the git history from the past 7 days, grouped by feature and team member
> Create a full-screen web app for wall display showing our most interactive GitHub issues
Tương Tác Với Hệ Thống#
> Convert all images in this directory to png and rename them using the date from exif data
> Organize my PDF invoices by spending month
Tích Hợp GitHub#
Sử dụng Gemini CLI GitHub Action để tích hợp Gemini CLI trực tiếp vào các workflow GitHub của bạn:
- Review Pull Request: Review mã tự động với phản hồi theo ngữ cảnh và gợi ý
- Phân Loại Issue: Tự động gán nhãn và ưu tiên GitHub issue dựa trên phân tích nội dung
- Hỗ Trợ Theo Yêu Cầu: Nhắc
@gemini-clitrong issue và pull request để được hỗ trợ gỡ lỗi, giải thích hoặc giao nhiệm vụ - Workflow Tùy Chỉnh: Xây dựng các workflow tự động, theo lịch và theo yêu cầu phù hợp với nhu cầu của đội bạn
Khắc Phục Sự Cố#
Nếu bạn gặp vấn đề trong quá trình sử dụng, hãy xem xét các bước sau:
1. Kiểm Tra Biến Môi Trường#
echo $GEMINI_API_KEY
echo $GOOGLE_GEMINI_BASE_URL
2. Kiểm Tra Kết Nối Mạng#
curl -I https://crazyrouter.com/
3. Kiểm Tra Thông Báo Lỗi#
Thông báo lỗi thường cho biết vấn đề là gì. Các lỗi thường gặp bao gồm:
- Định dạng API key không hợp lệ
- Sự cố kết nối mạng
- Cấu hình proxy không chính xác
4. Định Dạng Proxy SOCKS#
Nếu sử dụng proxy SOCKS, hãy đảm bảo định dạng chính xác:
socks5://<user>:<pass>@<proxy>:<port>
5. Báo Cáo Lỗi#
Sử dụng lệnh tích hợp sẵn để báo cáo vấn đề:
/bug
Phiên Bản Phát Hành#
Preview#
Các phiên bản preview mới được phát hành mỗi thứ Ba lúc 23:59 UTC:
npm install -g @google/gemini-cli@preview
Stable#
Các phiên bản stable mới được phát hành mỗi thứ Ba lúc 20:00 UTC:
npm install -g @google/gemini-cli@latest
Nightly#
Các phiên bản nightly được phát hành hàng ngày lúc 00:00 UTC:
npm install -g @google/gemini-cli@nightly
Sử Dụng MCP Server#
Cấu hình MCP server trong ~/.gemini/settings.json để mở rộng Gemini CLI bằng các công cụ tùy chỉnh:
> @github list my open pull requests
> @slack send a summary of today's commits to #dev channel
> @database run a query to find inactive users
Bảng Giá Qua Crazyrouter#
Truy cập các mô hình Gemini với mức giá ưu đãi:
| Model | Input Price | Output Price |
|---|---|---|
| gemini-2.5-pro | $0.625/1M tokens | $2.50/1M tokens |
| gemini-2.5-flash | $0.038/1M tokens | $0.15/1M tokens |
| gemini-2.5-flash-lite | $0.019/1M tokens | $0.075/1M tokens |
Tất cả mức giá đều bao gồm giảm 45% so với giá chính thức.
Tài Nguyên Liên Quan#
Cần hỗ trợ? Hãy liên hệ bộ phận hỗ trợ hoặc xem tài liệu Crazyrouter để biết thêm thông tin.
