XylemNode

接入指南

Aider

跑在终端里的开源 AI 结对编程工具，直接改本地 git 仓库的代码并自动提交。它经由 LiteLLM 支持 OpenAI 兼容端点，配好环境变量、模型名加 openai/ 前缀就能用上 XylemNode。

获取 API Key
官网 / 下载
  1. 01

    安装

    官方推荐用 aider-install 一键安装，它会用独立环境装好 aider，不污染系统 Python。装完用版本号确认命令就绪。

    # 安装（全平台）
python -m pip install aider-install
aider-install

# 验证
aider --version
  2. 02

    配置端点与密钥

    用环境变量把 XylemNode 的接口地址和密钥交给 aider，地址要带 /v1。Windows 用 setx 写入后需重开终端才生效。

    # Windows（PowerShell / CMD）
setx OPENAI_API_BASE "https://api.xylemnode.com/v1"
setx OPENAI_API_KEY "sk-你的密钥"
# setx 后重开终端

# macOS / Linux
export OPENAI_API_BASE="https://api.xylemnode.com/v1"
export OPENAI_API_KEY="sk-你的密钥"
  3. 03

    进入项目、指定模型

    切到你的 git 项目目录，模型名前加 openai/ 前缀启动。这个前缀告诉 aider（经 LiteLLM）按 OpenAI 兼容方式请求；前缀后的模型名要和后台 /v1/models 里的完全一致。

    cd /path/to/your/project
aider --model openai/gpt-5.6-sol

两点说明

① aider 对不认识的模型名会弹 model warnings（提示缺上下文长度、价格等元数据），只是提醒、不影响使用，继续即可。 ② 不想每次设环境变量，可把 OPENAI_API_BASE、OPENAI_API_KEY 写进项目根目录的 .env，或写进 ~/.aider.conf.yml 固定下来。

常见问题

aider 启动时提示模型未知、上下文长度和价格都不知道？

这是预期提示，不是错误。模型名不在 aider 的内置清单里，它就会给出 Unknown context window size and costs, using sane defaults，并按「上下文无限、价格为零」来处理；官方的警告说明里写了这条通常可以忽略。代价是它不再替你做上下文管理和费用估算，长会话要自己留意；想让提示消失，可以按官方的进阶模型设置把元数据补上。顺带两个常见误配：模型名前必须带 openai/ 前缀——这是告诉底层的 LiteLLM 按 OpenAI 兼容方式请求；Windows 上用 setx 写的环境变量要重开终端才生效，官方同一页也专门提醒了。如果它反问 Did you mean…，那是把你的模型名当成了拼写错误，核对后台的完整标识即可。