Claude Code

On this page 7

Claude Code is an agentic coding tool developed by Anthropic that lets a Claude model work directly inside a software project: it reads the codebase, edits files, runs shell commands and iterates on the results until a task is done. Among AI models & assistants, it belongs to the category of coding agents, as opposed to autocomplete plugins that only suggest the next lines of code.

Claude Code was first released as a research preview in early 2025 and became generally available later that year. It started as a command-line application and now also runs in IDE extensions, a desktop app and the browser, but its defining trait is unchanged: the developer describes a goal in natural language, and the agent plans, acts and verifies its own work while asking for permission before risky steps.

How Claude Code works as a coding agent

Claude Code works through an agent loop: the model reads the request, decides which tool to call, observes the result and repeats until it judges the task complete. The tools are concrete operations on the local environment, so the model can inspect real files and real test output instead of reasoning only from a pasted snippet.

The table below lists the main tool categories the agent uses during a typical session.

Tool categoryWhat it doesTypical use
File reading and searchOpens files and searches by name or contentUnderstanding unfamiliar code
File editingWrites new files or replaces exact textImplementing changes and fixes
Shell executionRuns commands in the terminalTests, builds, linters, git operations
Web accessFetches pages or searches the webReading library documentation
SubagentsDelegate a subtask to a separate contextParallel research or focused reviews
External tools via MCPCalls servers that follow the Model Context ProtocolIssue trackers, databases, browsers
Main tool categories in a Claude Code session

Because a large repository does not fit in one prompt, the agent retrieves context on demand by searching and opening files rather than indexing everything in advance. When a long session fills the context window, older turns are summarized so the work can continue, at the cost of some lost detail.

Permissions, memory and configuration

Claude Code is controlled by a permission system that decides which actions run automatically and which require the developer’s approval. By default, reading is allowed while file edits and shell commands ask first; teams can then allow specific commands, deny others and restrict the agent to chosen directories.

ModeBehaviorSuitable for
Default modeAsks before edits and commandsUnfamiliar or sensitive projects
Accept-edits modeApplies file edits without asking, still asks for commandsFocused work the developer is watching
Plan modeResearches and proposes a plan without changing filesLarge or risky changes
Bypass modeSkips permission prompts entirelyIsolated containers or disposable sandboxes only
Common permission modes

Project knowledge is kept in CLAUDE.md memory files, plain text files that the agent loads at the start of each session. They typically record build commands, coding conventions and architectural rules, so the agent does not need to rediscover them every time.

Further extension points include custom slash commands, skills that package reusable instructions, hooks that run scripts before or after tool calls, and settings files shared through version control. Hooks are notable because they enforce rules deterministically, for example running a formatter after every edit, instead of relying on the model to remember.

Where Claude Code runs and how it is accessed

Claude Code runs on the developer’s own machine in its original form, which means it uses local credentials, local toolchains and local files. Other surfaces trade some of that directness for convenience or automation.

SurfaceEnvironmentStrength
Terminal CLILocal shell on macOS, Linux or WindowsFull access to local tools and scripts
IDE extensionsVisual Studio Code and JetBrains editorsInline diffs inside the editor
Web and desktop appsManaged cloud sessions or a desktop clientLong tasks without a local terminal
Headless modeScripts and CI pipelinesAutomated reviews and batch jobs
Agent SDKCustom applicationsBuilding other agents on the same loop
Claude Code surfaces

Access requires either a Claude subscription plan that includes Claude Code or pay-as-you-go API billing, and organizations can also route usage through major cloud platforms. With API billing, cost scales with tokens processed, so long agentic sessions over large codebases can become noticeably more expensive than chat use.

Claude Code compared with other AI coding tools

Claude Code differs from most coding assistants in its terminal-first, agent-first design. Editor-centric tools such as GitHub Copilot and Cursor grew out of code completion and later added agent modes, while command-line agents such as OpenAI Codex and Gemini CLI follow a model closer to Claude Code.

CategoryTypical interactionExamples
Inline completionSuggests the next lines while typingTabnine, early GitHub Copilot
AI-native editorChat and agent inside a modified IDECursor, Windsurf
Terminal coding agentNatural-language tasks executed in the shellClaude Code, Gemini CLI, OpenAI Codex
Autonomous cloud engineerAssigned tickets worked on remotelyDevin
Coding assistant categories

The boundaries are blurring, since most vendors now offer several surfaces. The practical differences lie in the underlying model quality, the depth of permission and configuration controls, and how well each tool integrates with existing workflows such as git, CI and code review.

Limitations and responsible use of Claude Code

Claude Code can produce plausible but incorrect code, misread project intent or declare a task finished when tests were never run. Its output therefore needs the same human code review as a change from a new colleague, and the most reliable results come when the project has automated tests the agent can execute.

  • Prompt injection through files, web pages or tool output can try to steer the agent, which is why permission prompts and sandboxing matter.
  • Bypass modes on a personal machine expose credentials and files to any mistaken command.
  • Very long sessions lose detail after context summarization, so splitting work into focused tasks improves accuracy.
  • Vague requests lead to broad, unwanted edits; stating scope and acceptance criteria keeps changes small.

Used carefully, the tool shifts developer effort from typing code toward specifying, reviewing and verifying it, which is the main productivity mechanism rather than raw generation speed.

In simple terms

Claude Code is like a capable assistant sitting at your computer who can open your project files, make changes and run the program to check that it works. You describe what you want in ordinary language, and it does the steps one by one.

It asks before doing anything risky, and you can watch every change it makes. The main idea is that the assistant does the work while you stay in charge of what gets accepted.

A practical example

A backend developer at a mid-sized online retailer needs to add rate limiting to an internal API with about forty endpoints. She opens Claude Code in the repository terminal, switches to plan mode and asks for a proposal. The agent searches the routing code, finds the shared middleware layer and suggests one middleware plus configuration per endpoint group.

After she approves the plan, the agent writes the middleware, updates the configuration and runs the existing test suite, which reveals two failing tests that assumed unlimited requests. It fixes those tests, adds new ones for the limit behavior and summarizes the diff. The developer reviews about 300 changed lines, requests one naming change and merges the work in roughly an hour instead of most of a day.