Configuring Claude Code with Nix

What problem does it solve?

Manually configuring Claude Code settings, commands, agents, and skills in a Nix-based system can be complex and prone to errors. This skill automates the management of these configurations, ensuring consistency and ease of updates.

Core Features & Use Cases

• Declarative Configuration: Manage Claude Code settings (settings.json), project instructions (CLAUDE.md), custom commands, agents, and skills using Nix Home Manager.
• Instant Updates: Changes to most configuration files (commands, agents, skills) are applied immediately without a full system rebuild.
• Use Case: Quickly add a new custom /refactor command to Claude Code by simply creating a Markdown file, and have it instantly available across your Nix-managed environments.

Quick Start

Add a new command (instant update)

Create a new Markdown file in the commands/ directory:

modules/shared/config/claude/commands/my-new-command.md

Update settings.json (requires rebuild)

Edit modules/shared/config/claude/settings.json

Then run:

make switch-user