Aider
配置 Aider 的 TokenFlux API 地址、密钥和模型，验证连接并排查常见错误。
Aider 通过 OpenAI 兼容 API 设置连接 TokenFlux。调用费用从 TokenFlux 余额扣除。
本指南在 Python 3.12 环境下，使用 Aider 0.86.2 和 gpt-6-luna 验证了流式回复。
开始前
- 准备已安装的 Aider。配置详情请参阅官方OpenAI 兼容 API 指南。
- 在网页版的 API 密钥 页面创建并复制密钥。完整密钥只显示一次。
- 在 账单 页面确认余额充足。
- 在 模型与价格 页面复制模型 ID，并检查模型支持的协议。
设置地址和密钥
在 Bash 或 Zsh 中设置 OpenAI 兼容地址和密钥：
export TOKENFLUX_API_KEY="YOUR_TOKENFLUX_KEY"
export OPENAI_API_BASE="https://tokenflux.ai/v1"
export OPENAI_API_KEY="$TOKENFLUX_API_KEY"将 YOUR_TOKENFLUX_KEY 替换为刚复制的密钥。请勿将密钥提交到 Git。
Aider 向 /v1/chat/completions 发送请求。请在启动 Aider 的终端中设置这些变量。
选择模型
使用 TokenFlux 模型目录中的 ID，并添加 openai/ 适配器前缀：aider --model openai/YOUR_MODEL_ID。如果目录 ID 本身包含 /，请保留完整 ID。例如，目录 ID openai/gpt-6-luna 在 Aider 中应写为 openai/openai/gpt-6-luna。
验证连接
在临时目录中运行以下命令。如果客户端要求确认文件访问，请核对路径后批准。
printf 'TOKENFLUX_GUIDE_OK\n' > marker.txt
aider --model openai/YOUR_MODEL_ID --no-git \
--message "Read marker.txt and return its contents without changes" marker.txt回复应包含 TOKENFLUX_GUIDE_OK。在 使用记录 页面确认模型和密钥，并查看 token 数量与费用。测试完成后删除 marker.txt。
故障排查
Aider 使用了其他提供商。 保留 openai/ 适配器前缀，并检查同一终端中的 OPENAI_API_BASE。
提示未知模型或上下文窗口警告。 Aider 可能没有网关模型的元数据。继续前请核对目录中的完整模型 ID 和模型限制。此警告本身不代表 API 调用失败。
安装时尝试编译 SciPy。 使用有二进制安装包的受支持 Python 版本。本指南使用 Python 3.12 验证。
返回 401、429 或模型错误。 检查密钥是否启用、模型 ID 是否完整，以及余额和限流状态。请勿自动改用其他模型。
API 参考
请参阅 Chat Completions、模型列表 和 API 概览。