Installer Claude Code sur FreeBSD 15

Introduction

Cet article documente l'installation de Claude Code sur une VM FreeBSD 15.0-RELEASE. Contrairement aux procédures Alpine et Debian qui s'appuient sur npm et donc sur l'installation préalable de Node.js 18+, FreeBSD propose dans son dépôt officiel un paquet claude-code natif. L'installation se résume alors à un simple pkg install, et Claude Code sera mis à jour comme n'importe quel autre paquet du système. Toutes les commandes s'exécutent depuis une session SSH en tant que root.

(Sur FreeBSD, sudo n'est pas installé par défaut : c'est volontaire, et inutile lorsqu'on opère directement en tant que root. La procédure est donnée dans ce contexte.)

1. Préparation du système

Vérification de la version de FreeBSD et mise à jour du catalogue des dépôts pkg.

freebsd-version
pkg update

(Sur une VM fraîchement installée, pkg peut proposer de se bootstraper la première fois : accepter avec y.)

2. Installation du paquet claude-code

Le paquet est disponible directement dans le dépôt FreeBSD-ports :

pkg search claude
pkg install -y claude-code

(Le paquet embarque le binaire natif : aucun runtime Node.js n'est requis, aucune manipulation de npm globale ni de PATH à prévoir. Les mises à jour passent ensuite par pkg upgrade.)

3. Vérification de l'installation

claude --version
which claude

La commande doit renvoyer une version (à la date de rédaction : claude-code 2.1.89) et un chemin du type /usr/local/bin/claude.

4. Configuration de la clé API

Claude Code s'authentifie en priorité via la variable d'environnement ANTHROPIC_API_KEY. La clé est à récupérer sur console.anthropic.com, section API Keys → Create Key (format sk-ant-...).

4.1 Identifier le shell

Sur FreeBSD 15, le shell par défaut de l'utilisateur root est /bin/sh (POSIX). La syntaxe et le fichier de configuration persistante en découlent.

echo $SHELL

(Si la sortie indique /bin/csh ou /bin/tcsh, remplacer export VAR=... par setenv VAR ... et ~/.profile par ~/.cshrc.)

4.2 Déclarer la clé de façon persistante

Ajout de la variable au profil de root, restriction des droits du fichier, puis rechargement dans la session courante.

echo 'export ANTHROPIC_API_KEY="sk-ant-..."' >> ~/.profile
chmod 600 ~/.profile
. ~/.profile
echo $ANTHROPIC_API_KEY

(La clé est stockée en clair : le chmod 600 en restreint la lecture au seul propriétaire. Ne jamais la versionner dans un dépôt git ni la copier dans un fichier de configuration partagé.)

5. Premier lancement

claude

Au premier démarrage, Claude Code affiche son écran de bienvenue et propose une sélection de thème (clair / sombre / variantes accessibles). Le choix peut être modifié ultérieurement avec la commande /theme à l'intérieur de Claude Code.

La clé API étant déjà présente dans l'environnement, aucune authentification interactive n'est demandée : Claude Code passe directement en mode prompt.

6. Mises à jour

Comme tout paquet géré par pkg, Claude Code se met à jour avec le reste du système :

pkg update
pkg upgrade claude-code

(À la différence des installations npm, il n'y a pas d'auto-updater à gérer ni de risque de divergence entre une version npm globale et une version locale.)

Conclusion

L'existence d'un paquet claude-code natif dans le dépôt FreeBSD rend cette installation nettement plus simple que sur Alpine ou Debian : pas de Node.js, pas de npm -g, pas de configuration de PATH. Trois étapes suffisent — pkg install, déclaration de la clé API dans ~/.profile, premier lancement — et Claude Code est opérationnel sur la VM, intégré au cycle de mise à jour du système.

Pour une utilisation au quotidien : claude dans n'importe quel répertoire de projet, ou claude --help pour découvrir les options en ligne de commande.