Aider

1. 领取 SupaNexus API Key

登录开发者控制台，进入项目 → API Keys，创建 Key 并立即复制（仅展示一次）。同一把项目 Key 可用于 OpenAI 兼容与 Anthropic 兼容客户端。

2. 安装 Aider

用虚拟环境或 pipx 安装 Aider，确认 aider --version 可用。

python -m pip install aider-chat
# or: pipx install aider-chat
aider --version

3. 导出 OpenAI 兼容环境变量

OPENAI_API_BASE 指向 SupaNexus /v1，并设置 OPENAI_API_KEY。日常可写入 shell profile；临时验证可只在当前会话 export。

export OPENAI_API_BASE="<BASE_URL>/v1"
export OPENAI_API_KEY="sk-snx-..."

4. 可选：项目 .aider.conf.yml

可把非密钥默认项写入仓库；Key 仍放环境变量或本地未跟踪覆盖文件。

# .aider.conf.yml
openai-api-base: <BASE_URL>/v1
model: openai/deepseek/deepseek-chat

5. 选用目录型号 ID

型号 ID 以 SupaNexus 模型市场或 GET /v1/models 为准（例如 deepseek/deepseek-chat、anthropic/claude-3-5-sonnet）。不要套用其它网关的自创 slug。

6. 用目录型号启动 Aider

在型号 ID 前加 openai/ 前缀，让 Aider 走 OpenAI 兼容客户端。用 /add 加入文件，提一个小改动，确认能给出提交建议。

cd /path/to/your/project
aider --model openai/deepseek/deepseek-chat

7. 排障

仍请求 api.openai.com：当前 shell 未 export OPENAI_API_BASE。chat/completions 404：基址须以 /v1 结尾。未知型号：目录查询用裸 ID；CLI 的 --model 仍用 openai/{model-id}。