Linux 和 WSL 安装 Antigravity CLI 完整教程
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: agy | PATH 没配置 | export PATH="$HOME/.local/bin:$PATH" |
| 认证后卡在 “Signing In…” | 缺少 keyring | 安装 gnome-keyring |
| WSL 网络超时 | DNS 问题 | 在 .wslconfig 设置 dnsTunneling=true |
| OAuth token 过期 | WSL 时钟漂移 | sudo hwclock -s 同步时钟 |