Trang chính tài liệu
tất cả hệ thống hoạt động · build ổn định mới nhất: v2.3.0 · cập nhật 05/09/2026

Cài đặt

AI coding agent chạy trong terminal, dùng model Gemini. Dán một lệnh bên dưới vào terminal của bạn — không cần cài Python hay tự xin API key.

Windows PowerShell
________________ ____ _______ __ / ____/ ____/ __ \/ __ \/ ____/ |/ / / / __/ / / / / / / / / __/ | / / /_/ / /___/ /_/ / /_/ / /___ / | \____/\____/\____/_____/_____//_/|_|
Gemini-powered coding agent · terminal CLI
›
chọn cách cài đặt
PowerShellkhuyến nghị
›irm https://gitoder.x10.mx/dl/install.ps1 | iex
hoặc
Command Prompt
C:\>curl -fsSL https://gitoder.x10.mx/dl/install.cmd -o install.cmd && install.cmd && del install.cmd

Cài thủ công? Tải file .exe đóng gói sẵn từ trang phát hành và chạy trực tiếp, không cần thêm bước nào khác.

Vẫn báo "gcodex is not recognized" sau khi cài?
Mở một tab mới trong cùng cửa sổ terminal thường chưa đủ để nhận PATH mới. Hãy đóng hẳn toàn bộ cửa sổ terminal/PowerShell (không chỉ tab) rồi mở lại từ đầu. Nếu vẫn lỗi, xem thêm ở phần câu hỏi thường gặp bên dưới.
zsh — Terminal
________________ ____ _______ __ / ____/ ____/ __ \/ __ \/ ____/ |/ / / / __/ / / / / / / / / __/ | / / /_/ / /___/ /_/ / /_/ / /___ / | \____/\____/\____/_____/_____//_/|_|
Gemini-powered coding agent · terminal CLI
$
chọn cách cài đặt
Script cài đặt cho macOS đang được hoàn thiện
Bản Homebrew tap và curl script chưa được phát hành. Theo dõi changelog hoặc trang chính để biết khi nào có bản build.
bash — user@host
________________ ____ _______ __ / ____/ ____/ __ \/ __ \/ ____/ |/ / / / __/ / / / / / / / / __/ | / / /_/ / /___/ /_/ / /_/ / /___ / | \____/\____/\____/_____/_____//_/|_|
Gemini-powered coding agent · terminal CLI
$
chọn cách cài đặt
Script cài đặt cho Linux đang được hoàn thiện
Bản curl/wget script và gói .deb/.rpm/AppImage chưa được phát hành. Theo dõi changelog hoặc trang chính để biết khi nào có bản build.

Không cần API key riêng

gcodex tự lấy Gemini API key miễn phí mỗi lần khởi động. Chỉ cần đặt biến môi trường GEMINI_API_KEY nếu nhà phát hành ngừng cấp key miễn phí này.

Không cần Python

Bản cài đặt là một file thực thi đóng gói sẵn cho từng nền tảng. Mở terminal mới rồi gõ gcodex để bắt đầu.

Changelog

các bản phát hành gần đây
v2.3.0 mới nhất 05/09/2026
  • Thêm script cài đặt riêng cho macOS qua Homebrew tap
  • Giảm thời gian khởi động nguội xuống dưới 1 giây
  • Sửa lỗi treo khi mất kết nối mạng giữa phiên chat dài
v2.2.1 18/08/2026
  • Vá lỗi bảo mật liên quan đến lưu trữ key tạm thời
  • Cải thiện độ chính xác khi đọc file lớn hơn 5MB
v2.2.0 02/08/2026
  • Ra mắt gói AppImage cho Linux, chạy không cần cài đặt
  • Thêm chế độ xem diff trực tiếp trong terminal
  • Hỗ trợ biến môi trường GEMINI_API_KEY tùy chỉnh

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

Đây là lỗi PATH chưa được nạp lại, không phải cài đặt thất bại. Cửa sổ terminal đang mở (kể cả khi bạn mở thêm tab mới trong đó) vẫn giữ PATH cũ từ trước khi cài. Hãy đóng hẳn toàn bộ cửa sổ PowerShell/CMD đang mở rồi mở lại một cửa sổ mới hoàn toàn. Nếu vẫn báo lỗi, thử đăng xuất và đăng nhập lại, hoặc khởi động lại máy.
Có. gcodex tự cấp một Gemini API key miễn phí mỗi lần khởi động, không cần bạn đăng ký hay trả phí. Biến môi trường GEMINI_API_KEY chỉ cần thiết nếu sau này nhà phát hành ngừng cung cấp key miễn phí này — khi đó bạn mới cần tự tạo và khai báo key riêng.
Không bắt buộc. Script mặc định cài vào thư mục người dùng hiện tại (ví dụ %LOCALAPPDATA% trên Windows). Bạn chỉ cần quyền admin nếu muốn cài toàn hệ thống.
Chạy gcodex uninstall từ terminal — lệnh này sẽ xóa thư mục cài đặt và gỡ khỏi PATH tự động. Trên Homebrew dùng brew uninstall gcodex.
Toàn bộ script cài đặt là mã nguồn mở, bạn có thể xem trước khi chạy tại trang tài liệu. Luôn nên kiểm tra script từ một nguồn trước khi pipe thẳng vào shell.