ย้ายจาก Gemini CLI ไปยัง Antigravity CLI: คู่มือ

เมื่อวันที่ 19 พฤษภาคม 2026 Google ประกาศว่าจะยุติการให้บริการ Gemini CLI รุ่นเก่าสำหรับแพ็กเกจ Free, Pro และ Ultra ทั้งหมดในวันที่ 18 มิถุนายน อีกสองสัปดาห์หลังจากเผยแพร่คู่มือนี้ คำสั่ง gemini จะหยุดประมวลผลคำขอ การย้ายจาก Gemini CLI ไปยัง Antigravity CLI ด้วยคำสั่ง agy เป็นวิธีเดียวที่จะใช้เครื่องมือของ Google ต่อไปได้ agy สร้างด้วย Go และเริ่มทำงานเร็วขึ้นหลายสิบเท่า

หากคุณมีสิ่งใดที่กำลังทำงานอยู่บน Gemini CLI ไม่ว่าจะเป็นสคริปต์ CI งาน cron ที่รันทุกคืน หรือส่วนขยาย Gemini Code Assist สำหรับ IDE คู่มือนี้จะอธิบายวิธีย้ายระบบให้เสร็จภายในคืนเดียวโดยไม่ทำให้สิ่งใดเสียหาย

อะไรบ้างที่จะหยุดทำงานในวันที่ 18 มิถุนายน 2026?#

นี่ไม่ใช่ “การปิดโครงการทั้งหมด” แต่เป็นการยุติบริการสำหรับแพ็กเกจยอดนิยมสามแพ็กเกจ ผู้ที่ได้รับผลกระทบมีดังนี้:

จาก Google Developers Blog อย่างเป็นทางการ:

หากคุณใช้แพ็กเกจ Free เช่นเดียวกับนักพัฒนาอิสระส่วนใหญ่ และกำลังคิดว่า “แต่ฉันมีบัญชีแบบชำระเงินนะ” ให้ตรวจสอบว่าคีย์ API ของคุณถูกเรียกเก็บเงินด้วยวิธีใดโดยละเอียด AI Pro ไม่ใช่การเรียกเก็บเงินผ่าน Cloud แต่เป็นการสมัครใช้ Google AI ส่วนบุคคล ซึ่งจะถูกปิดใช้งาน การเรียกเก็บเงินผ่าน Cloud ด้วยโปรเจ็กต์แบบชำระเงินจะไม่ถูกปิดใช้งาน

ทำไม Google ถึงยุติ Gemini CLI?#

gemini รุ่นเก่าเริ่มทำงานใน “หลายร้อยมิลลิวินาที” เพราะ Node.js ต้องใช้เวลาเริ่มทำงาน ส่วน agy รุ่นใหม่สร้างเป็นไบนารี Go แบบสแตติกไฟล์เดียวและเริ่มทำงานใน “ไม่กี่มิลลิวินาที” สำหรับ CI และสคริปต์ที่เรียก CLI หลายร้อยครั้งต่อการรันหนึ่งครั้ง ความแตกต่างนี้มีนัยสำคัญ

สิ่งที่ Google ระบุเกี่ยวกับความเร็วและเหตุผล:

ฟีเจอร์หลักทั้งหมดของ Gemini CLI ถูกย้ายมาแล้ว:

• ทักษะเอเจนต์ (Agent Skills) — โฟลเดอร์ .gemini/skills/ ย้ายมาอยู่ที่ .agents/skills/
• Hooks — ใช้อีเวนต์เดิม (PreToolUse, PostToolUse ฯลฯ) โดยไวยากรณ์แทบไม่เปลี่ยน
• เอเจนต์ย่อย — ทำงานเหมือนเดิม และการกำหนดค่าจะถูกย้ายให้อัตโนมัติ
• ส่วนขยาย — เปลี่ยนชื่อเป็นปลั๊กอิน Antigravity และนำเข้าได้ด้วยคำสั่งเดียว

สิ่งที่ย้ายมาได้ไม่ราบรื่นคือเซิร์ฟเวอร์ MCP และสคริปต์เก่าที่เข้าถึง .gemini/config.json โดยตรง จากการพูดคุยใน GitHub ผู้ใช้บางรายรายงานว่าการกำหนดค่า MCP ใช้ไม่ได้และต้องเขียนใหม่ด้วยตนเอง มีหัวข้อแยกเกี่ยวกับเรื่องนี้ด้านล่าง

Google ไม่ได้ปิดโครงการโอเพนซอร์ส Gemini CLI:

นั่นหมายความว่าคุณสามารถฟอร์กและใช้ต่อด้วยคีย์ Gemini API ของตัวเองได้ แต่ตอนนี้เป็นการตั้งค่าแบบชำระเงินผ่านการเรียกเก็บเงินของ Cloud ส่วนการใช้งาน Code Assist แบบฟรีสิ้นสุดลงแล้ว

วิธีติดตั้ง Antigravity CLI: คำสั่งสำหรับ macOS, Linux และ Windows#

ก่อนเริ่ม ให้ตรวจสอบสั้น ๆ ว่าคุณใช้แพ็กเกจใด หากคุณมีโปรเจ็กต์ Cloud แบบชำระเงินและไม่มีเส้นตายในวันที่ 18 มิถุนายน การย้ายระบบเป็นประโยชน์แต่ไม่เร่งด่วน หากคุณใช้ Free/Pro/Ultra และมีสิ่งที่ทำงานอยู่บน CLI ให้ย้ายตอนนี้ขณะที่แพ็กเกจยังใช้งานได้ เพื่อเปรียบเทียบการทำงานกับงานเดียวกัน

macOS และ Linux

คำสั่งบรรทัดเดียวที่ใช้ curl:

curl -fsSL https://antigravity.google/cli/install.sh | bash

สคริปต์จะตรวจหาแพลตฟอร์ม ดาวน์โหลดไบนารี agy ตรวจสอบ checksum แล้วติดตั้งไว้ที่ ~/.local/bin หากโฟลเดอร์นี้ยังไม่อยู่ใน PATH ให้เพิ่มเข้าไป:

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

ตรวจสอบว่าเรียกใช้ไบนารีได้:

which agy
agy --version

Windows (PowerShell)

irm https://antigravity.google/cli/install.ps1 | iex

ไบนารีจะติดตั้งไว้ที่ C:\Users\[your_name]\AppData\Local\agy\bin ตัวติดตั้งจะอัปเดต PATH โดยอัตโนมัติ แต่ให้เปิดหน้าต่าง PowerShell ใหม่เพื่อโหลดตัวแปรอีกครั้ง

Windows (CMD)

หากนโยบายขององค์กรบล็อก PowerShell:

curl -fsSL https://antigravity.google/cli/install.cmd -o install.cmd && install.cmd && del install.cmd

ตรวจสอบการติดตั้ง

หลังติดตั้งบนระบบปฏิบัติการใดก็ตาม ให้รัน:

agy doctor

คำสั่งนี้ตรวจสอบเวอร์ชันของไบนารีว่ามีการกำหนดค่าหรือไม่ การยืนยันตัวตน และการเข้าถึงเครือข่ายไปยัง antigravity.google หากเชื่อมต่อ Google ไม่ได้ ปัญหาอาจเกี่ยวกับภูมิภาคหรือพร็อกซีของคุณ

การยืนยันตัวตน

ครั้งแรกที่คุณรัน agy โดยไม่มีอาร์กิวเมนต์ ระบบจะเปิดวิซาร์ดการตั้งค่า:

1. เลือกธีมของอินเทอร์เฟซ
2. เลือกวิธีการยืนยันตัวตน: Google OAuth (สำหรับบัญชีส่วนบุคคล) หรือคีย์ API
3. เลือกนำเข้าการกำหนดค่าจาก .gemini/ ได้ทันที

หากเลือก OAuth เบราว์เซอร์จะเปิดขึ้นและนำทางคุณไปยัง accounts.google.com; คุณต้องยินยอมให้แชร์ข้อมูล หลังจากนั้น CLI จะใช้งานได้

วิธีการย้ายการกำหนดค่าและปลั๊กอินจาก .gemini ไปยัง .agents#

ทีละขั้นตอน:

1. agy plugin import gemini

   รันคำสั่งจากโฟลเดอร์ใดก็ได้ ระบบจะย้ายปลั๊กอินส่วนกลางจาก ~/.gemini/ ไปยัง ~/.agents/ หากต้องการย้ายปลั๊กอินของเวิร์กสเปซ (ที่อยู่ข้างโปรเจ็กต์) ให้รันคำสั่งภายในโฟลเดอร์โปรเจ็กต์

2. mv .gemini/skills/ .agents/skills/

   ย้ายทักษะด้วยการเปลี่ยนชื่อโฟลเดอร์ด้วยตนเอง รูปแบบไฟล์ภายในเหมือนเดิม ไม่จำเป็นต้องเขียน Markdown ใหม่

3. agy inspect

   แสดงปลั๊กอิน ทักษะ hooks และเอเจนต์ย่อยที่กำลังใช้งาน เปรียบเทียบกับรายการที่คุณมีใน Gemini CLI — ไม่ควรมีรายการใดตกหล่น

4. agy config --edit

   เปิดการกำหนดค่าด้วยโปรแกรมแก้ไขเริ่มต้น ($EDITOR) หากมีสิ่งใดที่ระบบไม่ได้นำเข้ามาโดยอัตโนมัติ ให้แก้ไขด้วยตนเอง

5. agy doctor

   ตรวจสอบขั้นสุดท้าย: ไบนารี การยืนยันตัวตน ปลั๊กอิน และเครือข่าย หากทั้งสี่รายการแสดงสถานะสีเขียว การย้ายการกำหนดค่าก็เสร็จสมบูรณ์

แนะนำให้เก็บโฟลเดอร์ .gemini/ เดิมไว้เป็นข้อมูลสำรองหนึ่งเดือน เผื่อมีสิ่งใดตกหล่น หลังจากใช้ Antigravity หนึ่งสัปดาห์และยืนยันว่ามีทุกอย่างครบแล้ว คุณจึงลบได้

หากคุณใช้ AGENTS.md เป็นการกำหนดค่ากลางสำหรับเครื่องมือ AI ทุกตัว ก็ไม่จำเป็นต้องแก้ไขไฟล์นี้ Antigravity CLI อ่าน AGENTS.md จากโฟลเดอร์เดียวกับ Claude Code หรือ Codex

ต้องเปลี่ยนตัวแปรสภาพแวดล้อมใดบ้าง?#

ตารางแทนค่าทั้งหมด:

หากคุณมี GitHub Actions ที่ส่งผ่าน secrets ให้เปิด Settings -> Secrets -> Actions แล้วเปลี่ยนชื่อคีย์ ส่วนค่าจะยังเหมือนเดิม (คีย์ API ของ Google ไม่ได้เปลี่ยนระหว่างการย้าย)

ตรวจสอบทุกตำแหน่งที่อาจมี GEMINI_:

# 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

หลังเปลี่ยนค่าให้เริ่มเทอร์มินัลใหม่และตรวจว่ามีค่าโดยไม่พิมพ์ข้อมูลลับ อย่าเปิด shell tracing หรือคัดลอกคีย์ลงบันทึก การมีค่าไม่พิสูจน์สิทธิ์ ให้ตรวจ agy doctor แยก:

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”

อะไรที่มักมีปัญหาระหว่างการเปลี่ยนผ่าน และวิธีแก้ไข#

รายการตรวจสอบปัญหาเบื้องต้น:

1. เซิร์ฟเวอร์ MCP หากคุณใช้ mcp_servers ใน .gemini/config.json เซิร์ฟเวอร์เหล่านี้อาจไม่ถูกตรวจพบหลังจากรัน agy plugin import gemini ตรวจสอบด้วย agy inspect — ควรมีส่วน mcp หากส่วนนั้นว่างหรือมีข้อผิดพลาด ให้เขียนการกำหนดค่าใหม่ด้วยตนเองโดยใช้ agy config --edit รูปแบบอธิบายไว้ในเอกสารทางการของ Antigravity (ดูหัวข้อ MCP)

2. hooks แบบกำหนดเอง หากคุณมีสคริปต์ bash ใน .gemini/hooks/ ที่อ่านค่า $GEMINI_API_KEY สคริปต์จะใช้ไม่ได้ ค้นหาตำแหน่งเหล่านั้น: bash

   grep -rn "GEMINI_" .agents/hooks/ 2>/dev/null
   

   เปลี่ยนตัวแปรเหล่านั้น

3. CI/CD ใน GitHub Actions หรือ GitLab CI ให้เปลี่ยนขั้นตอนที่ใช้คำสั่ง gemini เป็น agy ชื่อไบนารีในตัวติดตั้งอาจแตกต่างกัน ให้สร้างส่วนเชื่อมต่อกลางโดยใช้ตัวแปร $CLI_CMD

4. ส่วนขยาย IDE ส่วนขยาย Gemini Code Assist สำหรับ VS Code จะถูกปิดใช้งานพร้อมกับ CLI สิ่งทดแทนคือ Antigravity IDE (ฟอร์ก VS Code แยกต่างหาก) หรือ AGENTS.md ในโปรแกรมแก้ไข AI อื่น ๆ

5. การโหลดด้วย @[file] บิลด์ Antigravity CLI รุ่นแรก ๆ มีบั๊กในคำสั่ง @src/file.ts สำหรับโหลดไฟล์เข้าสู่บริบท ให้อัปเดตเป็นรุ่นล่าสุด: agy update

หากมีบางอย่างที่สำคัญเสียหายและแก้ไขไม่ได้ภายในหนึ่งชั่วโมง วิธีแก้ชั่วคราวสำหรับแพ็กเกจ Free คือใช้ Gemini CLI ต่อไปจนถึงวันที่ 18 มิถุนายน พร้อมกับเตรียมการย้ายระบบบนสาขารีโพซิทอรีแยกต่างหาก จำกัดเวลาไว้ 14 วัน

ควรใช้เครื่องมือของ Google ต่อหลังวันที่ 18 มิถุนายนหรือไม่?#

คุณอาจพิจารณาใช้ Antigravity 2.0 เป็นตัวเลือกสำรองในกรณีที่เครื่องมือหลักของคุณ (Claude Code หรือ Codex) ไม่เหมาะกับงานนั้น หากต้องการดูรายละเอียดว่ามันทำอะไรได้ดีและไม่ดี โปรดดูคู่มือ Google Antigravity 2.0

สรุปสั้น ๆ ว่าควรทำอย่างไรตามสถานการณ์ของคุณ:

รายการตรวจสอบการย้ายระบบภายใน 15 นาที#

1. ติดตั้ง Antigravity CLI

   curl -fsSL https://antigravity.google/cli/install.sh | bash (macOS/Linux) หรือ irm https://antigravity.google/cli/install.ps1 | iex (Windows PowerShell)

2. เปิด agy และยืนยันตัวตน

   รันโดยไม่ใส่อาร์กิวเมนต์: agy เลือก OAuth หรือคีย์ API

3. นำเข้าปลั๊กอินจาก .gemini

   agy plugin import gemini — คำสั่งนี้จะย้ายส่วนขยายส่วนกลาง ให้รันอีกครั้งภายในโฟลเดอร์โปรเจ็กต์เพื่อย้ายปลั๊กอินของเวิร์กสเปซ

4. ย้ายทักษะ

   mv .gemini/skills/ .agents/skills/ เนื้อหาไฟล์ยังคงเดิม

5. เปลี่ยนตัวแปรสภาพแวดล้อม

   ใน ~/.zshrc/~/.bashrc และไฟล์ .env: GEMINI_API_KEY → AV_API_KEY, GEMINI_PROJECT_ID → AV_PROJECT_ID, GEMINI_REGION → AV_REGION จากนั้นเริ่มเทอร์มินัลใหม่

6. ตรวจสอบการติดตั้ง

   agy doctor — ทั้งสี่รายการ (ไบนารี การยืนยันตัวตน ปลั๊กอิน และเครือข่าย) ควรแสดงเป็นสีเขียว

7. รันงานทดสอบ

   agy "write a README for the project in the current folder" — ตรวจสอบว่าผลลัพธ์คล้ายกับที่ Gemini CLI สร้างขึ้น

8. อัปเดต GitHub Actions / GitLab CI

   เปลี่ยนชื่อคำสั่งและ secrets จาก GEMINI_* เป็น AV_*

9. เก็บ .gemini/ ไว้เป็นข้อมูลสำรอง

   คุณสามารถลบได้หลังยืนยันว่าทุกอย่างทำงานแล้ว 1–2 สัปดาห์

สุดท้ายนี้: วันที่ 18 มิถุนายนไม่ได้หมายความว่า “โปรเจ็กต์ทั้งหมดของคุณจะหยุดทำงาน” แต่หมายถึงช่องทางฟรีจะถูกปิดใช้งาน การเข้าถึง Cloud API แบบชำระเงินยังคงอยู่ รีโพซิทอรี Gemini CLI ยังคงอยู่ และยังสามารถฟอร์กได้ หากคุณใช้แพ็กเกจ Free คุณต้องตัดสินใจก่อนวันที่ 18 มิถุนายน มิฉะนั้น gemini "something" ครั้งถัดไปจะส่งกลับข้อผิดพลาดด้านการอนุญาต