claude2nix

Nix package, NixOS module, and Home Manager module for Anthropic Claude Desktop on Linux.

Quick start

Flake overlay (ad-hoc)

{
  inputs.claude2nix.url = "github:b7r6/nix-claude-desktop";

  outputs = { nixpkgs, claude2nix, ... }: {
    # Use the overlay to get pkgs.claude-desktop
    nixosConfigurations.myhost = nixpkgs.lib.nixosSystem {
      modules = [
        { nixpkgs.overlays = [ claude2nix.overlays.default ]; }
      ];
    };
  };
}

NixOS module

{
  imports = [ claude2nix.nixosModules.default ];

  programs.claude-desktop = {
    enable = true;
    cowork.enable = true;   # QEMU + OVMF + virtiofsd (default)
  };
}

Home Manager module

{
  imports = [ claude2nix.homeManagerModules.default ];

  programs.claude-desktop = {
    enable = true;
    cowork.enable = false;  # skip VM deps (default for HM)
  };
}

Minimal closure (no Cowork VM deps)

nix build .#claude-desktop-minimal

Updating the version

1. Check the Packages index for the current version.
2. Update version in nix/pkgs/claude-desktop.nix.
3. Set both hashes to lib.fakeHash, build, and replace with the correct SRI hashes.

Tests

nix build .#checks.x86_64-linux.nixos-test -L
nix build .#checks.x86_64-linux.nixos-test-no-cowork -L

License

MIT