如何在 Codex、Claude Code、OpenCode 等工具中调用共享模型
使用 Fasten Share 消费者 API Key 搜索模型节点、生成兼容地址,并安全配置 Codex、Claude Code、OpenCode、OpenClaw、Hermes、Pi 或 curl。
Fasten Share 消费者可以搜索在线模型节点,选择一个生产者,并生成兼容的服务地址。你无需获得生产者的上游密钥;调用时使用自己创建的 Fasten Share 消费者 API Key。
客户端还可以为 Codex、Claude Code、OpenCode、OpenClaw、Hermes、Pi 等工具生成或写入配置。能否配置某个工具,取决于生产者节点发布的协议和兼容能力,而不仅是模型名称看起来是否相同。
第一步:创建消费者 API Key
从下载页面安装并登录 Fasten Share,进入消费者页面,创建或选择一把消费者 API Key。
这把密钥只用于访问 Fasten Share 服务端,与生产者的上游 API Key 完全不同。请像保护其他 API 凭证一样保存它:
- 不要发到群聊、工单截图或公开仓库;
- 不要在多个不受信任设备之间长期复用;
- 怀疑泄露时立即撤销并重新创建;
- 配置文件需要同步时,确认同步服务的加密和访问范围。
第二步:搜索并选择模型节点
在消费者节点列表中按模型、协议或关键字搜索。选择节点时,不要只看模型名,还应检查:
- 协议是否满足工具要求,例如 OpenAI Responses 或 Anthropic Messages;
- 节点当前是否在线,健康检查是否正常;
- 生产者声明支持哪些消费者工具;
- 积分倍率是否符合你的预期;
- 最近三个月评分和关注关系是否提供了足够信任信号;
- 你的账户是否有足够消费积分。
同一个模型名可能由不同生产者提供,也可能具有不同上游实现、延迟、倍率和功能限制。先用小请求验证,再用于长任务。
第三步:生成服务地址或 curl
选中生产者节点后,客户端会生成包含协议、模型和生产者标识的 Fasten Share 服务地址。通用调用通常还需要消费者 API Key:
curl "https://node.fastenshare.com/api/v1/inference/PROTOCOL/MODEL/PRODUCER/PATH" \
-H "Authorization: Bearer FASTEN_CONSUMER_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"MODEL","messages":[{"role":"user","content":"reply with OK"}]}'
不要手工猜测编码后的模型、生产者 ID 或最终路径,优先复制客户端生成的命令。这样可以减少协议和版本前缀错误。
使用工具配置助手
Codex
Codex 通常需要 OpenAI Responses 风格能力。选择声明支持 Codex 且协议有效的节点,再让客户端生成配置。某些节点可能通过 Chat Completions 转换到 Responses;这类转换不一定支持有状态会话、托管工具、后台模式、Responses WebSocket 或所有工具调用。
如果任务依赖这些功能,应选择原生 Responses 节点并先执行测试任务。配置助手会尽量避免已有 OAuth 登录状态覆盖新 API Key,但修改前仍应了解当前工具配置并保留备份。
Claude Code
Claude Code 应选择声明支持 Claude 且使用 Anthropic 兼容协议的节点。工具中的 Fasten Share API Key 是消费者密钥,不是任何生产者的 x-api-key。
如果工具仍尝试使用旧的 OAuth 登录或其他供应商配置,按客户端提示清理冲突状态,并确认生成配置指向官方 Fasten Share 服务域名。
OpenCode、OpenClaw、Hermes 与 Pi
这些工具的提供商和配置文件结构各不相同。Fasten Share 客户端只会为节点声明支持的工具提供相应选项。使用自动配置前:
- 关闭正在写入相同配置的工具实例;
- 查看客户端将修改的文件和备份提示;
- 配置后重新打开工具;
- 先发起一个短请求验证模型、协议和流式返回;
- 如需回退,使用备份恢复原配置。
Pi 会注册 Fasten Share provider 并保留已有设置;其他工具也会尽量保留现有配置,但任何自动写入前都值得先备份。
请求内容和密钥分别经过哪里
消费者 API Key 会发送给 Fasten Share 服务端用于认证。提示词、工具输入和模型响应也会经过服务端,以完成路由、流式转发、权威计量和结算。
生产者的上游 API Key 不会发给你,也不会由服务端保存;它在生产者设备上注入给真实模型后端。两类密钥隔离降低了直接泄露风险,但并不意味着业务内容绕过中心服务。
不要在敏感任务中假设任何第三方模型节点拥有与企业私有部署相同的数据处理承诺。应根据数据敏感度、平台规则、生产者信任信号和组织要求决定是否使用。
常见错误
返回 401 或未授权
确认使用的是有效的 Fasten Share 消费者 API Key,并且请求头格式与客户端生成示例一致。不要把生产者示例中的上游 Key 填入消费者工具。
模型或路径不存在
重新从客户端复制当前节点地址。生产者可能已经修改模型、协议或版本前缀,旧地址不一定继续有效。
工具忽略新配置
检查工具是否仍有 OAuth 登录、环境变量或更高优先级配置覆盖文件设置。使用客户端配置助手的冲突检测和备份流程。
普通对话可用,但工具调用失败
节点可能只支持基本文本推理,或经过协议转换后不支持所需功能。查看生产者声明的工具兼容性,换用原生协议节点进行对比。
流式响应中断或延迟过高
换一个在线且评分更稳定的节点,用短请求对比。持续失败时保留请求时间、协议和错误信息,通过 GitHub Issues 或官方反馈渠道提交,但不要附带完整 API Key。
推荐的首次验证顺序
- 用客户端生成的
curl完成一个短请求; - 确认消费积分变化符合当前倍率;
- 再使用配置助手写入目标工具;
- 重启工具并执行最小任务;
- 最后再运行长上下文、工具调用或代码任务。
如果你还不熟悉生产者、消费者与平台路由的关系,先阅读 Fasten Share 是什么和快速开始。