Intégrer Claude Code et Codex

L’objectif est d’utiliser un agent de code comme Claude Code ou Codex normalement, sans que les valeurs sensibles n’atteignent le fournisseur du modèle. Cette page montre les chemins qui fonctionnent aujourd’hui et le gateway transparent qui est sur la roadmap.

Obtenir une clé API

Créez une clé dans l’interface TokenVeil, sous Préférences > onglet “Clé API” > Générer une clé API. Vous l’utilisez dans l’en-tête X-TV-API-Key. Voir la référence API pour le contrat complet.

Chemin 1 : l’API dans votre propre flux

La voie directe et déjà disponible est d’encadrer l’appel à votre agent par deux appels API : anonymiser le contenu avant qu’il ne sorte, restaurer la réponse ensuite.

# anonymiser un log ou le contenu d'un fichier
curl -s -X POST https://<hote>/api/v1/anonymize \
  -H "X-TV-API-Key: $TV_KEY" -H "Content-Type: application/json" \
  -d '{"text": "..."}'
# -> { "session_id": "TV-...", "anonymized_text": "...", "detected": {...} }

# ... envoyez anonymized_text à Claude Code ou Codex, récupérez une réponse qui porte encore les jetons ...

# restaurez les valeurs réelles en local
curl -s -X POST https://<hote>/api/v1/deanonymize \
  -H "X-TV-API-Key: $TV_KEY" -H "Content-Type: application/json" \
  -d '{"session_id": "TV-...", "text": "<la réponse de l agent>"}'

La table de correspondance reste chiffrée sur votre instance. Le fournisseur ne voit jamais que le texte tokenisé.

Chemin 2 : le script wrapper

Pour un flux local scripté, un wrapper léger autour des deux appels permet à un développeur de faire tourner l’agent sur du contenu tokenisé sans passer par l’interface. Il lit un log ou un fichier, l’anonymise, lance l’agent sur les jetons, puis restaure la réponse. La configuration tient en deux variables d’environnement :

export TOKENVEIL_URL="https://<hote>"
export TOKENVEIL_API_KEY="tkv_..."

La seule discipline à tenir : laissez le script anonymiser le fichier avant que l’agent ne le lise, et gardez le contenu brut hors du chat, pour que l’agent ne voie que des jetons. C’est le pont manuel en attendant le gateway transparent ci-dessous.

Codex

Le même motif s’applique à OpenAI Codex et à tout client compatible OpenAI : anonymiser le contexte, faire tourner l’agent sur les jetons, restaurer la réponse. Codex atteint le modèle via une URL de base configurable, qui est le mécanisme qu’utilise le gateway transparent.

Gateway transparent (roadmap)

La forme pleinement transparente, où vous pointez l’agent vers TokenVeil comme endpoint de modèle (ANTHROPIC_BASE_URL pour Claude Code, l’URL de base OpenAI pour Codex) et où tout le contexte destiné au modèle est anonymisé sur le fil sans wrapper ni étape manuelle, est en développement. C’est la version fail-closed et drop-in des flux ci-dessus. Voir la roadmap et la sécurité de déploiement.