跳转到内容

Linux 和 WSL 安装 Antigravity CLI 完整教程

· 7 分钟阅读

How to Install Antigravity CLI on Linux?

一行命令:

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

安装完成后,二进制位于 ~/.local/bin/agy

验证安装:

agy --version

如果显示 command not found,需要配置 PATH。

怎么把 agy 加入 PATH?

安装脚本会尝试自动添加,但不一定生效。手动操作:

# 当前终端立即生效
export PATH="$HOME/.local/bin:$PATH"

# 写入 .bashrc 永久生效
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

如果用的是 zsh:

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

确认:

which agy
# 应输出: /home/你的用户名/.local/bin/agy

Ubuntu 用 apt 安装可以吗?

可以,但 apt 装的是 Antigravity IDE(桌面版),不是 CLI:

sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://antigravity.google/linux/apt/signing-key.gpg | \
  sudo gpg --dearmor --yes -o /etc/apt/keyrings/antigravity-repo-key.gpg
echo "deb [signed-by=/etc/apt/keyrings/antigravity-repo-key.gpg] https://antigravity.google/linux/apt antigravity-debian main" | \
  sudo tee /etc/apt/sources.list.d/antigravity.list > /dev/null
sudo apt update
sudo apt install antigravity

CLI 和 IDE 是两个东西。 如果你只需要终端里用 agy,用 curl 脚本安装就够了。

WSL2 怎么安装?

在 WSL2 里直接用 curl 安装原生 Linux 版本(推荐):

curl -fsSL https://antigravity.google/cli/install.sh | bash
export PATH="$HOME/.local/bin:$PATH"
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc

另一种方式:链接 Windows 版本

如果你已经在 Windows 上装了 Antigravity:

mkdir -p ~/.local/bin
ln -sf "/mnt/c/Users/你的用户名/AppData/Local/Programs/Antigravity/bin/antigravity" ~/.local/bin/agy
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

你的用户名 替换成你的 Windows 用户名。

WSL 认证不持久怎么解决?

这是最常见的 WSL 坑。agy 用操作系统的 keyring 存储登录凭据,但 WSL 没有图形桌面,默认 keyring 是锁定状态。

解决方案——安装 gnome-keyring 并创建无密码 keyring:

# 安装
sudo apt install gnome-keyring

# 删除旧的加密 keyring
rm -f ~/.local/share/keyrings/*

# 重启 WSL(在 Windows PowerShell 里执行)
wsl --shutdown

重新打开 WSL 后,agy 的认证就能持久化了。

安装完成后的第一步

# 进入任意项目目录
cd ~/my-project

# 启动 Antigravity CLI
agy

# 首次启动会引导你完成登录
# 按提示在浏览器里授权即可

登录成功后,输入任何问题就开始工作了。

常见错误速查

错误原因解决
command not found: agyPATH 没配置export PATH="$HOME/.local/bin:$PATH"
认证后卡在 “Signing In…”缺少 keyring安装 gnome-keyring
WSL 网络超时DNS 问题.wslconfig 设置 dnsTunneling=true
OAuth token 过期WSL 时钟漂移sudo hwclock -s 同步时钟

相关链接

FAQ

agy 安装在哪个目录?
默认安装到 ~/.local/bin/agy。如果终端找不到命令,需要把 ~/.local/bin 加入 PATH。
WSL 里每次都要重新登录怎么办?
安装 gnome-keyring 并创建无密码 keyring。WSL 没有图形界面,默认 keyring 会锁定导致认证不持久。
Ubuntu 可以用 apt 安装吗?
可以。添加 Google 官方 apt 源后 sudo apt install antigravity 即可,会安装 IDE。CLI 建议用 curl 脚本单独装。
Windows 上装的 Antigravity 能在 WSL 里用吗?
能。创建符号链接指向 Windows 安装目录的二进制即可,但更推荐在 WSL 里直接用 curl 安装原生 Linux 版。

相关文章