ع
Start Topics Teams Reference What's new Saved
Core

What Claude Code is (and how to start)

What is Claude Code and how do I actually start using it?

Short answer

Claude Code is an AI assistant that works on your actual files instead of just talking about them. You download the Desktop app, open a folder, and ask in plain English. It proposes changes, and you review each one and accept or reject it.

The name is the first hurdle, so let’s clear it: the “Code” describes where the tool came from, not who it is for. What Claude Code actually does is open the files on your computer, do work inside them, and show you what it changed. Spreadsheets, research folders, documents, drafts — all of that counts. Developers got it first; nothing about it is only for them.

The way you meet it is a normal app. You download Claude Code Desktop, sign in, and drag a folder onto it. On one side is a chat; on the other is the file pane, showing what Claude is reading and editing as it goes. There is nothing to type at a black screen, which is the single biggest reason people who tried this a year ago and gave up should try again.

The guides below run roughly in the order you’d want them. Start with what the thing is, then the step-by-step first session, then a five-day plan for making it a habit rather than a novelty — and once it is a habit, the workflows piece is where most of the compounding happens. Two of them are comparisons, because “how is this different from ChatGPT?” and “how is this different from Cursor or Copilot?” are the two questions that most often block a decision.

The commands listed further down split into two kinds. A handful you type straight into the chat to manage your account and your setup — /login, /status, /config, and /doctor when something is misbehaving. The other two, claude and claude update, are terminal commands: the Power-Track way in and out, useful to recognise but not something you need on day one. If you’re wondering whether you’ll be pushed toward that terminal eventually, the app vs the command line answers it directly.

It builds you tools, not just edits

The part that surprises people who don’t write software is that Claude doesn’t only change the files in a folder — it can write a small program to work on them, and build you something to look at the result in.

You never see the program. You describe the outcome in the chat, Claude proposes the work, you approve it, and what lands in the folder is the thing you actually wanted:

  • 300 photos named DSC_0001.jpg, DSC_0002.jpg… → “rename these by the date each was taken.”
  • A sales.csv you can’t make sense of → “turn this into a bar chart I can open in my browser.”
  • A folder of 40 PDF invoices → “pull the total from each one into a single table.”

None of those are coding tasks. They’re your own files plus a sentence — and each one is the kind of job that was previously either an afternoon of manual work or a request to someone technical who had better things to do. The output is a real file sitting in a real folder: if the chart is sorted wrong you say so in the chat and it gets redone, the same as any other edit.

Two habits are worth picking up in the first hour, and both have their own pages: reviewing what it changed before you accept anything, and understanding the permission prompts rather than clicking through them. Everything else you can learn as you go.

The words

Claude Code Desktop the Desktop app · Claude Code (GUI) · the app
Claude Code Desktop is the app you download and open on your Mac or Windows machine to work with Claude — the same engine as the command-line tool, but with a real interface instead of a terminal. You chat with Claude in a panel, watch it propose changes, and click to accept or reject them. No terminal, nothing to type at a black screen — the quickstart's first promise is literally "no terminal required."
File pane file viewer · file panel
The file pane is the part of Claude Code Desktop that shows your project's files — the list on the side and the file you're currently looking at. You open a file by clicking it, read it right there, and make edits without ever typing cat or grep in a terminal. It's where you watch what Claude is reading and changing as it works.

Commonly confused with

Two things people mix up here, and the difference that actually matters.

Read more

How to do it

What you want On Desktop (no code) Command line (Power Track)
Open a folder to work in Drag it onto Claude, or File → Open cd ~/folder
  • claude Start Claude Code in your current folder (the terminal / Power-Track way in).
  • claude update Update Claude Code to the latest version.
  • /login Sign in, or switch which account Claude Code uses.
  • /logout Sign out of your Anthropic account in Claude Code.
  • /status Show version, account, and your current setup at a glance.
  • /doctor Run a health check on your Claude Code install, version, and config to find what's wrong.
  • /config Open Claude Code settings — theme, model, permissions, and more.
  • /bug Report a problem with Claude Code to Anthropic, with context attached.

Questions people ask

It's called Claude *Code*. Is it useful if I don't write software?
Yes — the 'Code' describes where the tool came from, not who it's for. What it actually works on is a folder of files, and the files can be anything: spreadsheets, PDFs, research notes, drafts, a messy Downloads folder. Renaming 300 photos by their capture date and refactoring a codebase are the same shape of job to it.
Do I need to open a terminal to use Claude Code?
Usually not. Claude Code Desktop is a normal app: you download it, sign in, and drag a folder onto it — chat on one side, the files Claude is reading and editing on the other. It runs on macOS, Windows, and — in beta since June 2026 — Ubuntu 22.04+ and Debian 12+. The terminal is an optional Power Track, and the required path only on the Linux distributions that beta doesn't cover.
What two habits should I pick up in the first hour?
Read the diff before you accept it, and read the permission prompts instead of clicking through them. Both take seconds and both are the difference between supervising a capable assistant and hoping. Everything else on this site you can pick up as you go.