Factory

Factory Droid 是一款编程智能体 CLI。在 ~/.factory/settings.json 中把 OneProvider 添加为自定义的、兼容 Anthropic 的模型。

配置

Factory Droid 从 ~/.factory/settings.json 读取自带密钥的模型——服务商没有网页界面。把模型添加到 customModels 数组；baseUrl 请不要带 /v1，因为 anthropic 服务商会自己补上 /v1/messages。

{
"customModels": [
{
"model": "claude-sonnet-5-5",
"displayName": "OneProvider claude-sonnet-5-5",
"baseUrl": "https://api.oneprovider.dev",
"apiKey": "sk-your-key-here",
"provider": "anthropic",
"maxOutputTokens": 8192
}
]
}

要添加其他 Claude 模型，请用不同的 model 再加几项。然后在 droid 中运行 /model，并在 Custom models 下选择该模型。

为 droid 分配模型

每个 Factory droid 都有一个默认模型。日常使用 claude-sonnet-5-5 即可，架构类的重活可以用 claude-opus-5-5。

如何选择模型

每个模型添加一项 customModels。claude-sonnet-5-5 是 droid 实用的默认选择；架构类的重活用 claude-opus-5-5，要又快又便宜的 droid 用 claude-haiku-5-5。provider 请保持为 "anthropic"。ID 见模型页面 ，费率见价格页面 。

常见错误与解决办法

404

baseUrl 必须是不带 /v1 的 https://api.oneprovider.dev：anthropic 服务商会自己补上 /v1/messages。

401

该项中的密钥被截断，或者混入了多余的引号。请粘贴完整的密钥。

/model 中没有这个模型

请保存 ~/.factory/settings.json（有效的 JSON，不含智能引号）并重新打开 droid；自定义项会出现在 Custom models 下。

429 “Insufficient balance”

余额或密钥的限额已用完。请为个人中心充值余额。

常见问题

服务商有网页界面吗？

没有。自带密钥的模型只能在 ~/.factory/settings.json 中配置。

可以添加多个模型吗？

可以，在数组里为每个模型加一个对象；同一个密钥对所有模型都适用。

在哪里查看费用？

在该密钥的仪表板“用量”页面。

快速解答

该使用哪个 base URL？

Claude Code 和 Anthropic SDK 使用 https://api.oneprovider.dev。OpenAI SDK 和兼容 OpenAI 的客户端使用 https://api.oneprovider.dev/v1。同一个密钥可用于这两个地址；模型列表见模型页面 ，费率见价格页面 。

如何进行身份验证？

将完整的 sk-… 密钥放在 x-api-key 或 Authorization: Bearer 中，二选一，不要同时使用。请把密钥存放在环境变量中，不要写进会被提交的文件。了解更多身份验证说明 。

在哪里获取密钥？

在 Telegram 机器人 @oneprovider_robot 或 app.oneprovider.dev 打开您的个人中心，为余额充值，然后点击“签发密钥”。每个密钥都可以设置各自的消费限额。个人中心与 API 密钥 。

401、404 和 429 是什么意思？

401：密钥缺失、拼写有误或放错了请求头；请粘贴完整的密钥，不要带引号或空格。404：通常是 base URL 不对，例如缺少或重复了 /v1。429 且提示“Insufficient balance”：个人中心余额或密钥的消费限额已用完，请充值，不要反复重试；其他 429 属于速率限制，请等待 Retry-After 指定的时间。详情见：错误码 和故障排查 。

流式输出为什么会中断或被重置？

VPN 和 VLESS 代理常常会缓冲 SSE，或破坏 HTTP/2 协商。OneProvider 没有地区限制，也不会缓冲流式输出，请关闭代理后重试。

以上都没解决，该去哪里咨询？

请在 Telegram 联系 @Oneproviderhelpbot ，或在网页个人中心打开“客服”，并附上 HTTP 状态码和完整的错误信息。客服如何运作 。