Configurar herramientas de programación con IA en equipo

Q: ¿Cómo pongo una base url personalizada en Codex CLI?

Añada una sección model_providers.hopbase a ~/.codex/config.toml con base_url = "https://api.hop-base.com/v1", wire_api = "responses" y env_key = "OPENAI_API_KEY", y fije model_provider = "hopbase". Use una clave del grupo Codex Plus o Codex Pro.

Configurar las herramientas de programación con IA de todo un equipo lleva dos pasos: un administrador entrega a cada desarrollador una clave con cuota y los grupos adecuados, y cada desarrollador elige en cada herramienta el protocolo y la Base URL correctos. Los modelos Claude usan siempre Anthropic Messages con la Base URL https://api.hop-base.com (sin /v1). GPT, Gemini y GLM usan la API compatible con OpenAI en https://api.hop-base.com/v1. Claude Code lee ANTHROPIC_BASE_URL y ANTHROPIC_AUTH_TOKEN; Codex CLI lee config.toml más OPENAI_API_KEY; en Cursor, Cline, Roo Code, Continue y Trae basta con elegir el tipo de proveedor en los ajustes.

Empiece aquí: qué protocolo usa cada herramienta

Herramienta	Modelos	Protocolo / tipo de proveedor	Base URL	Dónde se configura
Claude Code	Claude	Anthropic Messages	`https://api.hop-base.com`	`ANTHROPIC_BASE_URL` / `ANTHROPIC_AUTH_TOKEN`, o `~/.claude/settings.json`
Codex CLI	GPT	OpenAI Responses (`wire_api = "responses"`)	`https://api.hop-base.com/v1`	`~/.codex/config.toml` + `OPENAI_API_KEY`
Cursor	GPT / Gemini / GLM	Override OpenAI Base URL	`https://api.hop-base.com/v1`	Cursor Settings → Models
Cursor	Claude	Campo Anthropic API Key	`https://api.hop-base.com`	Cursor Settings → Models (versión reciente)
Cline / Roo Code	GPT / Claude	OpenAI Compatible / Anthropic	Con /v1 para GPT, sin /v1 para Claude	Ajustes de la extensión → API Provider
Continue	GPT / Claude	`provider: openai` / `provider: anthropic`	Igual que arriba	`~/.continue/config.yaml`
Trae	GPT / Claude	OpenAI Compatible / Anthropic	Igual que arriba	Ajustes → Modelos → Añadir modelo

Otros editores como Zed o JetBrains AI siguen la misma regla: tipo Anthropic para Claude y tipo compatible con OpenAI para el resto. Los dos errores más frecuentes son añadir /v1 a la Base URL de Claude (la petición acaba en /v1/v1/messages) y elegir OpenAI Compatible con una clave de un grupo Claude. Ambos devuelven un 404 que indica que la plataforma no admite esa ruta de API.

Paso 1: el administrador entrega una clave a cada desarrollador

Cree departamentos. En la consola de empresa, cree un departamento por equipo (por ejemplo Backend y Frontend) y fije una cuota mensual de departamento. Los responsables de departamento reciben las alertas de cuota de su departamento.
Añada miembros y fije su cuota. Los miembros inician sesión con correo y contraseña y crean sus propias claves. La cuota de un miembro la comparten todas sus claves.
Una clave por herramienta. Recomendamos una clave de un grupo Claude para Claude Code y una clave del grupo Codex Plus o Codex Pro para Codex CLI. Cada clave incluye de 1 a 10 grupos y solo puede llamar a los modelos de esos grupos. Tenga en cuenta que el grupo Claude Max (ccmax) solo funciona con el cliente Claude Code; en Cursor, Cline y otros editores use una clave del grupo Claude Max Empresarial.
Añada límites a cada clave. Configure cuota, fecha de caducidad, lista de IP y límite de concurrencia según convenga. Las peticiones count_tokens que Claude Code usa para contar tokens también cuentan para la concurrencia, así que deje margen.
Configure alertas de saldo. Defina varios umbrales sobre el saldo disponible; al bajar de uno, se envía un correo y una notificación en la consola.

Cuando se agota una cuota, las peticiones se rechazan antes de procesarse (HTTP 402 insufficient_quota) y no se cobran. Las cuotas mensuales de departamentos y miembros se reinician a la vez el día de corte que usted elija (del 1 al 28).

Paso 2: cada desarrollador configura sus herramientas

Claude Code

Lo más sencillo es la configuración en un clic de la consola: abra Claves de API, pulse configuración en un clic junto a la clave, elija Claude Code y su sistema operativo y pegue el comando generado en una terminal. El comando usa un token de un solo uso válido 15 minutos, así que la clave nunca aparece en él. El script escribe la configuración en el bloque env de ~/.claude/settings.json (tras hacer copia del original). A partir de ahí se ignoran las variables de entorno con el mismo nombre definidas en la shell; para cambiar de clave, edite ese archivo o repita la configuración en un clic.

Configuración manual (macOS / Linux):

export ANTHROPIC_BASE_URL=https://api.hop-base.com
export ANTHROPIC_AUTH_TOKEN=sk-your-key
claude

Cambie de modelo con /model durante la sesión o arranque con --model claude-sonnet-5-5. Los pasos completos están en la guía de Claude Code, y un recorrido práctico del registro a la primera respuesta en esta guía de Claude Code con HopBase.

Codex CLI

Codex CLI también admite la configuración en un clic. Para hacerlo a mano, añada lo siguiente a ~/.codex/config.toml (en Windows, C:\Users\su-usuario\.codex\config.toml):

model_provider = "hopbase"
model = "gpt-5.6-sol"

[model_providers.hopbase]
name = "HopBase"
base_url = "https://api.hop-base.com/v1"
wire_api = "responses"
env_key = "OPENAI_API_KEY"

Después ejecute export OPENAI_API_KEY=sk-your-key e inicie codex. Tres cosas a tener en cuenta:

La configuración manual lee la clave con env_key; la configuración en un clic usa requires_openai_auth = true con ~/.codex/auth.json. No mezcle ambas en el mismo archivo o el gateway devolverá 401 missing_api_key.
La configuración en un clic fija model_reasoning_effort = "xhigh", el nivel que más tokens consume. Para el trabajo diario del equipo suele bastar con high o medium.
La búsqueda web (/v1/alpha/search) y la compactación remota de contexto (/v1/responses/compact) aún no están disponibles y devuelven 404. Las conversaciones normales no se ven afectadas.

Más detalles en la guía de Codex CLI.

Cursor

GPT / Gemini / GLM: en Cursor Settings → Models → API Keys, introduzca la clave del grupo correspondiente, active Override OpenAI Base URL, ponga https://api.hop-base.com/v1 y añada el ID del modelo.
Claude: use el campo Anthropic API Key y fije la Anthropic Base URL en https://api.hop-base.com (sin /v1; requiere una versión reciente de Cursor).

Las funciones integradas como el autocompletado Tab siguen usando el servicio propio de Cursor. Esta configuración solo afecta al modelo personalizado elegido en el Chat.

Cline / Roo Code

En los ajustes de la extensión, abra API Provider. Para modelos GPT elija OpenAI Compatible con https://api.hop-base.com/v1; para modelos Claude elija Anthropic con https://api.hop-base.com. Introduzca la clave y el ID del modelo y guarde.

Continue

# ~/.continue/config.yaml
models:
  - name: HopBase GPT
    provider: openai
    model: gpt-5.6-sol
    apiBase: https://api.hop-base.com/v1
    apiKey: sk-your-key
  - name: HopBase Claude
    provider: anthropic
    model: claude-sonnet-5-5
    apiBase: https://api.hop-base.com
    apiKey: sk-your-key

Ponga en cada apiKey la clave del grupo que corresponda. En Trae, vaya a Ajustes → Modelos → Añadir modelo y elija OpenAI Compatible para GPT o Anthropic para Claude. La guía de editores e IDE cubre cada editor en detalle.

Paso 3: verificar y resolver errores

Confirme los ID de modelo: llame a GET /v1/models con la clave y use solo los ID que devuelve.
```
curl https://api.hop-base.com/v1/models -H "Authorization: Bearer sk-your-key"
```
Prueba mínima: elija el nuevo modelo en la herramienta y envíe «Responde solo ok». Active llamadas a herramientas, imágenes y contexto largo solo cuando esto funcione.
Lea el error: con un 404, revise si sobra o falta /v1 y si una clave de Claude se configuró como tipo OpenAI. Con un 401, revise la clave y si Codex mezcla los dos estilos de clave. Un 402 significa cuota agotada: pida a un administrador que la amplíe.

Gestión después del despliegue

Seguir el gasto: la página de uso filtra por fecha, clave, miembro, departamento y creador de la clave, y exporta CSV. Con una clave por herramienta se ve directamente cuánto cuesta Claude Code y cuánto Codex CLI.
Revisar cambios: los cambios de cuota y la creación o desactivación de claves quedan registrados y se pueden consultar por fecha y objeto.
Bajas: al desactivar a un miembro, todas sus claves dejan de funcionar al instante. Una clave concreta también se puede desactivar o revocar en cualquier momento sin afectar a nadie más.

¿Listo para configurar a su equipo? Regístrese en HopBase, cree una cuenta de empresa y añada miembros y departamentos.

Preguntas frecuentes

¿Cómo pongo una base url personalizada en Codex CLI?

Añada una sección model_providers.hopbase a ~/.codex/config.toml con base_url = "https://api.hop-base.com/v1", wire_api = "responses" y env_key = "OPENAI_API_KEY", y fije model_provider = "hopbase". Use una clave del grupo Codex Plus o Codex Pro.

¿Puede Cursor usar Claude con una API personalizada?

Sí. En lugar de Override OpenAI Base URL, ponga una clave de un grupo Claude en el campo Anthropic API Key y fije la Anthropic Base URL en https://api.hop-base.com (sin /v1). Necesita una versión reciente de Cursor; el autocompletado Tab sigue usando el servicio propio de Cursor.

¿Cómo evitamos que un desarrollador agote el presupuesto de Claude Code del equipo?

Combine los tres niveles de cuota: la de departamento limita al equipo, la de miembro a cada persona y la de clave a cada herramienta. Si cualquiera se agota, la petición se rechaza antes de procesarse (HTTP 402) y no se cobra. Si la suma de cuotas de miembros supera la del departamento, se aplica el orden de llegada.