DeveloperHA / AI agents / Claude Code
Terminal and IDE coding agent · CLI agents

Claude Code

Understand Claude Code as an agent surface with tools, permissions, context files, hooks, skills and sessions—not just a chat window in a terminal.

Made by AnthropicSeparate agent guideReviewed 2026-09-26Model ≠ harness ≠ orchestrator
Scope note This is an independent guide to a third-party project or a developer concept. Installation commands, feature boundaries, plans, model availability and security defaults change. Follow the official source links before using it with private code, credentials or automation.

What it is and who makes it

An Anthropic coding agent available in the terminal and other development surfaces that can read code, edit files, run commands and use integrations.

Maker or project: Anthropic. Classification: Terminal and IDE coding agent; this page treats the surrounding context, tools, permissions and verification as the relevant harness boundary.

1
Launch it from a project directory and provide a task with explicit scope.

Launch it from a project directory and provide a task with explicit scope.

2
The agent selects tools such as file reads, edits and shell commands.

The agent selects tools such as file reads, edits and shell commands.

3
Permission settings and hooks constrain or observe actions.

Permission settings and hooks constrain or observe actions.

4
You review the diff, run tests and continue or stop the session.

You review the diff, run tests and continue or stop the session.

Who it may fit

Pick an agent by its control surface and trust boundary, not only by its model label.

Useful scenarios

  • Interactive repository work
  • Multi-file changes with visible diffs and approvals
  • Teams building repeatable skills, hooks and project instructions

Trade-offs and checks

  • The CLI, IDE, desktop and web surfaces can have different capabilities and data paths.
  • Project instructions, skills and hooks are executable workflow configuration; review them like code.
  • Use read and write permissions deliberately, especially around environment files, credentials and deployment scripts.

Interactive vs headless and CI

These modes change the approval, identity and observability boundary.

Interactive terminal, IDE, desktop or web sessions are designed for human steering. For automation, use the documented non-interactive CLI or Agent SDK path, restrict permissions and treat hooks, skills and MCP as part of the execution policy.

Request-to-verification workflow

Use this mental model when debugging a surprising edit, tool call or cost.

Input

Intent + context

Your prompt, repository instructions, selected files, history and environment become model context.

Action

Tool + permission

The harness proposes a read, edit, shell, web, MCP or other action; policy decides whether it can run.

Feedback

Result + verification

Command output, compiler errors, tests and your review return to the loop before acceptance.

Setup outline

Start with the smallest safe experiment, then follow the current official documentation for the real installation.

1
Install using the current official Claude Code documentation.
2
Authenticate with the supported subscription or API account.
3
Start with read-only exploration and project instructions.
4
Add hooks, MCP servers or skills only after reviewing their permissions.
Illustrative workflow
# Official install options change; follow the current docs.
# Example workflow:
cd your-project
claude

> First map the repository and list the files you would change.
> Do not edit until I approve the plan.

Instructions, skills, MCP and hooks

These surfaces can shape context or add actions; they are part of the trust boundary.

Claude Code supports project instructions and extension surfaces such as skills, plugins, MCP servers and hooks; the exact names and capabilities are version-sensitive. Review project instruction precedence and each hook or server before enabling it.

Security and isolation checklist Use a disposable branch or worktree; keep secrets outside the readable path; require approval for writes, shell, network and deployment actions; inspect commands before allowing them; constrain server bindings; review MCP servers, plugins, skills, hooks and instruction files; and run tests independently of the agent's own summary.

Official sources

Use these sources for current installation, capabilities, plans, releases and security notices.

Reviewed 2026-09-26. This date is a change-tracking note, not a promise that the product remains unchanged.

Related learning

Related agent guides

Want the foundations behind the workflow?

Study AI fundamentals, prompt design, AI-assisted development, agents and MCP without a forced linear course.

Open AI learningAI tools