Claude Code

    Claude Code: The Complete Guide for Builders

    James KillickJames Killick4 Apr 202611 min read
    claude codeai toolsfoundersautomationsoftware development

    TL;DR

    • Claude Code is a terminal-based AI coding agent from Anthropic. It writes, edits, and runs real code in your project.
    • It is not a chatbot. It reads your files, runs commands, and makes changes directly in your codebase.
    • You do not need to be a career engineer to use it. Founders and operators are building production software with it right now.
    • A file called CLAUDE.md acts as your agent's memory. Get that right and it stays on brief across every session.
    • Skills, subagents, and MCP connections let you extend it far beyond a single terminal window.
    • If you want to build real software without a full dev team, this is the tool to learn first.

    Claude Code is the most practical AI coding tool available for founders right now. Not because it is the flashiest, but because it actually does the work. It reads your project, writes files, runs commands, and ships changes. All from a terminal window.

    This guide covers everything you need to know to get started with claude code: what it is, how it works, how it differs from tools like Cursor and Copilot, and how to build a real workflow around it.

    I have been using Claude Code daily since early 2025. I build client AI systems through Devwiz, my app and SaaS build studio, and Claude Code sits at the centre of almost every project. What follows is the practical picture, not the marketing one.


    What exactly is Claude Code?

    Claude Code is a command-line tool made by Anthropic. You install it, open a terminal in your project folder, and start talking to it about your code. It can read every file in that folder, write new files, edit existing ones, run shell commands, and report back on what it did.

    That is the key difference from a chatbot. The Claude website gives you a conversation. Claude Code gives you an agent that operates inside your actual project.

    It uses Anthropic's Claude models under the hood. You can switch models when you need more reasoning power or faster output.

    What it can do out of the box:

    • Read and write files across your entire project
    • Run terminal commands (installs, builds, tests, git commits)
    • Search your codebase to understand context before making changes
    • Work across multiple files at once
    • Plan multi-step tasks and execute them in sequence

    What it does not do:

    • It does not have a visual editor. You work in a terminal.
    • It does not manage a browser by default, though MCP can add that.
    • It does not remember context between sessions unless you set that up deliberately.

    The short version: Claude Code is the first AI coding tool that actually behaves like a junior developer sitting next to you, not an autocomplete engine.


    How is Claude Code different from Cursor and GitHub Copilot?

    This comes up constantly, so let me be direct about it.

    GitHub Copilot autocompletes your code as you type. It is reactive. You write, it suggests. Great for speeding up repetitive coding. Not built to plan and execute multi-step tasks on its own.

    Cursor is a full code editor, built on VS Code, with AI woven through it. It is visual, familiar if you already use VS Code, and strong at in-editor edits and codebase chat. It is excellent for developers who want AI assistance inside their existing editor workflow.

    Claude Code operates differently. It runs in a terminal. You give it a goal, not a line of code. It figures out the plan, reads the relevant files, makes the changes, and runs the tests. It is agentic by default.

    For a deeper side-by-side breakdown, read Claude Code vs Cursor: which one should you use?

    The honest take: if you already live in VS Code and just want smarter autocomplete, Cursor is worth a look. If you want an agent that can take a task and execute it while you focus on something else, Claude Code is in a different category.

    Claude Code is the only tool in this space designed from the ground up as an autonomous coding agent, not as an editor plugin.


    How do you install Claude Code and get it running?

    Installation is a three-step process. For a step-by-step walkthrough, see the how to use Claude Code guide.

    Here is the quick version:

    Step 1: Install Node.js

    Claude Code requires Node.js version 18 or higher. Download it from nodejs.org. If you are on a Mac, using Homebrew is the faster path.

    Step 2: Install Claude Code

    Open a terminal and install the Claude Code package globally using npm. That puts the claude command on your machine.

    Step 3: Authenticate

    Run the claude command. It will prompt you to authenticate with your Anthropic account. Claude Code uses tokens, so you pay per use. For most builders doing real project work, budget $30 to $150 AUD per month depending on how heavily you use it.

    Once you are authenticated, open any project folder in your terminal and run claude again. You are in.

    First thing to do: Ask it to explain your project. Type something like "Read the files in this folder and give me a summary of what this project does." Watch it work. That first run makes the concept click fast.

    For a full tutorial covering your first real task end to end, the Claude Code tutorial has you covered.


    What is CLAUDE.md and why does it matter?

    This is the part most people skip, and it is the reason their Claude Code sessions feel inconsistent.

    Claude Code reads context from within your project. When you start a session, it looks for a file called CLAUDE.md at the root of your project. Whatever is in that file, it loads as standing instructions before it does anything else.

    Think of it as the briefing document you hand to a new contractor on day one. Your tech stack, your conventions, your naming rules, what not to touch, what the project is actually for.

    Without CLAUDE.md, Claude Code starts each session with no memory of what you built before or how you want things done. It will still work, but it will ask more questions, make assumptions, and occasionally do things slightly off-brief.

    With a good CLAUDE.md, it hits the ground running every single time.

    What to put in your CLAUDE.md:

    • Project description and purpose
    • Tech stack and versions
    • File structure overview
    • Naming conventions and code style rules
    • What it should never do (delete certain files, change certain configs)
    • The current phase of the project or what you are working on right now

    A well-written CLAUDE.md is a compounding asset. You write it once, refine it over a few sessions, and it gets more useful over time.

    For a full breakdown of CLAUDE.md strategy, read the CLAUDE.md strategy that makes Claude Code actually work.

    CLAUDE.md is not optional if you want consistent results. It is the difference between a contractor who reads the brief and one who makes it up as they go.


    What are skills, subagents, and MCP?

    Once you have Claude Code running on a single project, the next level is understanding how to extend it.

    Skills are reusable instruction sets you can invoke from any Claude Code session. Instead of re-explaining how to write a blog post, run an SEO audit, or generate a client report every time, you write the instructions once as a skill file. Then you call it when needed.

    Subagents let you spawn separate Claude Code processes to work on different tasks in parallel. One agent writes tests. Another updates the documentation. Another handles the API layer. You orchestrate from a parent session. This is where Claude Code starts to feel less like a tool and more like a team. For a practical walkthrough, see Claude Code subagents: parallel work explained.

    MCP (Model Context Protocol) is Anthropic's standard for connecting external tools and data sources to Claude. Instead of copying and pasting information into Claude Code, MCP lets it pull that information directly. Your database. Your CRM. A web browser. Your calendar. You connect the tool, Claude Code can read from and write to it. For a plain-English breakdown, read the Model Context Protocol guide or Claude Code MCP setup explained.

    Skills and subagents let you build systems, not just one-off tasks. MCP connects those systems to real data. This is when Claude Code goes from impressive demo to genuine production tool.


    Who is Claude Code actually built for?

    Here is the honest version, not the marketing version.

    It suits you well if:

    • You have a clear project to build and can describe what you want in plain language
    • You are comfortable in a terminal or willing to get comfortable
    • You want to ship software without hiring a full dev team for every small feature
    • You are a founder or operator who understands your business logic and just needs help with the code
    • You want to move fast on prototypes and get to validation quickly

    It will frustrate you if:

    • You need a visual, point-and-click interface
    • You do not have a clear idea of what you want to build before you start
    • You are not willing to review what it does (you always need to check the output)
    • You want it to replace the need to understand your own project at a high level

    The Claude Code for non-technical founders post goes deeper on what the realistic path looks like if you do not have an engineering background.

    I run Devwiz specifically to help founders build apps and SaaS products faster using tools like this. The pattern I see consistently: founders who learn Claude Code at even a basic level ship faster and have much better conversations with any developers they do bring in later.

    Claude Code suits builders who know what they want to make and need help making it. It is not a magic box that handles the thinking for you.


    What does a real Claude Code workflow look like?

    Here is the workflow I use and that I teach.

    Session start:

    1. Open a terminal in the project folder.
    2. Run the claude command.
    3. Give it a goal, not a vague prompt. "Add a login page that uses our existing auth library" beats "make authentication work."

    During the session:

    • Let it plan first. Ask it to tell you what it is going to do before it does it.
    • Review the plan. If something looks off, say so.
    • Let it execute. Watch the output. It will report as it goes.
    • Approve or push back at each major step.

    End of session:

    • Ask it to summarise what it changed.
    • Commit those changes to git before you close the terminal.
    • Update your CLAUDE.md if anything new should carry into future sessions.

    For bigger projects:

    • Set up skills for repeated tasks.
    • Use subagents when you are ready to run work in parallel.
    • Connect MCP tools to give it access to real data.

    This is not a set-and-forget tool. The best results come from treating each session like a short, focused sprint with a clear deliverable.


    Related reading


    FAQ

    What is Claude Code used for?
    Claude Code is used to write, edit, and manage code in real software projects. Founders use it to build web apps, automate workflows, set up APIs, and ship product features without a full engineering team. It works on any project where you can open a terminal.

    Do I need to know how to code to use Claude Code?
    You do not need to be a career engineer, but some basic comfort with terminals and file structures helps a lot. If you can open a terminal, move into a folder, and read a code file without panicking, you have enough to start. The more you understand about your own project, the better results you will get.

    How much does Claude Code cost?
    Claude Code charges based on token usage through the Anthropic account you connect. Most active builders spend $30 to $150 AUD per month. If you are doing heavy parallel work with subagents, it can go higher. You set your own spending limits in your Anthropic account.

    Is Claude Code better than Cursor?
    They are different tools for different workflows. Cursor is an editor with AI features. Claude Code is an autonomous agent that operates in a terminal. If you already live in VS Code, Cursor fits naturally. If you want an agent that plans and executes multi-step tasks on its own, Claude Code is the stronger choice. Read the full comparison here.

    Can Claude Code work on existing projects or just new ones?
    It works on existing projects. You point it at any folder, give it context (ideally via CLAUDE.md), and it can read, understand, and edit existing code. Many founders use it to add features to projects that already have thousands of lines of code.


    Ready to build?

    Claude Code is the most direct path from "I have an idea" to "I have working software" for founders and operators who are not full-time engineers.

    The setup is simple. The CLAUDE.md habit changes everything. The skills and subagents are where it becomes a real system.

    If you want help mapping out what an AI-first build workflow looks like for your specific business, book a strategy call here. We will look at where you are, what you are building, and what the fastest path to a working system actually is.

    About the Author

    James Killick
    James Killick

    The AI Orchestrator

    AI Orchestrator and entrepreneur with 10+ years building digital products. Helping $1M+ business owners scale with AI systems, automation, and implementation through The AI Orchestrators, Devwiz, and Njin.

    Related Posts