La famille Claude d’Anthropic est une option solide pour le codage, les agents et le raisonnement sur longs contextes, mais le coût API peut vite bloquer un prototype ou un projet perso. Puter.js propose une autre approche : exposer Claude côté navigateur sans clé Anthropic côté développeur. L’utilisateur final se connecte à Puter et couvre sa propre consommation ; votre application n’a pas à gérer la facturation Anthropic.
Dans ce guide, vous allez intégrer Puter.js, choisir un modèle Claude, appeler puter.ai.chat, activer le streaming, gérer les conversations multi-tours et comprendre quand préférer l’API officielle d’Anthropic.
En bref
- Puter.js permet d’appeler Claude depuis le navigateur, sans clé API Anthropic dans votre code.
- L’utilisateur final utilise son propre compte Puter ; vous ne portez pas la facture API.
- Modèles mentionnés : Opus 4.7, Opus 4.6, Opus 4.6 Rapide, Opus 4.5, Opus 4.1, Opus 4, Sonnet 4.6, Sonnet 4.5, Sonnet 4, Haiku 4.5.
- L’intégration minimale tient en une balise
<script>et un appel àputer.ai.chat. - Le streaming, les invites système et les conversations multi-tours sont disponibles.
- Vous pouvez utiliser Apidog pour comparer vos appels avec l’API officielle d’Anthropic lorsque vous préparez une migration ou un benchmark.
Comment fonctionne le modèle côté Puter
Puter.js est une bibliothèque cloud et IA orientée navigateur. Le changement principal est architectural : au lieu de stocker une clé Anthropic côté serveur ou côté client, vous laissez Puter gérer l’accès. L’utilisateur se connecte à Puter, et l’usage est associé à son compte.
Conséquences pratiques pour votre application :
- Pas de clé API dans le dépôt : rien à exposer, rien à faire tourner, rien à révoquer.
- Pas de facturation Anthropic côté développeur : chaque utilisateur utilise son propre compte Puter.
- Pas de backend obligatoire : un site statique peut appeler Claude directement via Puter.js.
La limite importante : Puter.js est d’abord conçu pour le navigateur. Pour un service backend, un bot Discord, une tâche cron ou du batch processing, l’API officielle d’Anthropic reste plus adaptée.
Étape 1 : Ajouter Puter.js
Pour un prototype ou une page statique, ajoutez simplement le script CDN :
<script src="https://js.puter.com/v2/"></script>
Exemple minimal :
<!DOCTYPE html>
<html lang="fr">
<head>
<meta charset="UTF-8" />
<title>Claude avec Puter.js</title>
</head>
<body>
<script src="https://js.puter.com/v2/"></script>
</body>
</html>
Si vous utilisez une application avec bundler, vous pouvez aussi passer par NPM :
npm install @heyputer/puter.js
Puis importer la bibliothèque :
import { puter } from '@heyputer/puter.js';
Pour un test rapide, le CDN est le chemin le plus simple. Pour une application Vite, Webpack ou TypeScript, l’import NPM est plus pratique.
Étape 2 : Choisir un modèle Claude
Puter expose plusieurs modèles Claude avec des identifiants proches de la nomenclature Anthropic.
| ID du modèle | Quand l’utiliser |
|---|---|
claude-opus-4-7 |
Raisonnement profond, agents, revue de code complexe |
claude-opus-4-6 |
Codage robuste, tâches difficiles |
claude-opus-4.6-fast |
Variante Opus orientée latence |
claude-opus-4-5 |
Agents de production, comportement stable |
claude-opus-4-1 |
Version héritée, comportement bien connu |
claude-opus-4 |
Base Opus 4 |
claude-sonnet-4-6 |
Choix par défaut pour la plupart des cas |
claude-sonnet-4-5 |
Bon compromis pour tâches courantes |
claude-sonnet-4 |
Base Sonnet 4 |
claude-haiku-4-5 |
Classification, extraction, réponses rapides |
Point de départ recommandé :
- utilisez
claude-sonnet-4-6pour un assistant généraliste ; - utilisez
claude-haiku-4-5pour des tâches simples et nombreuses ; - utilisez
claude-opus-4-7pour les prompts longs ou complexes.
Étape 3 : Envoyer un premier prompt
Voici l’appel minimal à Claude via Puter :
<!DOCTYPE html>
<html lang="fr">
<body>
<script src="https://js.puter.com/v2/"></script>
<script>
puter.ai.chat(
"Expliquez l'informatique quantique en termes simples",
{ model: "claude-sonnet-4-6" }
).then((response) => {
puter.print(response.message.content[0].text);
});
</script>
</body>
</html>
Ouvrez ce fichier dans un navigateur. Lors de la première exécution, l’utilisateur devra se connecter ou créer un compte Puter. Ensuite, la réponse est affichée dans la page.
La réponse suit une structure proche de l’API Messages d’Anthropic :
response.message.content[0].text
Pour une réponse texte simple, ce champ suffit. Si vous manipulez plusieurs blocs de contenu, itérez sur response.message.content.
for (const block of response.message.content) {
if (block.type === "text") {
console.log(block.text);
}
}
Étape 4 : Activer le streaming
Pour les réponses longues, activez le streaming avec stream: true.
const response = await puter.ai.chat(
"Rédigez un essai détaillé sur l'impact de l'intelligence artificielle sur la société",
{
model: "claude-sonnet-4-6",
stream: true,
}
);
for await (const part of response) {
puter.print(part?.text);
}
Dans une interface de chat, vous pouvez accumuler les fragments dans une bulle de message :
let output = "";
for await (const part of response) {
output += part?.text || "";
document.querySelector("#assistant-message").textContent = output;
}
Cela améliore fortement la perception de vitesse, surtout pour les réponses longues.
Étape 5 : Gérer une conversation multi-tours
Pour conserver le contexte, envoyez un tableau de messages au lieu d’une chaîne simple.
const messages = [
{
role: "user",
content: "Je construis une application Next.js avec Postgres.",
},
{
role: "assistant",
content: "Compris. Avec quoi avez-vous besoin d'aide ?",
},
{
role: "user",
content: "Comment dois-je structurer le dossier de migrations ?",
},
];
const response = await puter.ai.chat(messages, {
model: "claude-opus-4-7",
});
console.log(response.message.content[0].text);
Dans une vraie application, stockez l’historique en mémoire ou dans votre état frontend :
const messages = [];
async function sendMessage(userInput) {
messages.push({
role: "user",
content: userInput,
});
const response = await puter.ai.chat(messages, {
model: "claude-sonnet-4-6",
});
const assistantText = response.message.content[0].text;
messages.push({
role: "assistant",
content: assistantText,
});
return assistantText;
}
Étape 6 : Ajouter une invite système
L’invite système sert à fixer le rôle, le style, les contraintes et le format de sortie.
const messages = [
{
role: "system",
content:
"Vous êtes un ingénieur backend senior. Répondez en français, avec des puces numérotées, sans dépasser cinq points.",
},
{
role: "user",
content:
"Comment puis-je prévenir l'injection SQL dans une application Node.js ?",
},
];
const response = await puter.ai.chat(messages, {
model: "claude-sonnet-4-6",
});
console.log(response.message.content[0].text);
Utilisez ce niveau pour définir :
- le rôle du modèle ;
- le ton de réponse ;
- le format attendu ;
- les contraintes de sécurité ;
- les limites de longueur.
Étape 7 : Comparer plusieurs modèles sur le même prompt
Le bon modèle dépend du cas d’usage. Testez la même invite sur plusieurs modèles et comparez la latence et la qualité.
const models = [
"claude-haiku-4-5",
"claude-sonnet-4-6",
"claude-opus-4-7",
];
const prompt = "Refactorisez ce composant React pour utiliser des hooks : ...";
for (const model of models) {
const start = performance.now();
const response = await puter.ai.chat(prompt, { model });
const elapsed = performance.now() - start;
console.log(`${model}: ${elapsed.toFixed(0)}ms`);
console.log(response.message.content[0].text);
console.log("---");
}
En pratique :
- Haiku convient aux tâches rapides et répétitives ;
- Sonnet est souvent le meilleur choix par défaut ;
- Opus est utile lorsque la qualité prime sur la latence.
Pour comparer Puter avec l’API officielle d’Anthropic dans Apidog, gardez deux environnements dans la même collection : un pour votre prototype Puter, un pour l’API Anthropic.
Ce que vous obtenez, et ce que vous n’obtenez pas
Puter.js simplifie fortement l’accès à Claude côté navigateur, mais ce n’est pas un remplacement complet de l’API officielle.
Vous obtenez :
- accès aux modèles Claude listés par Puter ;
- conversations multi-tours ;
- invites système ;
- réponses en streaming ;
- intégration sans backend ;
- absence de clé Anthropic côté développeur.
Vous pourriez ne pas obtenir, selon la version de Puter :
- l’utilisation native d’outils ou le function calling avancé ;
- l’entrée multimodale avec images ;
- les optimisations de coût liées au prompt caching Anthropic ;
- l’usage proprement côté serveur ;
- l’accès direct aux en-têtes et limites de débit Anthropic.
Pour des workflows avancés avec outils, MCP ou appels serveur, utilisez plutôt l’API officielle ou le test de serveur MCP dans Apidog.
Quand utiliser Puter
Utilisez Puter lorsque :
- vous construisez un prototype frontend ;
- vous voulez tester Claude sans gérer de clé API ;
- votre application peut fonctionner dans le navigateur ;
- vos utilisateurs acceptent de se connecter à Puter ;
- vous développez un site statique, un projet personnel ou une démo de hackathon.
Exemples adaptés :
- chatbot public ;
- assistant de documentation ;
- générateur de contenu ;
- outil de reformulation ;
- assistant de codage côté navigateur ;
- démo interactive intégrée dans une page.
Quand utiliser l’API officielle d’Anthropic
Préférez l’API officielle lorsque :
- vous avez besoin d’appels backend ;
- vous exécutez des tâches cron ou du batch ;
- vous avez besoin de prompt caching ;
- vous utilisez des outils avancés ou des fichiers ;
- vous avez des contraintes contractuelles ou de conformité ;
- vous ne voulez pas imposer une connexion Puter à vos utilisateurs.
La migration reste raisonnable, car la structure des messages est proche :
[
{ role: "system", content: "..." },
{ role: "user", content: "..." },
{ role: "assistant", content: "..." }
]
Pour l’équivalent GPT, consultez Comment utiliser l’API GPT-5.5.
Tester l’intégration dans Apidog
Les appels Puter se font dans le navigateur, donc vous ne pouvez pas les exécuter directement comme un test backend classique. Une approche simple consiste à séparer prototype navigateur et API cible.
Plan recommandé :
- Créez une petite page statique avec Puter.js.
- Ajoutez un paramètre de requête pour injecter le prompt.
- Testez l’équivalent Anthropic officiel dans Apidog.
- Gardez deux environnements dans la même collection :
-
puter-prototypepour votre page locale ; -
anthropic-prodpourhttps://api.anthropic.com/v1.
-
Téléchargez Apidog, puis configurez deux environnements :
puter-prototype = http://localhost:5173
anthropic-prod = https://api.anthropic.com/v1
Cela vous permet de prototyper rapidement avec Puter, puis de valider une migration vers l’API officielle lorsque votre cas d’usage l’exige.
FAQ
Est-ce vraiment illimité côté développeur ?
Oui, dans le sens où vous ne portez pas la consommation API sur votre propre compte Anthropic. L’utilisateur final utilise son compte Puter.
Dois-je créer un compte Anthropic ?
Non. Avec Puter.js, vous n’avez pas besoin de clé Anthropic dans votre application.
Puis-je l’utiliser en production ?
Oui pour une application navigateur, si le parcours utilisateur avec connexion Puter est acceptable.
Le comportement est-il identique à l’API officielle ?
Le modèle appelé est Claude, mais l’interface Puter peut exposer un sous-ensemble des capacités de l’API officielle. Vérifiez la documentation Puter pour les fonctionnalités avancées.
Puis-je utiliser Puter dans un backend Node.js ?
Pas proprement pour un service serveur classique. Puter est orienté session utilisateur dans le navigateur. Pour un backend, utilisez l’API officielle d’Anthropic.
Quel modèle utiliser par défaut ?
Commencez avec claude-sonnet-4-6. Passez à claude-opus-4-7 pour les tâches complexes et à claude-haiku-4-5 pour les tâches simples et rapides.
Mes utilisateurs seront-ils facturés ?
L’usage est associé au compte Puter de l’utilisateur. Les nouveaux comptes disposent d’un crédit de démarrage ; au-delà, l’utilisateur peut recharger selon ses besoins.
Conclusion
Puter.js est une option pratique pour intégrer Claude dans une application navigateur sans gérer de clé Anthropic ni facturation côté développeur. L’intégration minimale tient en trois étapes : ajouter le script, choisir un modèle, appeler puter.ai.chat.
Pour un prototype, un site statique, un projet personnel ou une démo publique, c’est souvent suffisant. Pour les workloads serveur, le prompt caching, les outils avancés ou les contraintes de conformité, l’API officielle d’Anthropic reste le bon choix.
Créez vos scénarios de test dans Apidog, comparez Puter et l’API officielle, puis choisissez l’approche adaptée à votre architecture.

Top comments (0)