Edit this page | Blame

Install and use Claude Code using Guix

At this point Claude Code appears to be the best terminal client for AI-aided programming. This is likely a temporary state of affairs. We run Claude code inside a Linux container so it can't touch the rest of the system.

You can install and run Claude as a binary blob inside a Guix container.

Note that while the source code is available, but neither Claude nor Claude code are free software. So don't make it a software deployment dependency.

The shell prompt looks like:

mkdir workdir && cd workdir
mkdir -p $HOME/.local $HOME/.cache/claude $HOME/.claude
guix shell -C -N -F curl bash openssl nss-certs tmux coreutils grep sed jq git which gawk --share=$HOME/.local --share=$HOME/.cache/claude --share=$HOME/.claude --share=/gnu/store --share=/usr/local/guix-profiles --share=/var/guix
curl -fvSL https://claude.ai/install.sh | bash

Takes a few minutes.

Note

guix describe
  guix dc0ffec
    repository URL: https://codeberg.org/guix/guix
    commit: dc0ffec8daa45ed240f62912115e233be82a35fa

The installation is self contained. You probably want to make a guix manifest to run Claude inside some source directory. Set the path and run claude from ~/.local/bin/claude.

. /usr/local/guix-profiles/guix-dc0ffec/etc/profile
export PATH=$PATH:$HOME/.local/bin
export TERM=xterm
tmux
claude --dangerously-skip-permissions

The key gets written to ~/.claude.json. I simply copy that to capture state. Don't add it to git though.

See also

(made with skribilo)