From zero terminal knowledge to your first safe Claude Code session
This guide assumes you know nothing about Bash, Git, file paths, or Claude Code. It teaches the minimum real fundamentals, gets the tool installed correctly, and shows how to use it without gambling on blind AI edits.
What this guide actually does
This is not a full programming course and it is not a bag of prompt tricks. It is a bridge. The goal is to move you from "I do not know what Bash or Git are" to "I can install Claude Code, launch it in the right folder, ask for a plan first, review the result, and understand the bigger map of what comes next."
Real machine setup
Install Git, VS Code, and Claude Code using the current recommended path. Learn how to verify that each step actually worked.
Minimum Bash and Git
Understand the handful of commands that make a beginner safe: pwd, ls, cd, git status, git diff, and basic commits.
A first working workflow
Create a throwaway project, start in plan mode, approve a tiny HTML and CSS change, and save the checkpoint with Git.
Claude Code tooling changes over time. Every install and account-access statement in this guide is anchored to April 6, 2026. If you are reading later, verify volatile details against the official Anthropic docs linked in the appendices.
The promise and the limits
You do not need to become a full-time programmer before touching Claude Code. But you do need enough foundations to supervise it. This guide is built around that minimum honest threshold.
Safe first
We start with a practice repo and plan mode before any real file edits.
Plain English first
Every technical term is defined before it becomes part of an instruction.
Map the future
You also get the higher-level orchestration picture, so you know what worktrees, MCP, guardrails, and agent teams are for.
What this guide does not try to do
- It does not replace deeper programming fundamentals.
- It does not teach every Git workflow.
- It does not assume you are ready for advanced multi-agent orchestration on day one.
- It does not ask you to trust AI output blindly.
The three parts
Foundations and Setup
What Claude Code is, what a terminal and shell are, the Bash commands you need first, how Git fits in, and how to install everything correctly on macOS, Linux, Windows, or WSL.
First Project and Safe Workflow
Initialize a practice repo, ask Claude Code for a plan, approve a tiny implementation, review the diff, commit the result, and create your first useful CLAUDE.md.
Big Picture and Orchestration
Understand the larger system around Claude Code: context, permissions, worktrees, MCP, plugins, guardrails, Docker, and how single-session work grows into more advanced orchestration.
Before you start reading Part 1
What to have open
Once this quick-start gets you moving, continue into Zero to Hero Programming for the deeper fundamentals that make you a stronger Claude Code supervisor over time.