接入与使用
Codex 怎么接入团队统一管理的模型？
了解如何让 Codex 等 OpenAI-compatible Agent 使用团队统一管理的推理入口，并将模型、密钥、余额和观测留在团队控制面。
由 路墨 Lumoswitch 产品团队维护
简要回答
让 Codex 等兼容客户端使用统一 Base URL、访问 Key 和对外模型 ID，团队即可在控制台管理模型、权限、成本与路由。
Codex 可以通过 Lumoswitch 调用模型吗？
可以。对于使用 OpenAI-compatible 接入方式的 Codex 工作流，可将 Lumoswitch 的推理服务地址作为模型入口，并使用 Lumoswitch 生成的访问 Key 与已发布的模型 ID。具体配置字段取决于客户端版本和团队实际部署，应该以对应客户端文档为准。
团队如何统一管理 Codex 使用的模型和额度？
管理员可以为不同应用或成员准备独立模型配置和访问 Key，由模型配置限定可用模型与调用速率，并在账户层管理余额、账单及用量。这样无需把上游凭据和成本边界分散到每个客户端。
OpenCode、OpenClaw 或内部 AI Agent 能接入吗？
支持 OpenAI-compatible 入口的客户端或内部 Agent，可以尝试配置 Lumoswitch 的统一 Base URL、访问 Key 和对外模型 ID。是否兼容某个工具的全部功能，还要看该工具要求的接口、鉴权方式与当前 Lumoswitch 部署实际开放的能力。
团队切换模型时需要修改每个 Codex 客户端吗？
如果客户端使用的是稳定的对外模型 ID，通常不需要逐台修改。管理员可以在该模型的候选资源和路由策略中做调整；但若变更了对外模型 ID、访问 Key 所属模型配置或客户端支持的接口格式，客户端也需要同步更新。
如何排查 Agent 调用异常？
先检查客户端使用的 Base URL、访问 Key 和模型 ID 是否正确，再查看 Key 状态、所属模型配置、模型状态和调用日志。日志中的请求状态、延迟、Token、路由结果与成本元数据可帮助定位是鉴权、限额、模型配置还是上游可用性问题。