Autenticación

Copilot SDK admite varios métodos de autenticación. Elige el que mejor se adapte a tu caso de uso.

Métodos de autenticación

Método	Uso principal	¿Requiere suscripción a Copilot?	Notas
Login con GitHub (CLI)	Desarrollo y ejecución manual	Sí	Usa las credenciales de login del CLI `copilot`
OAuth GitHub App / PAT	Token por usuario	Sí	Se indica con `github_token`
Variables de entorno	CI/CD y operación en servidor	Sí	`COPILOT_GITHUB_TOKEN`, etc.
BYOK (Bring Your Own Key)	Proveedor de modelo propio	No	Configuración de custom provider

Para BYOK consulta Custom providers. Si has hecho login con el CLI copilot o con gh, cuando no especificas nada se usan las credenciales guardadas.

use Revolution\Copilot\Facades\Copilot;

$response = Copilot::run(prompt: 'Hello');

OAuth GitHub App / PAT

Pasa a github_token un user access token obtenido con OAuth o un fine-grained PAT.

Se esperan tokens gho_ / ghu_ / github_pat_
ghp_ (Classic PAT) está desaconsejado

use Revolution\Copilot\Facades\Copilot;

$config = array_merge(config('copilot'), [
    'github_token' => $user->github_token,
]);

$response = Copilot::useStdio($config)->run(prompt: '...');
Copilot::stop();

Si indicas github_token, use_logged_in_user pasa automáticamente a false. Si quieres alternar explícitamente:

$config = [
    'github_token' => $user->github_token,
    'use_logged_in_user' => true,
];

Consulta GitHub token para más detalle. github_token y use_logged_in_user solo funcionan en modo stdio. En modo TCP, el CLI de Copilot debe estar ya autenticado por su cuenta.

Variables de entorno

Si pasas el token por variables de entorno, el CLI las detecta automáticamente. El orden de prioridad es de arriba a abajo:

COPILOT_GITHUB_TOKEN
GH_TOKEN
GITHUB_TOKEN

COPILOT_GITHUB_TOKEN=github_pat_xxx

use Revolution\Copilot\Facades\Copilot;

$response = Copilot::run(prompt: 'Hello');

En modo TCP configura las variables de entorno en el lado del servidor CLI.

Orden de prioridad de la autenticación

El SDK resuelve las credenciales en este orden:

github_token (indicado explícitamente)
Token por variable de entorno (COPILOT_GITHUB_TOKEN → GH_TOKEN → GITHUB_TOKEN)
Credenciales OAuth guardadas por el CLI
Credenciales del CLI gh

Si no quieres usar las credenciales guardadas, pon use_logged_in_user a false.

use Revolution\Copilot\Facades\Copilot;

$response = Copilot::useStdio([
    'use_logged_in_user' => false,
])->run(prompt: 'Hello');

Igual que con github_token, solo se admite en modo stdio. En TCP el CLI de Copilot debe estar ya autenticado.

Comprobar el estado de autenticación

Puedes consultar el resultado de auth.getStatus.

use Revolution\Copilot\Facades\Copilot;

$status = Copilot::client()->getAuthStatus();

if (! $status->isAuthenticated) {
    // No autenticado
}

Seleccionar una cuenta para el inicio de sesión interactivo

Enumera loginAccounts mediante la RPC de sesión para obtener las identidades guardadas que puedes reutilizar con un proveedor determinado. El label de cada elemento sirve para mostrarlo, y active indica si la identidad coincide con la cuenta activa de la sesión actual. accountId es un ID opaco que pertenece al proveedor. Pásalo tal cual a la solicitud de inicio de sesión, sin analizarlo ni modificarlo.

use Revolution\Copilot\Enums\AuthLoginMode;
use Revolution\Copilot\Enums\LoginProviderKind;
use Revolution\Copilot\Types\Rpc\AuthLoginBeginRequest;

$accounts = $session->rpc()->accounts();
$identities = $accounts->enumerate(
    'loginAccounts',
    provider: LoginProviderKind::ENTRA,
);

if (isset($identities[0])) {
    $accounts->begin(new AuthLoginBeginRequest(
        kind: LoginProviderKind::ENTRA,
        mode: AuthLoginMode::Default,
        accountId: $identities[0]->accountId,
    ));
}

Usa mode: 'default' para reutilizar una identidad guardada con el comportamiento normal del proveedor. Usa mode: 'selectAccount' para mostrar explícitamente el selector de cuentas del proveedor. En ese caso, no pases accountId. Las llamadas existentes como begin(LoginProviderKind::ENTRA) siguen funcionando.

Consulta la información más reciente en el repositorio de GitHub.

GitHub Copilot

SDK

AI SDK

VOICEVOX

Starter kits

Feeds y RSS

Middleware

Autenticación - GitHub Copilot SDK for Laravel

Autenticación

Métodos de autenticación

OAuth GitHub App / PAT

Variables de entorno

Orden de prioridad de la autenticación

Comprobar el estado de autenticación

Seleccionar una cuenta para el inicio de sesión interactivo

​Autenticación

​Métodos de autenticación

​Login con GitHub (CLI)

​OAuth GitHub App / PAT

​Variables de entorno

​Orden de prioridad de la autenticación

​Desactivar el login automático

​Comprobar el estado de autenticación

​Seleccionar una cuenta para el inicio de sesión interactivo

Autenticación

Métodos de autenticación

Login con GitHub (CLI)

OAuth GitHub App / PAT

Variables de entorno

Orden de prioridad de la autenticación

Desactivar el login automático

Comprobar el estado de autenticación

Seleccionar una cuenta para el inicio de sesión interactivo