Debian上一键安装Aider+设置Gemini/openrouter api

创建安装脚本文件

nano install_aider.sh

将下面的代码完整复制并粘贴进去

(粘贴后按 Ctrl+O 保存,回车,然后 Ctrl+X 退出)

#!/bin/bash

# 定义安装目录
INSTALL_DIR="$HOME/my-ai-bot"

echo "=================================================="
echo "   Aider 全自动安装脚本 (Debian版)"
echo "   目标目录: $INSTALL_DIR"
echo "=================================================="

# 1. 更新系统并安装基础依赖
echo ">> [1/6] 更新系统并安装依赖..."
apt-get update -qq
apt-get install -y git python3 python3-pip python3-venv tmux -qq

# 2. 创建项目目录
echo ">> [2/6] 创建独立工作目录..."
mkdir -p "$INSTALL_DIR"
cd "$INSTALL_DIR"

# 3. 创建并激活虚拟环境 (完美解决 externally-managed-environment 问题)
echo ">> [3/6] 创建 Python 虚拟环境..."
python3 -m venv venv
source venv/bin/activate

# 4. 安装 Aider
echo ">> [4/6] 正在安装 Aider (可能需要几分钟)..."
pip install aider-chat --upgrade --quiet

# 5. 配置 API Key (交互式询问)
echo ">> [5/6] 配置 API Key"
echo "--------------------------------------------------"
read -p "请输入您的 Google Gemini API Key (回车跳过): " GEMINI_KEY
read -p "请输入您的 OpenRouter API Key (回车跳过): " OPENROUTER_KEY

# 创建 .env 文件
cat > .env <<EOF
GEMINI_API_KEY=$GEMINI_KEY
OPENROUTER_API_KEY=$OPENROUTER_KEY
EOF

# 创建 Aider 配置文件 (设置默认模型)
cat > .aider.conf.yml <<EOF
# 默认使用 Gemini 3 Pro
model: gemini/gemini-3-pro-preview
# 自动读取 .env 文件
env-file: .env
# 开启自动 Git 提交
auto-commits: true
EOF

# 6. 创建启动快捷脚本
echo ">> [6/6] 生成启动快捷方式..."
cat > start.sh <<EOF
#!/bin/bash
cd $INSTALL_DIR
source venv/bin/activate
echo "正在启动 Aider (默认模型: Gemini 3 Pro)..."
aider
EOF
chmod +x start.sh

# Git 初始化
if [ ! -d ".git" ]; then
    git init > /dev/null
    git config user.email "bot@server.com"
    git config user.name "AI Bot"
fi

echo "=================================================="
echo "   安装完成!🎉"
echo "=================================================="
echo "以后每次要使用,只需运行以下命令:"
echo "   $INSTALL_DIR/start.sh"
echo ""
echo "或者直接运行我为您准备好的命令进入:"
echo "   ~/my-ai-bot/start.sh"
echo "=================================================="

赋予权限并运行安装

chmod +x install_aider.sh
./install_aider.sh

脚本运行过程中的提示

  1. 运行脚本后,它会跑代码,跑到一半会停下来问您:

    • 请输入您的 Google Gemini API Key: -> 粘贴您的 Key,回车。

    • 请输入您的 OpenRouter API Key: -> 粘贴您的 Key,回车。

  2. 如果不输入直接回车,可以在安装好后去 ~/my-ai-bot/.env 文件里手动补填。

安装完成后如何使用?

以后您登录服务器,想开始编程,只需要运行这个短命令:

~/my-ai-bot/start.sh

这个脚本会自动帮您:

  1. 进入 my-ai-bot 文件夹。

  2. 激活 Python 虚拟环境。

  3. 读取 .env 里的 API Key。

  4. 读取 .aider.conf.yml 里的配置(自动使用 gemini-3-pro-preview)。

  5. 启动 Aider。

如果想用 Tmux 挂后台 (防断连推荐):

tmux new -s bot
~/my-ai-bot/start.sh

如何切换模型?

例子:想找 DeepSeek 的模型

/models deepseek

找到名字后,使用 /model 命令(注意没有 s)来立即切换。切换后,新的模型会继承之前的聊天上下文继续为您工作。

指令格式: /model 模型完整名称

  • 场景 A:遇到难题,想换最强的 claude-opus-4.5(走 OpenRouter)

/model openrouter/anthropic/claude-opus-4.5

场景 B:想换回 Google 官方的 Gemini 1.5 Pro (省钱/长文本)

/model gemini/gemini-3-flash-preview

场景 C:想换回您默认设置的 Gemini 3 Preview

/model gemini/gemini-3-pro-preview

快捷指令

给 Aider 配了一把“万能钥匙扣”,以后无论去哪里建新项目,它都会自动读取那个固定位置的 Key

echo 'alias aider="~/my-ai-bot/venv/bin/aider --env-file ~/my-ai-bot/.env --model gemini/gemini-3-pro-preview"' >> ~/.bashrc && source ~/.bashrc

现在去哪个文件夹,输入aider就可以唤出aider了

⚡ 进阶:做一个 aider-flash 的快捷指令

既然您经常需要在“省钱/极速模式”和“专家模式”之间切换,每次输这么长命令太累了。我们直接给 Flash 模式做一个专属别名。

请在终端运行这行命令(一次性设置):

echo 'alias aider-flash="~/my-ai-bot/venv/bin/aider --env-file ~/my-ai-bot/.env --model gemini/gemini-3-flash-preview --weak-model gemini/gemini-3-flash-preview"' >> ~/.bashrc && source ~/.bashrc

现在拥有了两个强大的命令:

  1. 想用最强模型 (Pro) 时: 输入 aider (主模型 Pro,弱模型 Pro)

  2. 想用极速模型 (Flash) 时: 输入 aider-flash (主模型 Flash,弱模型 Flash)

明天恢复

在项目目录里重新启动 aider 时,用恢复聊天记录的选项:

滚动至顶部