Learning Debian with Claude

▶
Sub-series

Server Edition — A server at home or on a VPS, your data in your own hands — own your infrastructure with Claude

The sequel to the desktop series. The premise: a home server or a VPS, with your data managed by you — apps and data live on a machine where you hold root, in your own databases. Drive a screenless Debian over SSH, harden it, run databases and your own apps, publish them, and protect your data — 11 chapters in the domain where learning with Claude works best.
Sub-series — open all chapters →

00

Learning Debian with Claude — Prologue — What "learning with Claude" means. Why this approach. What you can expect.

A new kind of textbook you read with Claude beside you. Not a one-way "book that teaches," but a dialogue-based way of learning where the answer changes according to your own situation. The prologue lays out why this approach was chosen and what you can expect.

01

Chapter 1 — What You Lose, What You Gain — Before deciding to wipe Windows, take stock together with Claude

Before you migrate to Debian and wipe Windows, take stock with Claude of what you lose and what you gain. Not in the abstract, but a concrete accounting tied to your own work, software, and habits.

02

Chapter 2 — How to Begin a Dialogue with Claude — The shape of a good question, examples of bad ones, and how to break out of stalled dialogue

The basic craft of using Claude as a learning partner. The difference between vague and specific questions, how to hand over context, how to press further, and how to spot mistakes. Before learning Debian, this chapter lays out the techniques of dialogue itself.

03

Chapter 3 — How to Tell Claude About Your Environment — Pulling hardware and software information and handing it to Claude in a structured form

To get sharp answers from Claude, you need to convey your own environment accurately. This chapter covers how to extract environment information on Windows / macOS / Linux, how to pick what to send out of that output, and how to shape it into a form Claude can read easily.

04

Chapter 4 — Taking Stock of Dependencies — Before wiping Windows, lay out every connection between data and services

Finish the inventory before you wipe. Browser, mail, authenticator apps, licenses, cloud storage, printers, family-shared things. Together with Claude, build a dependency map and prevent gaps in the migration.

05

Chapter 5 — Understanding the Installation Picture with Claude — Before the steps, understand what is happening

Before launching the installer, work with Claude to grasp the overall picture of the Debian installation process. ISO download, USB creation, boot, partitioning, network, package selection, bootloader — sort out the role and the decisions of each stage in advance.

06

Chapter 6 — Choices That Fit Your Hardware — Desktop environment, filesystem, encryption — decide based on your PC

Choose the desktop environment (GNOME / KDE / Xfce / LXQt), filesystem (ext4 / btrfs / xfs), and encryption method (LUKS) for your specific hardware. Together with Claude, arrive at the best fit given the constraints of your machine and use case.

07

Chapter 7 — The Dialogue of the Install — Watching the screen, checking with Claude as you go

Actually launch the Debian installer and walk through the eight stages in order. What to choose on each screen, and what to ask Claude when you're unsure. The chapter where you put your hands on the keyboard. Read it with the Chapter 6 checklist beside you.

08

Chapter 8 — The First Round of Troubleshooting — Display, Wi-Fi, sound, Bluetooth, suspend — knock down the seven usual suspects with Claude

Resolve the seven categories of trouble most commonly hit right after install — display resolution / scaling, Wi-Fi, Bluetooth, sound, suspend, Japanese input, external monitor — step by step with Claude. Learn how to capture and hand over logs.

09

Chapter 9 — Tuning the Desktop Environment (a Claude Dialogue Example) — Re-evaluate the DE you tentatively chose in Chapter 6 — after actually using it

After actually using Debian for a while, re-evaluate the desktop environment. Workflow, shortcuts, screen layout, theme — the steps for tuning it to fit you, and the craft of deciding to switch to another DE if it doesn't.

10

Chapter 10 — Setting Up Japanese Input — Polish Fcitx5 + Mozc into something you can use every day

Don't compromise on Japanese input — you use it hundreds of times a day. Together with Claude, finish off the basic Fcitx5 + Mozc configuration, the user dictionary, key bindings, app-specific behavior, emoji and symbol input, and predictive-conversion tuning.

11

Chapter 11 — Choosing Applications — What to replace your Windows apps with on Debian

Browser, mail, office, image / video, communication, file sync, password management — replace Windows apps with Debian apps category by category. Together with Claude, make the choices that fit your use.

12

Chapter 12 — Understanding and Managing Configuration — Track dotfiles and apt with Git

Debian's configuration files are all open text. Manage them with Git and your environment becomes a reproducible document. Together with Claude, design dotfiles, an apt package list, and an auto-restore script.

13

Chapter 13 — Building the Development Tools — Terminal, shell, editor, Git — the toolkit of a builder

Lay the foundation for development on Debian. Terminal emulator, shell (bash / zsh / fish), editor (Zed / Neovim / PyCharm Community), Git, SSH keys. Together with Claude, decide on a toolkit that fits your workflow.

14

Chapter 14 — Implementing the Widget Architecture — Build your own app from small, reusable parts

Learn the Widget architecture — designing apps as a composition of small independent parts — together with Claude. Take a small clock app as the subject and implement Widget decomposition, state management, layout, and reuse.

15

Chapter 15 — Development with Claude in Practice — Grow a small app into something connected to real data and worth using every day

Connect the Chapter 14 dashboard to real data, write tests, handle errors, and make it distributable. Use Claude Code to walk the lap from "it just runs" to "an app you can use."

16

Chapter 16 — Python, Flutter, and Other Environments — When you need a language, build it up with Claude

Python on `uv` as the main line, miniforge alongside for data science and ML. GUI via Flutter/Dart; Rust narrowed to speeding up Python hot spots (PyO3). Other choices (web, CLI) live as a map for when you need them. Working alongside Claude on Debian.

17

Chapter 17 — Updates and Maintenance — Keep the system up to date without disrupting daily life

Debian's update philosophy, safe procedures, disk cleanup, reading logs. The monthly and yearly maintenance rhythm, and preparing for major upgrades (Debian 13 → 14). Together with Claude, keep your environment in long-term shape.

18

Chapter 18 — When Things Break — Won't boot, no screen, an app won't run — recover step by step

When Debian won't boot, you can't log in, the screen is black, an app crashes — work through these crises with Claude in graduated stages. Practical use of recovery mode, a rescue USB, and chroot recovery.

19

Chapter 19 — Growing Your Own Environment — Three months, six months, a year — make it yours, a little at a time

As you keep using Debian, grow your environment. Small automations, optimized key bindings, your own scripts; observe and evolve your "shape of productivity."

20

Chapter 20 — Engaging with the Community — Become a giver, not just a receiver

How to engage with the Debian community. Bug reports, translation, package maintenance, mailing lists, IRC, and the new shape of open-source contribution that Claude is bringing. Start small and keep going.

21

Chapter 21 — Telling Those Around You — Family, friends, colleagues — show the use, don't try to convince

To tell people close to you about Debian, "showing how you use it" works better than persuasion. Tailor the message to family, friends, and colleagues. Use Claude to put together explanations that fit the listener.

22

Chapter 22 — Adoption in an Organization — Change the tools before changing the OS.

A realistic path for adopting Debian on a team or in a company. Before pushing the OS swap, change the tools — Markdown / CSV / Python (uv) / Claude / Element. These work on Windows already. Once the substance moves to structured text, Linux migration becomes a small final step.

23

Chapter 23 — Passing It On to the Next Generation — What you have learned becomes someone else's starting point

The shape of inheritance of learning, in an era of learning together with Claude. To children, to those who follow, to the future you — what to leave, and how. As the textbook's final chapter, look back at what this whole series of learning has cultivated.