I am writing a beginner's setup page for people with minimal programm…

← back to session · subagent transcript, not indexed

2026-09-02

User:

I am writing a beginner's setup page for people with minimal programming experience who want to use Claude Code to write a novel. Please give me accurate, current facts (with source URLs) on:

  1. How to install the Claude Code CLI on macOS, Windows and Linux: the recommended install command(s) today (native installer script, Homebrew, npm, winget etc.), and which is recommended for non-programmers.
  2. The Claude Code desktop app: what platforms it is on, how to get it, whether it needs the terminal at all, whether it includes git handling or a way to open a project folder, and how it differs in practice from the CLI for a non-programmer.
  3. What account/subscription is needed (Pro, Max tiers; API key alternative), and roughly what the plan names are and how usage limits work at a high level. Don't quote prices unless you are confident they are current.
  4. How a beginner runs claude in a folder, what /init does, how CLAUDE.md works, and how to resume a previous session.
  5. Whether git needs to be installed separately on each platform and the minimal way to install it (Xcode command line tools on Mac, Git for Windows, etc.), and whether Claude Code can initialise and commit to a repo on the user's behalf if asked.
  6. Anything a non-programmer commonly gets stuck on in the first hour (permissions prompts, permission modes, the terminal itself).

Return a compact factual brief, about 600 words, with URLs. Flag anything you are unsure of rather than guessing.

I'll fetch the official Claude Code documentation to give you accurate, current information.

18 tool calls

🔧 WebFetch: https://code.claude.com/docs/en/claude_code_docs_map.md

✅ 44 lines, 1801 chars

🔧 WebFetch: https://code.claude.com/docs/en/setup.md

✅ 685 lines, 31068 chars

🔧 WebFetch: https://code.claude.com/docs/en/quickstart.md

🔧 WebFetch: https://code.claude.com/docs/en/authentication.md

✅ 260 lines, 28454 chars

✅ 357 lines, 13340 chars

🔧 WebFetch: https://code.claude.com/docs/en/desktop-quickstart.md

✅ 143 lines, 11629 chars

🔧 WebFetch: https://code.claude.com/docs/en/overview.md

✅ 246 lines, 16619 chars

🔧 WebFetch: https://code.claude.com/docs/en/memory.md

✅ 474 lines, 37273 chars

🔧 WebFetch: https://code.claude.com/docs/en/permission-modes.md

✅ 24 lines, 2090 chars

🔧 Read redacted: private

✅ 150 lines, 23059 chars

I have gathered comprehensive, current information from the official Claude Code documentation. Here's an accurate brief for your beginners guide:

Claude Code Setup for Novel Writers: A Beginner's Factual Brief

1. Installation (Recommended for Non-Programmers)

Best option for non-programmers: Desktop app (no terminal required)

Native installer (also recommended for CLI):

Sources: https://code.claude.com/docs/en/setup.md, https://code.claude.com/docs/en/overview.md

2. Desktop App vs CLI

The desktop app is purpose-built for non-programmers: no terminal needed, drag-and-drop layout with file browser, visual diff review, and a built-in file browser to open project folders. The CLI is more powerful for advanced users but requires terminal comfort. Both share the same underlying engine and work identically for creative writing tasks.

Platforms: macOS, Windows (x64 + ARM64), and Ubuntu/Debian (beta). Download at https://claude.ai/code or through your app store.

Git handling: The desktop app includes built-in git support—Claude can commit changes, create branches, and open PRs if you ask it to.

Sources: https://code.claude.com/docs/en/desktop-quickstart.md

3. Account Requirements

Claude Code requires:

Free Claude.ai does not include Claude Code access. Pricing and tier details at https://claude.com/pricing (not quoted here as prices change frequently).

Sources: https://code.claude.com/docs/en/setup.md, https://code.claude.com/docs/en/authentication.md

4. Getting Started

Running Claude:

cd /path/to/your/novel/project
claude

/init command: Generates a CLAUDE.md file automatically by analyzing your project structure. This file tells Claude your project conventions, build commands, and guidelines—it loads into every session.

CLAUDE.md: A markdown file you create or edit to give Claude persistent instructions (e.g., "my character names," "tone should be literary fiction," "chapters go in /chapters/"). Lives in your project root; survives across sessions. Run /memory in a session to view and edit it.

Resuming sessions: Type /resume to pick up a previous conversation, or claude -c to continue the most recent session in the current directory.

Sources: https://code.claude.com/docs/en/memory.md, https://code.claude.com/docs/en/quickstart.md

5. Git Requirements

Git installation (separate):

Claude's git handling: Claude can initialise a repo (git init), stage files, commit with messages, and create branches—all conversationally. You don't need to know git commands; just ask "commit my changes with a message about this revision."

Sources: https://code.claude.com/docs/en/setup.md, https://code.claude.com/docs/en/quickstart.md

6. Common Beginner Friction Points

Permission prompts (Manual mode): When you first start, Claude may ask approval before editing files or running commands. On Pro/Max (default auto mode), a background classifier approves safe actions instead—fewer prompts. Press Shift+Tab to toggle modes anytime.

Permission modes:

Non-programmers typically prefer Auto (fewer decisions) or Plan (review-before-edit). Flag: --permission-mode auto

Terminal anxiety: Use the desktop app to avoid the terminal entirely, or ask Claude questions in plain English—it understands "what does this project do?" and "add a function that does X."

Sources: https://code.claude.com/docs/en/permission-modes.md, https://code.claude.com/docs/en/quickstart.md

Flags I'm uncertain about: Price tier names may have shifted since documentation was published. Desktop app Linux beta status—check https://claude.ai/code for current platform availability.