Home
cd ../playbooks
ProductivityBeginner

Non-Technical Claude Code Onboarding

A four-step setup guide and decision framework for non-technical professionals moving from the Claude web app to Claude Code — with real workflow examples from expense reports to marketing content generation.

15 minutes
By EverySource
#getting-started#non-technical#onboarding#claude-code-basics#terminal#slash-commands#beginner

You've hit the file size limit in the web chat app three times this month, but 'just use the terminal' sounds like something for engineers, not for someone whose job is writing expense reports and marketing copy.

Who it's for: non-technical professionals hearing about Claude Code for the first time, marketing and content teams hitting file size or context limits in the web app, customer support and success teams wanting to answer technical questions without pulling in engineers, operations and finance staff processing large spreadsheets, anyone deciding whether the terminal version is actually worth the switch

Example

"I keep hitting upload limits with my spreadsheets in the Claude app" → An explanation of why Claude Code removes that limit entirely, a four-step setup (install, open terminal, type 'claude', run a first simple prompt), and a concrete first task — pointing Claude Code at a Downloads folder to build an interactive expense report from raw credit card CSVs in under 20 minutes

CLAUDE.md Template

New here? 3-minute setup guide → | Already set up? Copy the template below.

Or install from your terminal:
npx ccplaybooks add non-technical-claude-code-onboarding
# Non-Technical Claude Code Onboarding

## Your Role

You're helping a non-technical professional get real value from Claude Code — not the cloud chat app, the terminal version. Your job across this onboarding: explain when the terminal version actually helps over the web app, get them set up in four steps, walk them through a first real task using their own files, and teach the habits (file organization, slash commands) that make it useful long-term rather than a one-off experiment.

Assume no programming background. Explain terminal concepts plainly, and never assume familiarity with anything beyond opening an application.

---

## Why the Terminal Version, Not the Cloud App

Get new playbooks like this one

One email a week with new Claude Code workflows. Free, like everything here.

No spam. Unsubscribe anytime.

README.md

What This Does

A genuine on-ramp for someone who has never opened a terminal, walking through exactly when Claude Code beats the familiar web chat app, how to get it installed and running in four steps, and what a first real task should look like — plus real workflow examples (expense reports, large-dataset analysis, codebase-grounded support answers, marketing content generation) to show what becomes possible once the basic setup is done.


Quick Start

Step 1: Create a Project Folder

mkdir my-first-claude-code-project && cd my-first-claude-code-project

Step 2: Download the Template

Click Download above, then:

mv ~/Downloads/CLAUDE.md ./

Step 3: Start the Onboarding

claude

Then say: "I'm new to Claude Code — help me get set up and try a first task"


When to Use Claude Code vs. the Web App

Use Claude Code (terminal) when... Stick with the web app when...
A file size limit is blocking the task It's a straightforward single-chat question
The project needs a long, focused session This is someone's very first AI experience
Working with multiple large spreadsheets File size was never actually a problem
Automating something repeated regularly A polished no-setup interface matters more

Real Workflow Examples

Workflow What it does
Expense reporting Point at a folder of downloaded transactions, get an interactive categorized web report in 10-20 minutes
Large dataset analysis Analyze a CSV too big for the web app to handle smoothly — just point at the file
Support research Answer technical product questions directly from the codebase, without pulling in an engineer
Marketing content Custom slash commands that turn recent product changes into newsletter-ready copy

Tips & Best Practices

  • Start Claude Code inside a specific project folder, not the computer's root directory. Launching from a dedicated folder scopes what's visible to what's relevant — starting from the root grants access to the entire computer, which is rarely necessary and worth avoiding for both focus and privacy.
  • Open with something small and concrete, not an ambitious first project. A prompt like "find my expense CSV in Downloads and tell me what's inside" proves the setup works and calibrates expectations before attempting anything bigger.
  • Turn repeated tasks into saved slash commands. Once a prompt gets reused — a support-answer template, a marketing-copy generator — save it as a file in .claude/commands/ and invoke it by name instead of retyping the instructions every time.
  • This isn't a code-completion tool. Unlike Cursor, which assists someone already writing code, Claude Code writes code (or completes tasks) from plain-English descriptions — the mental model is delegation, not autocomplete.
  • Watch what's consuming context if sessions start feeling sluggish. Some connected tools are heavier on the context window than others — check integrations before assuming the task itself is too large.

Limitations

  • Requires a few minutes of terminal comfort — genuinely simpler than it looks from the outside, but not literally zero setup
  • The context window, while much larger than the web app's, is still finite — very long sessions can eventually lose the thread
  • File organization directly affects both performance and privacy, since it determines what Claude Code can actually see
  • Best suited for someone who already has a specific recurring task in mind — pure open-ended exploration works better in the web app first

$Related Playbooks

Productivity

Notion Automation

Notion database automation - sync, templates, workflows, and cross-platform integrations

10 minutes
Advanced
Productivity

PDF Creator

Convert markdown to professional PDFs with proper Chinese font support, a theme system, and mandatory visual self-check — handling CJK typography and Chrome header/footer suppression that manual pandoc misses.

10 minutes
Beginner
Productivity

PDF to Readable HTML

Convert a PDF into one self-contained, readable HTML file that preserves images, tables, charts, and reading order — optionally translating it while keeping every figure intact.

10 minutes
Intermediate
Productivity

Region Config

Configure regional settings.

15 minutes
Intermediate
Productivity

Reusable Prompt Formatter

Convert informal requests into clean, structured prompts you can use anywhere — Claude Code, Claude.ai, ChatGPT, or other AI tools.

5 minutes
Beginner
Productivity

Personal Assistant

Transform Claude into a context-aware productivity tool with persistent memory for schedule management, task tracking, reminders, and habit monitoring.

10 minutes
Beginner
Productivity

Personal CRM from Meeting Transcripts

Transform meeting recordings and notes into a searchable relationship database with contact insights and follow-up reminders.

10 minutes
Intermediate
Productivity

Personal Dashboard Builder

Create a personalized daily dashboard aggregating calendar, tasks, weather, and goals in one view.

10 minutes
Intermediate
Productivity

Processize Before You Productize

Turn any product idea into a manual process you can deliver today — before writing a line of code. Document the 'magic piece of paper,' charge for it, then automate only what you've proven works.

10 minutes
Beginner
Productivity

HTML Presentation Builder

Create clean, structured HTML presentations with speaker notes that can be presented directly or exported to PowerPoint.

5 minutes
Beginner
Productivity

Search Knowledge

Search stored brand knowledge.

15 minutes
Intermediate
Productivity

Sop Library

Manage agency SOPs.

15 minutes
Intermediate

Browse all Productivity playbooks →