Conectar un agente OpenAI-compat al gateway

Pega Base URL + clave virtual en cualquier agente BYO OpenAI-compat. No para logins de plan Cursor/Claude/Codex.

Prompt#

Apunta mi agente OpenAI-compat (OpenClaude, Command Code, Cursor BYOK, …) a Orchemax para usar mis API keys de OpenRouter / Groq con rotación. (Este asiento no es un plan de Cursor / Claude / Codex.)

Qué hace el Chair#

Nada — esto es tuyo. No hay herramienta MCP: pegas el env en la config del agente una vez desde una terminal humana.

CLI#

orch gateway                            # arranca el gateway primero
orch gateway connect                    # o: connect openai / openclaude / …
orch gateway status

connect imprime el bloque OpenAI-compat (aliases como openclaude hacen lo mismo). Orchemax no escribe settings por CLI para cientos de agentes — solo connect opencode --allow-user-scope escribe opcionalmente el JSON de OpenCode.

Pega en el agente:

  • Base URL → http://127.0.0.1:8788/v1
  • Modelos → GET http://127.0.0.1:8788/v1/models (elige un orchemax/… vivo)
  • API key → mejor no pegarla en settings.json de OpenClaude si lanzas con orch openclaude — Orchemax inyecta orch_wk_… de sesión. Un orch_gk_… pegado en settings pisa ese env y Free (concurrent=1) niega el chat del propio asiento como falso "quota exhausted". Para openclaude suelto (sin orch), pega el orch_gk_… en el perfil/UI del provider.

Respuesta esperada#

Exports de OPENAI_BASE_URL / OPENAI_API_KEY (y comentarios para agentes GUI). Reinicia el agente (o abre sesión nueva) tras pegar.

Gotchas#

  • Asientos con plan conservan el login. Cursor suscripción, Claude Code plan y Codex no deben usar gateway connect.
  • Solo dos protocolos. OpenAI-compat (connect / openai) vs Anthropic Messages (connect anthropic). Nombres desconocidos → OpenAI-compat.
  • Las keys viven en machine-home keys.env. Solo la virtual orch_gk_… se pega en el agente.
  • OpenClaude: no pines OPENAI_MODEL en settings.env. Ese valor pisa el picker de la UI (p. ej. siempre vuelve a orchemax/pareto). Pon la elección solo en el campo model; deja OPENAI_BASE_URL en env. Ver Ajustes comunes del asiento.
  • Los skills de OpenClaude viven en .openclaude/skills/, no en .claude/. orch openclaude siembra orch-chair / orch-worker ahí al lanzar. Copia de usuario opcional: orch chair install --target openclaude --scope user --allow-user-scope.

Relacionado#