跳转到主要内容
运行 phaseo aider,写入一份指向 Phaseo 的 Aider 配置;或者在你现有的 .aider.conf.yml 中添加三行。

使用 Phaseo CLI 设置

如果 ~/.aider.conf.yml 不存在,设置会创建一个 Phaseo CLI: Aider API Key(90 天后过期,每月支出上限 $100),并写入这个文件。不带 --model 时,它使用 anthropic/claude-sonnet-4.6。
~/.aider.conf.yml
Aider 需要 openai/ 前缀,才能通过其 OpenAI 兼容适配器发送自定义模型。发送到 Phaseo 的模型仍然是 anthropic/claude-sonnet-5.5。
密钥以明文存储,因为 .aider.conf.yml 是 Aider 文档中列出的密钥存放位置之一。请让该文件只对你的用户账户可读,并且绝不要提交它。

手动配置 Aider

如果你已经有 Aider 配置,CLI 会停止,不做任何更改。把上面的三项设置复制到你希望 Aider 加载的配置中,openai-api-key 使用 phaseo integrations credential aider 的输出或任意 Phaseo API 密钥。Aider 会从你的主目录、仓库根目录和当前目录读取 .aider.conf.yml,后读取的文件优先。请参阅 Aider 的 YAML 配置和 OpenAI 兼容 API 文档。

检查是否可用

打开一个仓库并启动 Aider:
检查启动输出中是否显示 openai/anthropic/claude-sonnet-5.5,让它回复 PHASEO_AIDER_OK,并确认请求出现在 设置 → 使用情况 → 日志 中。 未知模型警告不会阻止请求。只有在需要准确的 token 上限或费用估算时,才需要添加 Aider 模型元数据。

移除 Phaseo

这会撤销密钥,并且只有在 ~/.aider.conf.yml 仍以 Phaseo CLI 标记开头时才删除该文件。如果你把这些设置合并到了自己的文件中,请自行删除这三行。

解决常见问题

Aider 使用了其他端点或模型

仓库根目录或当前目录中的 .aider.conf.yml 会覆盖主目录中的那个。环境变量和命令行选项会覆盖所有配置文件。

身份验证失败

把 openai-api-key 与 phaseo integrations credential aider 的输出进行比较,并确保 openai-api-base 完全是 https://api.phaseo.app/v1。

无法解析模型

保留 Aider 的 openai/ 前缀。Phaseo 模型 openai/gpt-6-astra 在 Aider 中写作 openai/openai/gpt-6-astra。
最后修改于 2026年11月5日