Claude Code Glossary

Every Claude Code term, defined and searchable.

  • $15 Free
  • 20 sec
  • No signup
1

Search the term you hit

2

Read the plain-English definition

3

Follow the link to go deeper

You get: Plain-English definitions for every Claude Code term.

Search the glossary

25 terms

.mcp.json

MCP

The configuration file that tells Claude Code which MCP servers to launch, with what command, arguments, and environment variables. It can live at the project level so a team shares the same servers.

Claude Code

Core

Anthropic's command-line coding agent. It runs in your terminal, understands your project, and can read files, run commands, and edit code to accomplish a task you describe in natural language.

CLAUDE.md

Config

A markdown file in your project (or home directory) that Claude Code loads into every session as standing instructions - your conventions, commands, and rules. Because it loads every time, keeping it tight saves tokens.

Compact

Cost

The act of summarizing a long conversation to free up the context window while preserving the important state. Compacting lets a long session continue without reloading its entire history each turn.

Context window

Core

The total amount of text (measured in tokens) the model can consider at once - your prompt, the files it has read, the conversation history, and its own output. When it fills up, older content must be dropped or compacted.

Headless mode

CLI

Running Claude Code non-interactively, driven by flags and piped input rather than a live conversation. It is how you slot the agent into scripts, CI pipelines, and automation.

Hook

Config

A command Claude Code runs automatically at a defined moment in its lifecycle - for example before or after a tool call. Hooks let you enforce rules, run linters, or block actions deterministically, outside the model's judgment.

MCP

MCP

Model Context Protocol - an open standard for connecting AI tools to external systems. An MCP server exposes tools, resources, or data (a database, an API, a service) that Claude Code can then use.

MCP server

MCP

A program that implements the Model Context Protocol to give Claude Code new capabilities - reading from a database, calling an API, or accessing a service. You configure which servers to load in .mcp.json.

Model (Opus / Sonnet / Haiku)

Cost

The three tiers of the Claude 4 family. Opus is the most capable and costly, Sonnet is the balanced default, and Haiku is the fastest and cheapest. You can switch between them per task.

Output style

Config

A configurable profile that shapes how Claude Code communicates - its tone, verbosity, and formatting - so responses consistently match how you like to work.

Permissions (allow / ask / deny)

Config

Rules that control which tools and commands Claude Code may run. 'Allow' runs without asking, 'ask' prompts you for approval, and 'deny' blocks outright - the core of running the agent safely.

Plan mode

CLI

A mode where Claude Code proposes a plan and waits for your approval before making changes. It is a safety and alignment step - you catch a wrong direction cheaply before any code is written.

PreToolUse / PostToolUse

Config

Two of the hook events. A PreToolUse hook runs before a tool executes and can allow, block, or modify it; a PostToolUse hook runs after and can react to the result. They are how you gate or audit tool activity.

Prompt cache

Cost

A mechanism that stores repeated context (like your CLAUDE.md or unchanged file contents) so it can be reused across prompts at a large discount instead of being re-processed at full price each turn.

settings.json

Config

The Claude Code configuration file (in .claude/) that holds permissions, environment variables, model choice, hooks, and other options. Project and user settings combine to control how Claude Code behaves.

Skill

Agents

A packaged capability, defined in a SKILL.md file with frontmatter, that Claude Code loads and can invoke when its trigger conditions match. Skills bundle instructions (and optionally scripts) for a repeatable task.

SKILL.md

Agents

The markdown file that defines a skill. Its frontmatter sets the name and description (which control when the skill triggers), and its body holds the instructions the skill runs.

Slash command

CLI

A reusable, named command you invoke with a leading slash (like /review). Custom slash commands are defined as markdown files in .claude/commands and expand into a prompt, optionally taking arguments.

Status line

CLI

A customizable line in the Claude Code interface that can display context like the current model, git branch, directory, or token usage, driven by a command you configure in settings.

Subagent

Agents

A specialized, separate agent Claude Code can delegate a scoped task to. Each subagent has its own instructions and its own context window, so it can do focused work without cluttering the main conversation.

System prompt

Core

The high-level instructions that set the model's role and behavior for a session. In Claude Code you can extend it (for example with --append-system-prompt) to add standing guardrails on top of the defaults.

Token

Cost

The unit models read and write in. A token is roughly a few characters - often about three-quarters of a word in English. You are billed per input token and per output token, which is why token count drives cost.

Tool call

Core

When the model invokes a capability - reading a file, running a command, searching, or calling an MCP tool - rather than just producing text. Agentic work is largely a sequence of tool calls.

Transport (stdio / SSE / HTTP)

MCP

How an MCP server communicates with Claude Code. Stdio runs the server as a local subprocess over standard input/output; SSE and HTTP connect to a server over the network. A mismatch is a common cause of connection failures.

The Claude Code vocabulary, defined plainly

Claude Code has a small but dense vocabulary - MCP, subagents, skills, hooks, the context window, prompt caching, CLAUDE.md - and the docs tend to assume you already know how the pieces fit. This glossary is the fix: a searchable list of every core term with a plain-English, accurate definition. Type a word you hit in a tutorial, or filter by category to browse a whole area at once. Everything here is client-side, so search is instant and nothing leaves your browser.

Start with the four terms that unlock the rest

If you learn only four concepts first, learn these. The context window is the model's working memory - everything it can see at once, measured in tokens. Tokens are the billing and sizing unit, roughly three-quarters of a word each. CLAUDE.md is the standing instruction file loaded into every session. And MCP is the protocol that lets Claude Code reach outside itself to databases, APIs, and services. Almost every other term is a detail hanging off one of these four.

How the pieces relate

  • Config layer - CLAUDE.md, settings.json, permissions, hooks, and output styles shape how Claude Code behaves before you type a single prompt.
  • Extension layer - MCP servers add external capabilities, subagents delegate scoped tasks, and skills package repeatable workflows. Each solves a different extension problem.
  • Runtime layer - the context window, tokens, prompt cache, and compacting govern what the model can see and what it costs while it works.
  • Interface layer - slash commands, plan mode, the status line, and headless mode are how you actually drive the agent from the terminal.

Skill vs subagent vs MCP vs hook

These four are the most-confused terms. A skill packages instructions for a repeatable task. A subagent is a separate agent with its own context you delegate to. An MCP server connects Claude Code to an external system. A hook runs a deterministic command at a lifecycle moment. Different jobs - pick by what you are trying to add.

Cost terms worth internalizing

A handful of terms explain your entire bill. You pay per token in and per token out. The prompt cache serves repeated context at a steep discount, so a healthy cache hit rate quietly saves money. The context window is finite, and when it fills you either compact (summarize to reclaim space) or start fresh. Understanding just these - token, prompt cache, context window, compact - turns your cost from a mystery into a set of knobs you can turn.

Config terms that keep you safe

The config vocabulary is really about control and safety. Permissions (allow, ask, deny) decide which tools and commands the agent can run and when it must check with you. Hooks, including PreToolUse and PostToolUse, let you enforce rules deterministically - block a dangerous command, run a linter after every edit - without relying on the model's judgment. settings.json ties it together. Learning these terms is how you go from 'letting the agent run' to 'running the agent on your terms'.

How to use this glossary

  1. When you hit an unfamiliar term in a tutorial or the docs, search it here first for a one-line grounding before you read on.
  2. Browse a category end-to-end when you are learning a new area - filter to MCP, or Agents, or Config, and read the whole set.
  3. Use it as a checklist. If several config or agent terms are still fuzzy, that is a map of what to learn next.
  4. Come back as terms evolve. Claude Code adds capabilities over time, and the vocabulary grows with it.

From vocabulary to fluency

Definitions get you unstuck, but fluency comes from using the concepts. Once a term clicks here, go build the thing - write a tight CLAUDE.md, wire up an MCP server, add a permission rule, create a slash command. The other free tools on this site turn each of these terms into something you can generate and ship in a minute. Vocabulary is the on-ramp; the workflow is the destination.

Frequently asked questions

  • What is the difference between a skill and a subagent?

    A skill is a packaged capability - instructions (and optionally scripts) in a SKILL.md file that Claude Code loads and runs when its trigger matches. A subagent is a separate agent with its own instructions and its own context window that you delegate a scoped task to. Skills package know-how; subagents isolate work.

  • What exactly is the context window?

    It is the total amount of text, measured in tokens, that the model can consider at once - your prompt, files it has read, the conversation history, and its own output. When it fills up, older content must be dropped or compacted, which is why long sessions need managing.

  • What is MCP in Claude Code?

    MCP stands for Model Context Protocol, an open standard for connecting AI tools to external systems. An MCP server exposes tools, resources, or data - a database, an API, a service - that Claude Code can then use. You choose which servers to load in a .mcp.json file.

  • What does CLAUDE.md do?

    CLAUDE.md is a markdown file loaded into every Claude Code session as standing instructions - your conventions, commands, and rules. Because it loads every time, it acts like a persistent system prompt for your project, and keeping it concise saves tokens.

  • What is a hook?

    A hook is a command Claude Code runs automatically at a defined lifecycle moment, such as before or after a tool call (PreToolUse / PostToolUse). Hooks enforce rules deterministically - blocking a command, running a linter - without depending on the model's judgment.

  • Is this glossary kept up to date?

    It covers the core, stable vocabulary of Claude Code as it works today, written to be accurate rather than exhaustive. Claude Code adds capabilities over time, so always cross-check the newest features against Anthropic's official documentation.

Liked this tool? The club is the next step.

Join Claude Code Club for $9/month. 650+ lessons, weekly updates, and the workflows behind every tool on this site.

  • No experience needed
  • Cancel anytime
  • Updated weekly