claude-api : brancher Claude via le SDK officiel, d'abord éviter les paramètres abandonnés

À qui ça s'adresse

claude-api s'adresse à qui, dans une invite, nomme Claude ou Anthropic et a besoin d'une référence sur modèles, paramètres, flux, outils ou cache. C'est une référence Claude API / Anthropic SDK, pas un autre installeur. Quand une invite nomme Claude/Anthropic sous n'importe quelle forme, lisez d'abord ce guide ; ne le sautez pas parce que « ça ressemble à une phrase ».

L'usage le plus juste : vous ajoutez ou changez un appel Claude dans un projet existant, et la langue du projet a déjà un SDK Anthropic officiel. Le guide exige : pour implémenter une fonction Claude, il faut appeler via le SDK officiel de cette langue. Il ne convient pas à qui veut seulement inventer du pseudo-code sans SDK précisé, ou traiter le chemin de page comme une commande d'installation.

Le modèle par défaut est écrit Claude Opus 5 ; la chaîne exacte est claude-opus-5. Les requêtes un peu complexes utilisent par défaut adaptive thinking. Le guide ne donne aucune commande d'installation. Si l'assistant courant ne peut pas encore changer le code d'après cette référence, le guide existant s'arrête ici ; n'inversez pas un répertoire de skill depuis l'adresse.

Premier essai en 3 minutes

Le premier chemin officiel est de vérifier ou changer un appel d'après la référence, pas d'installer. La page du guide est

https://raw.githubusercontent.com/anthropics/skills/main/skills/claude-api/SKILL.md

Suivez uniquement les contraintes de cette page. N'écrivez pas une phrase d'installation absente, et ne mettez pas de substituts de secret dans le code.

Prérequis : l'assistant courant peut déjà travailler comme claude-api, vous avez un extrait d'appel jetable ou une fonction vide, et cette machine a déjà le SDK Anthropic officiel de cette langue. Il n'y a pas de commande d'installation, donc l'« emplacement » est ce code de projet, pas un répertoire de skill deviné.

Première tâche à bas risque : d'abord un contrôle en lecture seule. Faire regarder si l'appel existant passe par le SDK officiel, si le modèle est claude-opus-5, si thinking est adaptive, et s'il y a un budget_tokens abandonné. Ne pas d'abord envoyer une longue requête à un vrai compte. Signal de succès : l'assistant signale tout écart parmi ces quatre points et s'arrête pour confirmation avant de changer le code.

S'il faut changer, ne changer que la chaîne du modèle et la forme de thinking : thinking: {type: "adaptive"}. Le guide dit que sur Claude 4.6+ budget_tokens est abandonné, et sur Opus 4.6 / Sonnet 4.6 il est refusé et renvoie 400. Face à une invite d'écriture, confirmer d'abord qu'aucun secret n'est écrit dans le dépôt.

Cas d'usage

Cas 1 : ajouter une fonction Claude au projet. Si l'invite nomme Claude/Anthropic, lire d'abord la référence. Implémenter via le SDK Anthropic officiel de la langue du projet, modèle claude-opus-5, requêtes un peu complexes par défaut en adaptive thinking. Cela convient quand la langue est déjà choisie et qu'il ne reste qu'à écrire l'appel juste. Les phrases existantes ne déploient que le chemin « SDK officiel » et ne nomment pas d'autres SDK ; ne basculez pas vers un wrapper non nommé. La page de contrôle est

https://raw.githubusercontent.com/anthropics/skills/main/skills/claude-api/SKILL.md

Cas 2 : retirer un ancien paramètre thinking qui renvoie 400. Sur Claude 4.6+ utiliser thinking: {type: "adaptive"} ; budget_tokens est abandonné sur Opus 4.6 / Sonnet 4.6, est refusé et renvoie 400. Cela convient quand vous venez de copier une config thinking d'un vieil exemple et que la requête a renvoyé 400 tout de suite. Changer d'abord uniquement cet endroit, puis décider d'envoyer une vraie requête. Le guide ne liste pas tous les champs abandonnés, donc seulement confirmer cet item budget_tokens.

Limites d'usage

Pas de commande d'installation : ne traitez pas le chemin de page comme un installeur. Limite de déclenchement : si une invite nomme Claude/Anthropic sous n'importe quelle forme, lire d'abord ; ne pas sauter comme une phrase. Limite d'appel : implémenter une fonction doit passer par le SDK Anthropic officiel de la langue du projet ; les phrases existantes ne déploient pas d'autres voies parallèles. Limite de modèle : défaut Claude Opus 5, chaîne claude-opus-5 ; requêtes complexes par défaut en adaptive thinking. Limite de paramètre : budget_tokens renvoie 400 sur les modèles 4.6 nommés. Limite de secrets : n'écrivez pas de substituts de secret ni de secrets dans le code. Cette référence couvre aussi tarifs, flux, outils et sujets proches, mais les phrases existantes n'en donnent pas d'exemples pas à pas.