Claude Code

What Is Claude Code? The Complete Guide (2026)

8 min read

What Is Claude Code?

Claude Code is Anthropic's agentic command-line coding tool. Instead of living inside an editor as a passive suggestion engine, it runs in your terminal as an autonomous agent that can read and edit files across your codebase, run shell commands, execute tests, and call external tools on your behalf. You describe a goal in plain English, and Claude Code figures out which files to open, what changes to make, and how to verify the result, checking in with you along the way.

The practical difference is scope. A traditional assistant helps you finish the line you are typing. Claude Code helps you finish the task: refactor a module, fix a failing test suite, wire up an API, or trace a bug through a dozen files. It keeps a working memory of your project, reasons about multi-step plans, and takes real actions in your environment. If you want the deep dive on any concept below, the ToolZip Claude Code hub collects guides, references, and ready-to-use components in one place.

Agentic Coding vs. Autocomplete

Autocomplete tools predict the next few tokens based on the code around your cursor. They are fast and useful, but they are fundamentally reactive: you drive, they suggest. Agentic coding inverts that relationship. You hand Claude Code an objective and it drives, breaking the work into steps and executing them.

Three capabilities make this possible. First, tool use: Claude Code can search your repository, open files, apply edits, and run commands like npm test or git diff. Second, a feedback loop: it reads command output, notices when a test fails or a build breaks, and corrects course without you re-prompting. Third, context management: it explores your project to understand structure and conventions before it writes a single line. The result feels less like autocomplete and more like pairing with a fast, tireless engineer who actually runs the code.

How to Install Claude Code

Claude Code ships as an npm package and requires a recent version of Node.js. The most common approach is a global install so the claude command is available from any project directory:

# Install globally
npm install -g @anthropic-ai/claude-code

# Or run it once without installing
npx @anthropic-ai/claude-code

# Launch inside any project
cd my-project
claude

The first time you run claude, it walks you through authentication in your browser. You can sign in with a Claude subscription (Pro or Max) or connect an Anthropic API key from the Console for usage-based billing. Once authenticated, Claude Code starts an interactive session in your current directory, and that directory becomes the project it can read and modify. Run it from the repository root so it has full context.

The Core Workflow: Ask, Plan, Edit, Run, Review

A productive session follows a simple rhythm.

  1. Ask. State what you want in plain language, for example "Add pagination to the users endpoint and update the tests." Be specific about the outcome, not the implementation.
  2. Plan. For anything non-trivial, ask Claude Code to outline its approach first. It will identify the files involved and the steps it intends to take, so you can correct the direction before any code changes.
  3. Edit. It applies changes across the relevant files, following the patterns and style it observed in your codebase.
  4. Run. It executes tests, linters, or the build to check its own work, then reads the output and fixes what broke.
  5. Review. You inspect the diff, ask for adjustments, and commit when satisfied. Claude Code proposes changes; you stay the reviewer and the final approver.

The habit that pays off most is asking for a plan before large changes and keeping each request focused. Small, verifiable steps beat one sprawling instruction every time.

Extending Claude Code

The real power comes from customization. Claude Code reads a .claude/ directory in your project (and a global one in your home folder), where you configure reusable components that shape how the agent behaves. Here are the building blocks.

Subagents

Subagents are specialized helpers defined in .claude/agents/, each with its own instructions, tool permissions, and separate context window. You might have a dedicated code reviewer, a test writer, or a documentation agent. The main session delegates focused work to them, which keeps context clean and lets each subagent stay expert at one job. See the subagents catalog or the deeper agents guide to start.

Slash Commands

Slash commands are reusable prompts stored as Markdown files in .claude/commands/ and invoked with a leading slash, like /review or /changelog. They turn a repeatable multi-step instruction into a single keystroke, and they can accept arguments. Browse ready-made examples in the commands catalog.

MCP Servers

The Model Context Protocol (MCP) is an open standard that connects Claude Code to external systems, databases, issue trackers, browsers, cloud APIs, and more. You register servers in a .mcp.json file, and their tools become available inside your session. This is how the agent reaches beyond your local files. Explore options in the MCP servers directory or read the MCP servers guide.

Hooks

Hooks are shell commands that fire automatically on lifecycle events, such as before a tool runs, after a file is edited, or when a session ends. They are ideal for deterministic guardrails: auto-formatting on save, blocking edits to protected paths, or logging every command. Because hooks are executed by the harness rather than decided by the model, they run every time without fail. See patterns in the hooks catalog.

Skills

Skills are packaged instruction bundles, a folder of guidance plus any supporting scripts or reference files, that Claude Code loads when a task matches. They encapsulate a repeatable workflow or a body of domain knowledge so you do not have to re-explain it each session. Find pre-built bundles in the skills catalog.

Settings

A settings.json file controls configuration such as tool permissions, environment variables, model selection, and hook definitions. Project settings live in .claude/settings.json, and personal overrides go in a local settings file that you keep out of version control. This is where you decide, for example, which commands Claude Code may run without asking. Details are in the settings reference.

CLAUDE.md

CLAUDE.md is the project memory file at your repository root. Claude Code reads it automatically at the start of every session, so it is the right place to document build commands, architecture notes, coding conventions, and any rules the agent should always follow. A well-maintained CLAUDE.md is the single highest-leverage file for getting consistent results.

Getting Started Fast with the ToolZip Catalog

You do not have to build every component from scratch. The ToolZip Claude Code catalog curates ready-to-use subagents, slash commands, MCP servers, hooks, and skills that you can drop into your .claude/ directory in minutes. A fast starting path:

  • Install Claude Code and run claude init so it generates a first-draft CLAUDE.md for your repo.
  • Grab a slash command or two for chores you repeat, like reviews or release notes.
  • Add a specialized subagent for testing or code review to keep your main context focused.
  • Connect an MCP server for the external service your project depends on.
  • Lock in a formatting or safety hook so quality checks run automatically.

Each entry in the catalog includes the config you copy and clear setup steps, so you can assemble a tailored, powerful workflow without trial and error.

Final Thoughts

Claude Code represents a shift from assistants that complete your lines to agents that complete your tasks. It reads your codebase, plans, edits, runs commands, and checks its own work, while you stay firmly in the reviewer's seat. The core loop is easy to learn in an afternoon, and the extensibility layer, subagents, slash commands, MCP servers, hooks, skills, settings, and CLAUDE.md, is what turns it into a workflow uniquely fitted to your team. Install it, write a solid CLAUDE.md, pull a few components from the ToolZip catalog, and let the agent handle the busywork so you can focus on the decisions that matter.

Browse Claude Code Agents

Specialized AI subagents with their own prompt, tools, and context.

Open catalog →

Frequently Asked Questions

What is Claude Code?
Claude Code is Anthropic's official agentic command-line tool. You run it inside a project directory and describe goals in plain language; it reads your codebase, edits files, runs commands, and iterates like a coding agent rather than a passive chat assistant.
How do I install Claude Code?
Claude Code is an npm package. Install it globally with 'npm i -g @anthropic-ai/claude-code' or run it on demand with 'npx @anthropic-ai/claude-code'. You need Node.js and either a Claude Pro/Max subscription or an Anthropic API key to authenticate on first launch.
Is Claude Code free to use?
The CLI itself is free to install from npm, but using it requires authentication through a Claude subscription (Pro or Max) or an Anthropic API key, which is billed separately. There is no separate charge for the command-line tool beyond your Claude plan or API usage.
What is the difference between a subagent and a skill?
A subagent is a specialized assistant with its own system prompt and tool access, stored in .claude/agents, that Claude delegates focused tasks to. A skill is a packaged set of instructions and supporting files that teaches Claude how to perform a specific kind of task, loaded when relevant. In short: subagents are workers, skills are reusable know-how.
What is CLAUDE.md and why does it matter?
CLAUDE.md is a Markdown file Claude Code reads automatically to learn about your project — architecture, conventions, test commands, and things to avoid. It acts as persistent memory that lives in the repository, so every session starts already knowing your codebase's rules. A good CLAUDE.md is often the highest-leverage addition you can make.
Do I need MCP servers to use Claude Code?
No. Claude Code works fully without them for reading, editing, and running code. MCP servers are optional connectors that let the agent reach external tools and data such as databases, issue trackers, or browsers via the Model Context Protocol. Add one only when your workflow needs that external access.