Depuis quelques mois, les assistants IA ne sont plus réservés aux plateformes cloud.

Entre les modèles locaux pilotés par Ollama et les outils de développement augmentés comme Claude Code, il devient possible de construire un environnement de travail moderne, reproductible et parfaitement intégré à Nixos.

Le problème, c’est que l’empilement technique devient rapidement fragile :

• une version de Node.js incompatible ;
• un npm global qui casse après une mise à jour ;
• des dépendances qui divergent d’une machine à l’autre ;
• des outils IA installés à moitié dans le système et à moitié dans le home utilisateur.

C’est précisément là que NixOS change complètement l’expérience.

Avec un simple flake.nix, il devient possible de décrire un environnement de développement complet, reproductible et portable.

Dans cet article, nous allons mettre en place :

• Client Ollama pour exécuter des modèles locaux ;
• Claude Code comme assistant de développement ;
• un shell Nix moderne compatible NixOS 25.11.

Le principe : un environnement entièrement déclaratif et reproductif

1

flake.nix

Ce fichier permettra :

• d’installer automatiquement les bons paquets ;
• d’obtenir les mêmes versions sur toutes les machines ;
• d’éviter les conflits entre projets ;
• de reconstruire l’environnement en quelques secondes.

C’est l’un des grands avantages de NixOS : l’environnement devient du code.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31

{
description = "Environnement Ollama + Claude Code";

inputs = {
  nixpkgs.url = "github:NixOS/nixpkgs/nixos-25.11";
  flake-utils.url = "github:numtide/flake-utils";
};

outputs = { self, nixpkgs, flake-utils }:
  flake-utils.lib.eachDefaultSystem (system:
    let
      pkgs = import nixpkgs {
      inherit system;
      config.allowUnfree = true;
    };
  in {
    devShells.default = pkgs.mkShell {
    packages = with pkgs; [
      ollama
      nodejs_24
      claude-code
    ];

    shellHook = ''
      echo "🚀 Environnement Ollama + Claude Code"
      export OLLAMA_HOST="http://localhost:11434"
    '';
    };
  }
 );
}

1

pkgs.nodePackages.npm

1

nodejs_24

Beaucoup de tutoriels recommandent encore :

1

npm install -g @anthropic-ai/claude-code

Techniquement, cela fonctionne, mais dans une logique NixOS, cette approche casse plusieurs principes importants :

• npm va essayer d'écrire dans /nix/store
• l’installation n’est plus déclarative ;
• le binaire dépend du profil utilisateur ;
• les versions deviennent difficiles à reproduire ;
• les mises à jour peuvent casser silencieusement l’environnement.

L’approche ici consiste donc à utiliser directement le paquet :

1

claude-code

Le paquet étant marqué unfree, il faut activer explicitement :

1

config.allowUnfree = true;

Une fois le fichier créé, il suffit d’exécuter :

1

nix develop

Le shell charge automatiquement :

• Ollama ;
• Node.js ;
• Claude Code ;
• les variables d’environnement.

Ollama étant déjà installé avec open-webui pour d'autres usages, il me reste simplement à lancer Claude Code :

1

claude

L’écosystème IA évolue extrêmement vite.

Les dépendances changent constamment. Les versions de Node.js deviennent incompatibles. Les wrappers npm globaux cassent régulièrement.

Avec NixOS, on verrouille complètement l’environnement.

Une fois cette base fonctionnelle, plusieurs extensions deviennent intéressantes :

1

nix flake

1

direnv allow