完整教程:🚀 别再被 Claude Code 绑架了!阿里云 + Aider:国内零门槛白嫖 AI 编程终极指南 - nanshawsの博客

你是不是也遇到了这种情况:费劲巴拉装好了 claude-code,结果启动就报 Unable to connect to Anthropic services?好不容易挂了代理,又跳出个 Select login method 强制要求官方订阅账号?

别折腾了! 官方工具的 “硬编码检查” 和 “强行登录” 对国内开发者极其不友好。今天,保姆级教程带你另起炉灶:利用 Aider(全球最强 CLI 编程工具)+ 阿里云百炼(无限白嫖额度),实现真正的开发自由!

 为什么这是目前的 “最优解”?

  1. 无登录锁:Aider 不需要你登录任何官方账号,只要有 API Key 就能跑。
  2. 模型自由:完美支持阿里云上的 qwen-long-latest(超长上下文)和 claude-3-5-sonnet
  3. 零成本:阿里云新用户送大量 Token 额度,配合 qwen-long 几乎等于不要钱。
  4. 环境隔离:使用 Conda 管理,不弄乱你的系统环境。

第一步:获取阿里云百炼 API Key(白嫖关键)

  1. 登录控制台:访问 阿里云百炼 (Model Studio) 并登录。
  2. 开通服务:点击 “立即开通”。新用户通常会看到一个 “领免费额度” 的弹窗,果断点击领取
  3. 创建 API Key
    • 在左侧导航栏选择 “API-KEY”
    • 点击 “创建 API-KEY”,将生成的 sk-xxxx 字符串保存好,这是你的通行证。
  4. 查找模型名称
    • 在 “模型库” 中搜索 qwen
    • 获取模型标识符。

这里的模型都可以随便选择。

这里的话,我打算使用最新的 qwen-long-latest


第二步:使用 Conda 搭建纯净环境

不要直接把工具装在系统 Python 里!我们用 Conda 创建一个隔离环境,干净又卫生。

# 1. 创建名为 aider 的环境,建议使用 python 3.12+
conda create -n aider python=3.12 -y
# 2. 激活环境
conda activate aider
# 3. 安装 Aider(目前公认最强 AI 编程助手)
pip install aider-chat

第三步:一键注入阿里云 API(核心步骤)

这是最关键的一步,我们要把阿里云的接口包装成 Aider 认识的格式。

方式一:PowerShell 永久配置(推荐)

在终端输入以下代码,一次配置,终身受益:

PowerShell

# 设置阿里云 API 地址
[System.Environment]::SetEnvironmentVariable("OPENAI_API_BASE", "https://dashscope.aliyuncs.com/compatible-mode/v1", "User")
# 填入你的阿里云 API Key
[System.Environment]::SetEnvironmentVariable("OPENAI_API_KEY", "你的实际_API_KEY", "User")
# 指定使用的模型(这里推荐使用性价比之王 qwen-long-latest)
[System.Environment]::SetEnvironmentVariable("OPENAI_API_MODEL", "qwen-long-latest", "User")

配置完后,请务必关闭并重新打开终端!


第四步:起飞!开始你的 AI 编程之旅

在你的项目根目录下,激活 Conda 环境并启动:

conda activate aider
aider --model openai/qwen-long-latest

当看到 Model: openai/qwen-long-latest 时,你已经成功了!

如果你不想每次都打这么长,可以在 PowerShell 里把默认模型也存进环境变量:

PowerShell

[System.Environment]::SetEnvironmentVariable("AIDER_MODEL", "openai/qwen-long-latest", "User")

设置完后记得重启终端,之后直接输入 aider 就会默认显示 Main model: openai/qwen-long-latest

 为什么我推荐 qwen-long-latest

  • 超长记忆:它能一次性 “吃下” 你的整个项目文档和代码库,不会像小模型那样 “转头就忘”。
  • 国产之光:针对中文注释和逻辑理解极佳,响应速度比海外 API 快得多。
  • 低成本:阿里云的免费额度能让你高强度写一个月的代码都不带心疼的。

 常见避坑指南

  1. Aider 连不上? Aider 默认会走 OpenAI 协议,所以如果你设了 OPENAI_API_BASE 为阿里云,记得不要开全局魔法,否则流量绕一圈反而报错。
  2. 模型找不到? 在 Aider 里如果默认模型不对,可以用命令:aider --model openai/qwen-long-latest 强制指定。
  3. 乱码问题:Windows 终端如果显示奇怪字符,执行 chcp 65001 即可。

第五步:使用 cursor 来管理项目(vscode 也是一样的)

初始化 PowerShell 的 Conda 支持

在当前的 PowerShell 窗口中输入:

conda init powershell

关掉重新打开。

文末附加内容

Logo

汇聚全球AI编程工具,助力开发者即刻编程。

更多推荐