# Beralih daripada Gemini CLI kepada Antigravity CLI: panduan > Memasang agy, memindahkan konfigurasi, pemalam dan pemboleh ubah persekitaran; semakan, ralat lazim dan sekatan wilayah. Source: https://ailoot.ai/blog/ms/gemini-cli-to-antigravity-cli-migration/ Canonical: https://ailoot.ai/blog/ms/gemini-cli-to-antigravity-cli-migration/ Language: ms Publisher: Ailoot (https://ailoot.ai/) Translation: guide-097 Revision: sha256-11eddd3d511e11880043adf38a188f316c4c55add8a97f157cf039911053b1e2 Pada 19 Mei 2026, Google mengumumkan bahawa mereka akan menamatkan Gemini CLI lama untuk semua pelan Free, Pro dan Ultra pada 18 Jun. Dua minggu selepas panduan ini diterbitkan, arahan `gemini` akan berhenti memproses permintaan. Beralih daripada Gemini CLI kepada Antigravity CLI dengan arahan `agy` ialah satu-satunya cara untuk terus menggunakan alat Google. `agy` dibina menggunakan Go dan bermula puluhan kali lebih pantas. Jika anda mempunyai apa-apa yang sedang berjalan menggunakan Gemini CLI—skrip CI, tugas cron setiap malam, sambungan Gemini Code Assist untuk IDE—panduan ini menerangkan cara beralih dalam satu malam tanpa merosakkan apa-apa.
Cara menyambungkan model dan menggunakan API diterangkan dalam [dokumentasi Ailoot](https://ailoot.ai/docs/).
## Apakah yang sebenarnya akan berhenti berfungsi pada 18 Jun 2026?
Inti utama Pada 18 Jun 2026, Gemini CLI dan sambungan Gemini Code Assist untuk VS Code akan berhenti memproses permintaan bagi tiga kategori pengguna: pelan Free, Google AI Pro dan Google AI Ultra. Pemasangan baharu Gemini Code Assist di GitHub tidak lagi tersedia; pemasangan sedia ada akan dinyahdayakan “dalam minggu-minggu berikutnya”. Akses API berbayar melalui Gemini Enterprise Agent Platform dan lesen Code Assist Standard/Enterprise akan terus berfungsi tanpa perubahan.
Ini bukan “penutupan keseluruhan projek”, tetapi penamatan tiga pelan paling popular. Siapa yang terjejas: | Pelan | Perkara yang ditawarkan | Perkara yang akan berlaku pada 18 Jun 2026 | |----|----|----| | Pelan percuma | Akses kepada Gemini Code Assist + CLI dengan had | Dinyahdayakan sepenuhnya | | Google AI Pro (kira-kira \$19.99/bulan) | Had CLI dan Code Assist yang lebih tinggi | Dinyahdayakan sepenuhnya | | Google AI Ultra (daripada \$100/bulan selepas I/O 2026) | Had tertinggi | Dinyahdayakan sepenuhnya | | Gemini Code Assist untuk GitHub | Semakan PR automatik Google dalam repositori anda | Tiada pemasangan baharu; yang sedia ada akan dinyahdayakan dalam minggu-minggu berikutnya | | Gemini Code Assist Standard / Enterprise (lesen korporat) | Melalui akaun Google Workspace korporat | Terus berfungsi tanpa perubahan | | API berbayar melalui Google Cloud (kunci Gemini API berbayar) | Permintaan dibilkan kepada projek | Terus berfungsi tanpa perubahan | Daripada Google Developers Blog rasmi:

Pada 18 Jun 2026, Gemini CLI dan sambungan Gemini Code Assist IDE akan berhenti memproses permintaan bagi pengguna Google AI Pro, Ultra dan pelan Free.

— Google Developers Blog, https://developers.googleblog.com/an-important-update-transitioning-gemini-cli-to-antigravity-cli/
Jika anda menggunakan pelan Free, seperti kebanyakan pembangun individu, dan berfikir “tetapi saya ada akaun berbayar”—semak dengan tepat cara kunci API anda dibilkan. AI Pro bukan pengebilan Cloud; ia langganan Google AI peribadi dan akan dinyahdayakan. Pengebilan Cloud dengan projek berbayar tidak akan dinyahdayakan. ## Mengapa Google menamatkan Gemini CLI?
Inti utama Gemini CLI ialah eksperimen TypeScript/Node.js yang berasingan dalam repositori Google di GitHub. Google memutuskan untuk menyatukan semua alat agennya di bawah satu platform—Google Antigravity—dengan empat antara muka: Antigravity 2.0 (aplikasi desktop), Antigravity CLI (terminal), Antigravity SDK (pembungkus Python) dan Antigravity IDE (fork VS Code). Antigravity CLI ditulis semula daripada Node.js kepada Go: ia bermula dalam milisaat dan bukannya ratusan milisaat, serta menggunakan puluhan megabait memori dan bukannya ratusan.
`gemini` lama mengambil masa “ratusan milisaat” untuk bermula kerana Node.js perlu memanaskan enjin. `agy` baharu dibina sebagai satu binari Go statik dan bermula “dalam milisaat”. Bagi CI dan skrip yang memanggil CLI beratus kali dalam satu pelaksanaan, perbezaannya ketara. Perkara yang Google katakan tentang kelajuan dan sebabnya:

Antigravity CLI dibina menggunakan Go, berjalan lebih pantas dan menyokong aliran kerja latar belakang tak segerak.

— Google Developers Blog, https://developers.googleblog.com/an-important-update-transitioning-gemini-cli-to-antigravity-cli/
Semua ciri utama Gemini CLI telah dipindahkan: - **Agent Skills** — folder `.gemini/skills/` kini berada di `.agents/skills/`. - **Hooks** — peristiwa yang sama (`PreToolUse`, `PostToolUse`, dan sebagainya); sintaksnya hampir tidak berubah. - **Subagents** — berfungsi seperti sebelumnya dan konfigurasinya dipindahkan secara automatik. - **Extensions** — dinamakan semula sebagai pemalam Antigravity dan diimport dengan satu arahan. Perkara yang tidak dipindahkan dengan lancar: pelayan MCP dan skrip lama yang mengakses `.gemini/config.json` secara langsung. Menurut perbincangan di GitHub, sesetengah pengguna melaporkan bahawa konfigurasi MCP rosak dan perlu ditulis semula secara manual. Terdapat bahagian berasingan tentang hal ini di bawah. Google tidak menutup projek sumber terbuka Gemini CLI:

Repositori itu akan kekal tersedia di GitHub di bawah lesen Apache 2.0, dan kami akan terus mengusahakan projek ini sebagai sumber terbuka.

— Google Developers Blog (Discussion #27274)
Ini bermakna anda boleh membuat fork dan terus menggunakannya dengan kunci Gemini API anda sendiri. Tetapi kini ia memerlukan persediaan berbayar melalui pengebilan Cloud; pilihan Code Assist percuma telah tamat. ## Cara memasang Antigravity CLI: arahan untuk macOS, Linux dan Windows
Inti utama Pemasang Google mengesan OS dan seni bina secara automatik, memuat turun binari dan meletakkannya di `~/.local/bin` (Linux/macOS) atau `C:\Users\[your_name]\AppData\Local\agy\bin` (Windows). Arahan berbeza bagi ketiga-tiga OS: pada macOS dan Linux, satu baris arahan menggunakan `curl`; pada Windows, sama ada PowerShell `irm` atau pilihan CMD. Selepas pemasangan, tambahkan laluan itu kepada `PATH` jika pemasang belum berbuat demikian, buka terminal baharu dan jalankan `agy doctor`—arahan ini menyemak sama ada binari ditemui dan boleh menghubungi Google.
Sebelum bermula, buat semakan ringkas: pelan apakah yang anda gunakan? Jika anda mempunyai projek Cloud berbayar dan tiada tarikh akhir 18 Jun, pemindahan ini berguna tetapi tidak mendesak. Jika anda menggunakan Free/Pro/Ultra dan ada sesuatu yang berjalan melalui CLI, beralih sekarang ketika pelan masih aktif supaya anda boleh membandingkan tingkah laku pada tugas yang sama. ### macOS dan Linux Arahan satu baris menggunakan `curl`: ```bash curl -fsSL https://antigravity.google/cli/install.sh | bash ``` Skrip ini mengesan platform, memuat turun binari `agy`, menyemak jumlah semakannya dan meletakkannya di `~/.local/bin`. Jika folder ini tiada dalam `PATH`, tambahkannya: ```bash echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc source ~/.zshrc ``` Semak sama ada binari boleh ditemui: ```bash which agy agy --version ``` ### Windows (PowerShell) ```powershell irm https://antigravity.google/cli/install.ps1 | iex ``` Binari akan dipasang di `C:\Users\[your_name]\AppData\Local\agy\bin`. Pemasang akan mengemas kini PATH secara automatik, tetapi buka tetingkap PowerShell baharu untuk memuat semula pemboleh ubah. ### Windows (CMD) Jika PowerShell disekat oleh dasar korporat anda: ```cmd curl -fsSL https://antigravity.google/cli/install.cmd -o install.cmd && install.cmd && del install.cmd ``` ### Sahkan pemasangan Selepas pemasangan pada mana-mana OS, jalankan: ```bash agy doctor ``` Arahan ini menyemak versi binari, kewujudan konfigurasi, pengesahan dan akses rangkaian kepada `antigravity.google`. Jika ia tidak dapat menghubungi Google, masalahnya berkaitan wilayah atau proksi anda. ### Pengesahan Kali pertama anda menjalankan `agy` tanpa argumen, wizard persediaan akan dilancarkan: 1. Pilih tema antara muka. 2. Pilih kaedah pengesahan: Google OAuth (untuk akaun peribadi) atau kunci API. 3. Jika mahu, import konfigurasi daripada `.gemini/` dengan serta-merta. Jika anda memilih OAuth, pelayar akan dibuka dan mengubah hala anda ke `accounts.google.com`; anda perlu memberikan persetujuan untuk perkongsian data. Selepas itu, CLI boleh digunakan. ## Cara memindahkan konfigurasi dan pemalam daripada .gemini ke .agents
Inti utama Antigravity CLI mencari konfigurasi dalam `.agents/` di sebelah projek dan secara global dalam `~/.agents/`—sama seperti Gemini CLI mencari dalam `.gemini/`. Pemindahan dilakukan dengan satu arahan, `agy plugin import gemini`: arahan ini menelusuri `.gemini/extensions/`, memindahkannya sebagai pemalam Antigravity dan mengemas kini format konfigurasi. Pindahkan folder skills secara manual: `mv .gemini/skills/ .agents/skills/`. Selepas itu, `agy doctor` dan `agy inspect` akan menunjukkan perkara yang berjaya dikesan, yang tidak dikesan dan lokasi pendua.
Langkah demi langkah: 1. ### agy plugin import gemini Jalankan arahan ini dari mana-mana folder. Ia akan memindahkan pemalam global daripada `~/.gemini/` ke `~/.agents/`. Untuk pemalam workspace (di sebelah projek), jalankan arahan ini dari dalam folder projek. 2. ### mv .gemini/skills/ .agents/skills/ Pindahkan skills dengan menamakan semula folder secara manual. Format fail di dalamnya sama; markdown tidak perlu ditulis semula. 3. ### agy inspect Menunjukkan pemalam, skills, hooks dan subagents yang aktif. Bandingkan dengan senarai dalam Gemini CLI—tiada apa-apa yang sepatutnya tertinggal. 4. ### agy config --edit Membuka konfigurasi dalam editor lalai (`$EDITOR`). Jika ada sesuatu yang tidak diambil secara automatik, edit secara manual. 5. ### agy doctor Semakan akhir: binari, pengesahan, pemalam, rangkaian. Jika keempat-empatnya berwarna hijau, pemindahan konfigurasi selesai. Saya akan membiarkan folder `.gemini/` lama di tempatnya sebagai sandaran selama sebulan, sekiranya ada sesuatu yang tertinggal. Selepas menggunakan Antigravity selama seminggu dan mengesahkan semuanya ada, anda boleh memadamkannya. Jika anda menggunakan [AGENTS.md sebagai konfigurasi universal untuk semua alat AI](https://ailoot.ai/blog/ms/agents-md-guide-template/), anda tidak perlu mengubahnya. Antigravity CLI membaca `AGENTS.md` daripada folder yang sama dengan Claude Code atau Codex. ## Pemboleh ubah persekitaran yang manakah perlu diubah?
Inti utama Jika anda mempunyai skrip CI/CD, GitHub Actions, fail `.env` tempatan atau dotfiles yang meneruskan `GEMINI_API_KEY` atau pemboleh ubah lain, anda perlu menamakannya semula. Awalan `GEMINI_` telah menjadi `AV_` (untuk Antigravity). Antigravity CLI TIDAK akan membaca pemboleh ubah lama.
Jadual penggantian lengkap: | Pemboleh ubah lama (Gemini CLI) | Pemboleh ubah baharu (Antigravity CLI) | Nilai lalai | |----|----|----| | `GEMINI_API_KEY` | `AV_API_KEY` | \- | | `GEMINI_PROJECT_ID` | `AV_PROJECT_ID` | \- | | `GEMINI_REGION` | `AV_REGION` | `us-central1` | | `GEMINI_MODEL` | `AV_MODEL` | `gemini-3.5-flash` | | `GEMINI_API_BASE` | `AV_API_BASE` | Titik akhir Google rasmi | Jika anda mempunyai GitHub Actions yang meneruskan rahsia, buka `Settings -> Secrets -> Actions` dan namakan semula kunci tersebut. Nilainya kekal sama (kunci Google API tidak berubah semasa pemindahan). Semak semua tempat yang mungkin mengandungi `GEMINI_`: ```bash # Find mentions throughout the project grep -rn "GEMINI_" . --include="*.yml" --include="*.yaml" --include="*.sh" --include=".env*" 2>/dev/null # In dotfiles grep -nE "GEMINI_" ~/.zshrc ~/.bashrc ~/.bash_profile ~/.config/fish/config.fish 2>/dev/null ``` Selepas menggantikannya, mulakan semula terminal dan periksa kewujudannya tanpa mencetak rahsia. Jangan aktifkan penjejakan shell atau salin nilai kunci ke log. Kewujudan sahaja tidak membuktikan pengesahan; periksa `agy doctor` secara berasingan: ```bash if [ -n "${AV_API_KEY:-}" ]; then printf 'AV_API_KEY is set\n' else printf 'AV_API_KEY is missing or empty\n' fi agy doctor # should show “authorized” ``` ## Perkara yang paling kerap rosak semasa peralihan dan cara membaikinya
Inti utama Menurut perbincangan di GitHub, masalah yang paling kerap berlaku ialah pelayan MCP yang ditakrifkan dalam `~/.gemini/config.json`, yang tidak diambil secara automatik—konfigurasi perlu ditulis semula dalam format Antigravity. Hooks tersuai yang menggunakan pemboleh ubah persekitaran lama gagal secara senyap, menyebabkan ujian gagal tanpa ralat yang jelas. Skrip yang mengakses `.gemini/` secara langsung (bukannya melalui CLI) perlu diubah supaya menggunakan `.agents/`. Arahan `@[file]` untuk memuatkan fail ke dalam konteks mempunyai pepijat semasa Antigravity CLI mula dilancarkan; pepijat itu telah dibetulkan dalam binaan terkini, tetapi jika anda menggunakan versi lama, kemas kini.
Senarai semak masalah awal: 1. **Pelayan MCP.** Jika anda menggunakan `mcp_servers` dalam `.gemini/config.json`, pelayan itu mungkin tidak diambil selepas `agy plugin import gemini`. Semak dengan `agy inspect`—bahagian `mcp` akan dipaparkan. Jika bahagian itu kosong atau mengandungi ralat, tulis semula konfigurasi secara manual dengan `agy config --edit`. Formatnya diterangkan dalam dokumentasi rasmi Antigravity (cari bahagian MCP). 2. **Hooks tersuai.** Jika anda mempunyai skrip bash dalam `.gemini/hooks/` yang membaca `$GEMINI_API_KEY`, skrip itu akan rosak. Cari lokasi sedemikian: bash ``` grep -rn "GEMINI_" .agents/hooks/ 2>/dev/null ``` Gantikan pemboleh ubah tersebut. 3. **CI/CD.** Dalam GitHub Actions atau GitLab CI, tukar langkah yang menggunakan arahan `gemini` kepada `agy`. Nama binari dalam pemasang mungkin berbeza, jadi cipta satu lapisan abstraksi menggunakan pemboleh ubah `$CLI_CMD`. 4. **Sambungan IDE.** Sambungan Gemini Code Assist untuk VS Code akan dinyahdayakan bersama CLI. Penggantinya ialah [Antigravity IDE](https://antigravity.google) (fork VS Code yang berasingan) atau AGENTS.md dalam mana-mana editor AI yang lain. 5. **Pemuatan `@[file]`.** Dalam binaan awal Antigravity CLI, arahan `@src/file.ts` untuk memuatkan fail ke dalam konteks mempunyai pepijat. Kemas kini kepada versi terkini: `agy update`. Jika sesuatu yang kritikal rosak dan tidak dapat dibaiki dalam masa sejam, penyelesaian sementara bagi pelan Free adalah dengan terus menggunakan Gemini CLI sehingga 18 Jun sambil menyediakan pemindahan pada cabang repositori yang berasingan. Had masa: 14 hari. ## Patutkah anda terus menggunakan alat Google selepas 18 Jun?
Inti utama Antigravity CLI bermula lebih pantas, berfungsi dengan Gemini 3.5 Flash, menyokong ejen selari dan tugas latar belakang tak segerak melalui `agy --background`. Tetapi terdapat dua kemungkinan masalah: sekatan akses wilayah dan ekosistem yang belum matang (pemalam dan pelayan MCP lebih sedikit berbanding Claude Code). Saya tidak akan menjadikan Antigravity alat utama saya. Saya akan menggunakannya sebagai saluran sandaran untuk tugas latar belakang selari, sambil mengekalkan kerja pembangunan utama dalam Claude Code. Jika anda menggunakan Gemini CLI pada pelan Free, 18 Jun ialah masa yang sesuai untuk mempertimbangkan semula keseluruhan set alat anda.
Antigravity 2.0 boleh dipertimbangkan sebagai pilihan sandaran apabila alat utama anda (Claude Code atau Codex) tidak sesuai. Untuk melihat dengan lebih terperinci kelebihan dan kekurangannya, rujuk [panduan Google Antigravity 2.0](https://ailoot.ai/blog/ms/google-antigravity/). Ringkasan ringkas tentang tindakan yang perlu diambil mengikut situasi anda: | Jika anda... | Perkara yang perlu dilakukan sebelum 18 Jun | |----|----| | Menggunakan Gemini CLI percuma untuk eksperimen | Beralih kepada Antigravity CLI dengan akaun yang boleh mengakses perkhidmatan itu ATAU beralih kepada Claude/Codex—bergantung pada bajet anda | | Menggunakan Gemini Code Assist dalam IDE | Beralih kepada Antigravity IDE atau kembali kepada VS Code + Claude Code | | Menjalankan tugas cron setiap malam melalui Gemini API pada pelan Free | Segera tulis semula untuk API Cloud berbayar (yang tidak akan dinyahdayakan) ATAU beralih kepada Claude API | | Bekerja menggunakan Cloud korporat (Standard/Enterprise) | Jangan buat apa-apa; penamatan ini tidak menjejaskan anda | | Berfikir untuk mencuba Gemini CLI kerana “ia percuma” | Jangan mulakan; terus gunakan [Claude Code](https://ailoot.ai/blog/ms/claude-code/) atau [Codex](https://ailoot.ai/blog/ms/codex-vs-claude-code-choice/) | ## Senarai semak pemindahan dalam 15 minit
Inti utama Jika anda mahukan cara terpantas tanpa membaca keseluruhan panduan, berikut ialah urutan ringkasnya. Pada terminal baharu tanpa skrip Gemini yang sedang aktif, keseluruhan pemindahan mengambil masa 10–20 minit.
1. ### Pasang Antigravity CLI `curl -fsSL https://antigravity.google/cli/install.sh | bash` (macOS/Linux) atau `irm https://antigravity.google/cli/install.ps1 | iex` (Windows PowerShell). 2. ### Mulakan agy dan sahkan identiti Tanpa argumen: `agy`. Pilih OAuth atau kunci API. 3. ### Import pemalam daripada .gemini `agy plugin import gemini`—arahan ini memindahkan sambungan secara global. Jalankan sekali lagi dalam folder projek untuk pemalam workspace. 4. ### Pindahkan skills `mv .gemini/skills/ .agents/skills/`. Kandungan fail kekal seperti sedia ada. 5. ### Gantikan pemboleh ubah persekitaran Dalam `~/.zshrc`/`~/.bashrc` dan fail `.env`: `GEMINI_API_KEY → AV_API_KEY`, `GEMINI_PROJECT_ID → AV_PROJECT_ID`, `GEMINI_REGION → AV_REGION`. Mulakan semula terminal. 6. ### Sahkan pemasangan `agy doctor`—keempat-empat item (binari, pengesahan, pemalam, rangkaian) sepatutnya berwarna hijau. 7. ### Jalankan tugas ujian `agy "write a README for the project in the current folder"`—semak sama ada hasilnya serupa dengan yang dihasilkan oleh Gemini CLI. 8. ### Kemas kini GitHub Actions / GitLab CI Tukar nama arahan dan rahsia daripada `GEMINI_*` kepada `AV_*`. 9. ### Kekalkan .gemini/ sebagai sandaran Anda boleh memadamkannya 1–2 minggu selepas mengesahkan semuanya berfungsi. Akhir sekali: 18 Jun tidak bermaksud “semua projek anda akan terhenti”. Maksudnya saluran percuma akan dinyahdayakan. Akses API Cloud berbayar kekal tersedia, repositori Gemini CLI kekal tersedia dan fork masih boleh dibuat. Jika anda menggunakan pelan Free, anda perlu membuat keputusan sebelum 18 Jun; jika tidak, arahan `gemini "something"` yang seterusnya akan memulangkan ralat pengesahan.
### Sumber - [Google Developers Blog - An important update: Transitioning Gemini CLI to Antigravity CLI](https://developers.googleblog.com/an-important-update-transitioning-gemini-cli-to-antigravity-cli/) - [Antigravity CLI - Getting Started](https://antigravity.google/docs/cli-getting-started) - [Antigravity CLI - GitHub repository](https://github.com/google-antigravity/antigravity-cli) - [Google Blog - Google I/O 2026 developer highlights](https://blog.google/innovation-and-ai/technology/developers-tools/google-io-2026-developer-highlights/)
Teruskan bekerja dengan AI di [Ailoot](https://ailoot.ai/).
## Soalan lazim: Beralih daripada Gemini CLI kepada Antigravity CLI: panduan ### Bagaimanakah saya mengesahkan pemboleh ubah kunci API yang dinamakan semula tanpa mendedahkannya? Uji sama ada `${AV_API_KEY:-}` tidak kosong dan cetak hanya mesej ditetapkan atau tiada. Jangan echo nilai kunci atau jalankan semakan dengan penjejakan shell aktif; gunakan `agy doctor` secara berasingan untuk memeriksa pengesahan. ### Adakah import konfigurasi yang berjaya membuktikan semua kerja migrasi selesai? Tidak. Bandingkan plugin, skill, hook dan subagen aktif dengan konfigurasi lama, periksa tetapan MCP dan jalankan tugasan kecil. Kekalkan konfigurasi `.gemini/` lama sehingga aliran kerja dan hasil yang dikehendaki disahkan. ## Ailoot · Syarikat dan portfolio projeknya Ailoot berteraskan pengalaman operasi yang mantap, pangkalan pelanggan yang besar, perkhidmatan yang stabil dan pemantauan KPI berterusan. Syarikat dan portfolio projeknya: jutaan pelanggan; jualan bernilai berbilion setiap bulan. Ailoot menggunakan pengalaman operasi ini untuk akses API kepada ciri AI dalam produk pelanggan, ejen, aplikasi dan automasi.