8848AI 工具指南
已核验真实支持边界
Git 编程助手
Aider 接入 8848API 完整指南
从安装、环境变量、永久配置到 Git 安全工作流，完整使用 8848API。
✅ 官方支持任意 OpenAI-compatible API8848API 信息
Base URL
https://api.884819.xyz/v1
API Key
控制台 → 令牌管理 → 添加令牌
协议要求
OpenAI-compatible Chat Completions
1. 安装 Aider
python -m pip install aider-install
aider-install
aider --version也可按 Aider 官方安装页使用 uv。Windows 建议在 PowerShell 或 WSL2 中运行。
2. 临时配置并测试
macOS / Linux
export OPENAI_API_BASE="https://api.884819.xyz/v1"
export OPENAI_API_KEY="你的 sk- 密钥"
cd /你的/项目目录
aider --model openai/claude-sonnet-4.6Windows PowerShell
$env:OPENAI_API_BASE="https://api.884819.xyz/v1"
$env:OPENAI_API_KEY="你的 sk- 密钥"
cd C:\你的\项目目录
aider --model openai/claude-sonnet-4.6模型名前必须加 openai/，后面填写 8848API 的完整模型 ID。
3. 永久配置（推荐）
在用户目录创建 .aider.conf.yml：
openai-api-base: https://api.884819.xyz/v1
model: openai/claude-sonnet-4.6
# 不建议把 key 写在这个文件里；key 使用环境变量然后把 OPENAI_API_KEY 加入系统安全的环境变量管理。不要把密钥提交到 Git。
4. 在 Git 项目中正确使用
- 进入项目目录，先执行
git status。 - 重要项目先 commit，保证能回滚。
- 运行
aider。 - 先让它解释一个小文件，再做小改动。
- 检查 diff 和测试结果后再提交。
5. 验证与排障
- 401：Key 错误、未加载或令牌不可用。
- 404：Base URL 应为
https://api.884819.xyz/v1，不要重复写/v1/v1。 - Unknown model / model warning：Aider 不认识新模型元数据时可能警告，不等于接口必然不可用；先做小任务验证。
- 工具调用效果差：选择明确适合编程和工具调用的模型。
- 改动过大：缩小任务范围，并始终查看 Git diff。