文档 · 接入指南

Aider 接 TopxAI：OPENAI_API_BASE 和模型名

2026-09-19

用 OPENAI_API_BASE=https://ai.topxea.com/v1 和 --model openai/claude-sonnet-5-5 让 aider 走 TopxAI；Claude 线路也可以用 Anthropic 的变量。

Aider 底层是 LiteLLM，所以任何 OpenAI 兼容端点都能用 openai/ 前缀接入，Anthropic 端点用 anthropic/。

OpenAI 兼容（全部文本模型）

export OPENAI_API_BASE=https://ai.topxea.com/v1
export OPENAI_API_KEY=sk-...          # 自动路由的 TopxAI 密钥
aider --model openai/claude-sonnet-5-5

除 Jev 以外的任何目录 ID 都能接在 openai/ 后面：openai/gpt-6.1-sol、openai/grok-4.7、openai/kimi-k3、openai/GLM-5.3-Abliterated。

Anthropic（Claude，带提示缓存）

export ANTHROPIC_API_BASE=https://ai.topxea.com
export ANTHROPIC_API_KEY=sk-...
aider --model anthropic/claude-sonnet-5-5 --cache-prompts

--cache-prompts 打开 Aider 的缓存断点；TopxAI 转发它们，缓存读取按输入价的十分之一计费。

模型元数据

Aider 遇到没有上下文窗口和价格数据的模型名会告警。在项目旁边放一个 .aider.model.metadata.json，告警就停了，token 计数也准：

{
  "openai/claude-sonnet-5-5": {
    "max_input_tokens": 1000000,
    "max_output_tokens": 128000,
    "input_cost_per_token": 0.000001,
    "output_cost_per_token": 0.000005,
    "litellm_provider": "openai",
    "mode": "chat"
  }
}

上面的价格取自模型页的共享池价；Aider 只用它算自己的累计数，实际扣费以 TopxAI 用量日志为准。

固定下来

同样的值写进 ~/.aider.conf.yml（model: openai/claude-sonnet-5-5、openai-api-base: https://ai.topxea.com/v1），密钥放 ~/.aider/oai.env 或 shell 配置文件。

不通时

401：密钥错了，或粘贴时带了空格。402：余额为零。403：这个模型 ID 不在售，或不在这把密钥的线路上。详见常见错误响应。
curl 能通、工具不通：这一页按工具列出常见原因。

模型：claude-sonnet-5-5, gpt-6.1-sol · 模型与价格

Aider 接 TopxAI：OPENAI_API_BASE 和模型名

OpenAI 兼容（全部文本模型）

Anthropic（Claude，带提示缓存）

模型元数据

固定下来

不通时

相关