Codex en API privée · Le guide FastAPI complet

L'idée

Le principe en une phrase

Tu héberges Hermes, tu le branches sur Codex (ton plan ChatGPT), tu te connectes en SSH, et tu demandes à l'agent de construire l'API pour toi. C'est l'IA qui écrit le code, pas toi.

Résultat : un endpoint privé /v1/chat/completions qui répond comme l'API OpenAI mais tourne sur ton serveur, facturé via ton abonnement — pas au token.

À lire d'abord — CGU Codex s'authentifie avec ton abonnement ChatGPT. L'utiliser comme backend d'API programmatique est dans la zone grise des CGU OpenAI (abo prévu pour un usage interactif). À faire en connaissance de cause, sur ton propre compte.

Déployer Hermes sur Hostinger
Récupérer ton accès SSH
Connecter Codex à Hermes
Laisser l'agent monter l'API
FAQ

Étape 1

Déployer Hermes sur Hostinger

Hostinger propose Hermes en application prête à l'emploi. Pas d'install manuelle : tu choisis ton VPS, tu sélectionnes l'app, ça se déploie tout seul sur Ubuntu + Docker.

Déployer Hermes →

Prends au moins un KVM 2 (2 vCPU / 8 Go). Une fois déployé, ton VPS tourne — il ne reste plus qu'à y accéder.

Bon à savoir Hermes est livré prêt à piloter : il ne lui manque qu'un cerveau LLM, qu'on branche à l'étape 3.

Étape 2

Récupérer ton accès SSH

Tout se passe dans le panel Hostinger. Tu ajoutes ta clé SSH, puis tu copies ta commande de connexion. Suis les écrans.

VPS Hostinger : menu Gérer puis Paramètres — 1 Dans **VPS**, ouvre le menu ⋮ de ton serveur → **Paramètres**.

Paramètres principaux : entrée Clés SSH dans le menu latéral — 2 Dans **Paramètres**, clique sur **Clés SSH**.

Page Clés SSH : bouton Ajouter une clé SSH — 3 Clique sur **+ Clé SSH** pour en ajouter une.

Modale d'ajout de clé SSH avec la commande ssh-keygen — 4 Pas encore de clé ? Génère-la, puis colle ta clé **publique** dans le champ.

La commande de génération (à lancer dans ton terminal, une seule fois) :

Terminal · local

ssh-keygen -t ed25519 -C "ton_email@exemple.com"
cat ~/.ssh/id_ed25519.pub   # copie cette ligne dans Hostinger

Aperçu général du VPS : commande d'accès root ssh root@IP — 5 Dans l'**Aperçu général**, copie ta commande **Accès root** — c'est ton sésame.

Étape 3

Connecter Codex à Hermes

C'est l'étape clé : on donne un cerveau à Hermes en le branchant sur Codex — ton plan ChatGPT. C'est ce qui rend tout « gratuit » à l'usage (pas de clé API au compteur).

Se connecter au serveur

Terminal

ssh root@TON_IP

Authentifier Codex (plan ChatGPT)

Sur un serveur sans navigateur, on utilise le mode device : la commande affiche une URL + un code, que tu valides depuis ton laptop avec ton compte ChatGPT.

Sur le serveur

codex login --device-auth

Sélectionner le provider Codex dans Hermes

Ouvre l'interface Hermes et va dans les réglages des providers. Comme Codex est authentifié en OAuth, il n'y a aucune clé API à coller.

Interface Hermes : bouton réglages en bas à gauche — 1 En bas à gauche de Hermes, ouvre les **réglages** (roue crantée).

Réglages Hermes : entrée Providers — 2 Dans **Settings**, clique sur **Providers**.

Provider OpenAI Codex authentifié via OAuth dans Hermes — 3 **OpenAI Codex** apparaît **« Authenticated via OAuth »** — aucune clé API nécessaire. Hermes tourne désormais sur Codex.

En une phrase Codex authentifié + provider « OpenAI Codex » actif = Hermes pense avec ton plan ChatGPT, à coût marginal nul. Tout le reste en découle.

Étape 4

Laisse l'agent monter l'API

Maintenant que Codex tourne, on l'expose comme une API OpenAI-compatible. Tu ne codes pas : tu donnes un prompt, l'agent fait tout.

Lancer l'agent

Codex est déjà là (Hermes l'utilise). Lance-le directement. Si tu préfères Claude Code, une commande suffit :

Sur le serveur

# Option A — Codex (déjà présent via Hermes)
codex

# Option B — Claude Code
npm install -g @anthropic-ai/claude-code
claude

Le prompt à lui donner

Colle ce brief à l'agent. Il s'occupe de tout : code, dépendances, service, test.

Prompt · copier-coller

Tu es sur un VPS où le CLI "codex" est installé et authentifié.
Monte une petite API FastAPI OpenAI-compatible qui sert de façade à codex :

- Endpoints : POST /v1/chat/completions et GET /v1/models
- Sous le capot : appelle "codex exec" en lecture seule, récupère le
  message final, et renvoie une réponse au format chat.completion
- Sécurité : authentification par clé Bearer (génère une clé aléatoire),
  bind uniquement sur 127.0.0.1:8088
- Robustesse : limite la concurrence (2 en parallèle) et mets un timeout
- Lance le tout en service systemd qui redémarre tout seul

Installe les dépendances, écris le code, démarre le service, puis teste
avec un curl et montre-moi le résultat. À la fin, donne-moi en clair :
la clé Bearer, l'URL de l'API, et la commande pour brancher un client OpenAI.

L'agent déroule seul. Au bout du compte tu as un endpoint privé prêt à brancher dans n8n, Hermes, ou n'importe quel client OpenAI — avec la clé et l'URL fournies par l'agent.

Tu veux aller plus loin ? Enchaîne avec un autre prompt : « ajoute le support du streaming stream:true » ou « conteneurise l'API et mets-la sur le réseau Docker de Hermes ». Il adapte.

Questions fréquentes

FAQ

C'est vraiment ~0€ ?

Le coût marginal par appel est quasi nul : Hermes pense avec ton abonnement ChatGPT (via Codex) au lieu de l'API facturée au token. Tu paies déjà l'abo. Attention aux CGU et aux éventuels throttlings.

Je dois savoir coder ?

Non. Tu te connectes en SSH, tu colles un prompt, l'agent fait le reste. C'est tout l'intérêt de la méthode.

Codex ou Claude Code ?

Les deux marchent pour monter l'API. Codex est déjà présent via Hermes (pratique). Claude Code s'installe en une commande si tu préfères son approche. Le prompt est le même.

Pourquoi passer par Hermes ?

Parce que Hostinger le déploie en 1 clic et qu'il sait tourner sur Codex en un réglage. Tu démarres avec un agent opérationnel au lieu de tout configurer à la main.

À toi de jouer

Ton API privée, montée par l'IA

Déploie Hermes, branche-le sur Codex, colle le prompt. Tu as un endpoint OpenAI-compatible à coût marginal nul — sans écrire une ligne.

Déployer Hermes sur Hostinger

Alexis Gatuingt · Consultant IA & Agent Builder