I let Claude customize my Linux PC—and it did a better job than I ever could

I've always loved how much freedom Linux gives you to customize your desktop. I've spent years ricing GNOME and KDE Plasma , but I've always avoided window managers (WM) like i3 and Hyprland . Without a graphical interface, customization feels more like programming than personalizing your desktop. I recently decided to give WMs a try, but building a polished setup would easily consume an entire Saturday for me. That's when I had an idea: what if I let Claude do the heavy lifting? The result wasn't just dramatically faster—it looked better than almost anything I'd built myself.

Claude is perfect for Linux customization

An AI that can actually read and write your config files

The unique thing about customizing your Linux desktop is that almost everything is defined by plain-text configuration files . Your window manager's keybindings, your status bar, your terminal colors, your fonts, and even your wallpaper behavior are all controlled by files in your home directory. Change a config, reload the application, and the desktop updates instantly.

That's exactly the kind of workflow AI agents excel at. Claude Code runs inside your terminal and can inspect your existing configuration, edit files, and execute commands to verify its own changes. When I ask it to recreate a desktop from a screenshot, it first checks my distribution, identifies what's already installed, reads my Hyprland configuration, and then starts making incremental edits. Within seconds, I can watch my desktop gradually transform as each component reloads.

However, what I found most useful wasn't the file editing—it was the research. When I rice my desktop manually, half the time goes into identifying what's actually in a screenshot. Is that Waybar or Eww? Which Nerd Font are they using? What color scheme are they using? Claude identifies those components in seconds, checks whether they're available for my distribution, and tells me whether the setup is worth recreating in the first place.

This requires Claude Code, the terminal version of Claude, not the claude.ai website. If you don't have a Claude subscription, ChatGPT CLI or Google's Antigravity CLI work too. The important part is giving the LLM access to your local Linux file system. Also, use the most capable model you can, since better reasoning generally leads to fewer configuration errors.

How I set up Claude to customize my Linux PC

A four phase process that stands between you and chaos

You could simply open Claude Code and type, "Make my desktop look like this image." It would probably work. But it could also install packages without asking, modify configuration files without creating backups, and leave you with no record of what changed. Using a well-defined prompt is what separates a reckless run from one that behaves like a careful sysadmin. As such, I wrote a prompt that enforces a structured workflow.

The prompt breaks the job into four phases, with a hard stop between each one.

• Phase 1 is a read-only audit. Claude identifies your Linux distribution, window manager, display server, and existing configuration files without modifying anything.

• Phase 2 is the planning stage. It analyzes the reference image, lists every package it wants to install with an explanation for each one, and waits for your approval.

• Phase 3 is preparation. This is my favorite part. Instead of letting Claude execute sudo commands, it writes every privileged command into a single script called claude-setup.sh, with a comment above each one explaining exactly what it does. You can review the script and run it yourself if everything checks out. This way, Claude never runs with root privileges. The script also creates a system snapshot before making any changes, giving you a rollback point if something goes wrong.

• Phase 4 is the build. Claude customizes your desktop one component at a time, creating a Git commit after every change so you always have a detailed history.

I've shared it at the end of this article so you can copy it as-is.

All you have to do is open Claude Code in your home directory, paste in the prompt, and describe the setup you want. You can provide a screenshot or simply describe the look you're after and let Claude figure out the implementation.

I tested this workflow on an Ubuntu virtual machine, asking Claude Code to install and configure i3 based on its own research and aesthetic judgment. The entire process took a little over an hour, consumed roughly 290,000 Claude 3 Opus tokens, and produced a fully functional i3 desktop with almost every component working as intended. Building something similar manually would have easily taken me an entire afternoon.

How to ensure Claude doesn't mess up anything

A little vigilance goes a long way

The idea of letting an AI run commands on your PC for an hour should make you a little uneasy—and that's a good thing. What if it installs a compromised package, opens an unnecessary port, or breaks part of your existing setup just to recreate a desktop? The best way to prevent that is to review the commands Claude proposes and avoid letting it run unattended.

Granted, this can feel torturously boring. As such, if you'd rather let Claude work unattended while also minimizing the risk, I recommend spinning up your Linux distribution in a virtual machine first. Let Claude Code make all of its changes there, inspect the configuration files it creates, and only copy them over to your main system once you're satisfied with the results.

I also designed my prompt to keep a running log at ~/claude-rice-log.md. Every action is timestamped, along with the files Claude modified and a brief explanation of why it made each change. Even after the process finishes, you can review the log to understand exactly what happened during the automated ricing session.

---

Claude has made Linux a lot more accessible

Claude, and LLMs in general, have made Linux more accessible than ever before. Linux has no shortage of documentation, but much of it assumes prior knowledge or expects you to piece together information from multiple sources. But now, instead of you jumping between forum posts, GitHub repositories, and wikis, you can ask an LLM to explain unfamiliar concepts, adapt instructions to your setup, and even automate repetitive configuration tasks.

Now, if you'd like to try this workflow yourself, here's the Claude Code prompt I used to customize my Linux PC.