What Claude Code Actually Is (And Isn't)
Claude Code is not a chatbot with a code tab. It is a command-line agent that runs in your terminal, reads your repository, writes files, runs tests, and commits code — autonomously. It was released as a generally available product in 2025 and has since become the benchmark for agentic developer tooling.
Key capabilities as of 2026:
- Full codebase context: reads your entire repo, not just the open file
- Tool use: runs shell commands, edits files, calls APIs, runs tests
- MCP (Model Context Protocol): connects to external data sources — databases, Jira, GitHub, Slack — via a standardized plugin interface
- Hooks: custom shell commands that fire on events (pre-commit, post-tool-use) for policy enforcement and auditability
- Git worktrees: runs parallel tasks in isolated branches without disrupting your working copy
- CLAUDE.md: a project-level instruction file that encodes your team's coding standards, architecture decisions, and forbidden patterns
This is fundamentally different from GitHub Copilot (autocomplete) or Cursor (AI-enhanced editor). Claude Code is closer to an autonomous junior engineer that you supervise.
Current Model Lineup (2026)
Claude Code runs on Anthropic's Claude 4.x model family:
| Model | Best For | Context |
|---|---|---|
| Claude Opus 4.6 | Complex refactors, architecture work, ambiguous requirements | 200K tokens |
| Claude Sonnet 4.6 | Daily coding tasks, PR reviews, test generation | 200K tokens |
| Claude Haiku 4.5 | Fast, high-frequency tasks (linting fixes, doc generation) | 200K tokens |
Switch models with claude --model claude-opus-4-6 or set a default in your project config.
1. Installation and First Run
npm install -g @anthropic-ai/claude-code
export ANTHROPIC_API_KEY=your_key_here
cd your-repo && claude
On first launch, Claude Code reads your repository structure, CLAUDE.md (if present), and recent git history.
EU Data Residency: Anthropic routes API traffic to EU data centers when you select the Europe region in console.anthropic.com. Sign a Data Processing Agreement (DPA) via Anthropic's enterprise team before rollout.
2. CLAUDE.md: Your Team's Constitution
Create a CLAUDE.md at your repo root and commit it. Claude Code reads it on every invocation and enforces its constraints across every engineer's session.
# CLAUDE.md - Acme Corp Engineering Standards
## Architecture
- Next.js 16 monorepo with a FastAPI backend under /api
- Redis for ephemeral state; PostgreSQL for persistent data
- Never use raw SQL - always use the ORM layer in src/lib/db
## Code Standards
- TypeScript strict mode required - no `any` types
- All new API routes must have Zod validation on request body
- Tests live in __tests__/ adjacent to the source file
- Run `npm test` before marking any task done
## Forbidden Patterns
- Never commit secrets - use environment variables only
- No dynamic code execution
- Do not call external APIs directly from components - use server actions
## EU Compliance
- PII fields must use the anonymization utilities in src/lib/privacy
- Log retention: 30 days maximum per GDPR Article 5(1)(e)
- All new data models need a documented legal basis before shipping
3. Hooks: Enforcing Policy at the Agent Level
Hooks are shell commands that Claude Code executes automatically at specific lifecycle events. They are your compliance enforcement layer.
Block commits with unresolved TODOs:
{
"pre-commit": [{
"command": "grep -rn 'TODO|FIXME' src/ --include='*.ts' && exit 1 || exit 0",
"description": "Block commits with unresolved TODOs"
}],
"post-tool-use": [{
"matcher": "Write|Edit",
"command": "npx prettier --write '$CLAUDE_TOOL_OUTPUT_FILE' 2>/dev/null || true",
"description": "Auto-format any file Claude writes"
}]
}
Audit log every agent action (SOC 2 / regulated industries):
{
"post-tool-use": [{
"command": "echo \"$(date -u) TOOL=$CLAUDE_TOOL_NAME FILE=$CLAUDE_TOOL_OUTPUT_FILE\" >> /var/log/claude-audit.log",
"description": "Append every tool use to the audit log"
}]
}
This gives you a tamper-evident record of every file Claude Code touched — critical for regulated industries (finance, healthcare, defence).
4. MCP: Connecting Claude Code to Your Systems
MCP (Model Context Protocol) is an open standard that lets Claude Code read from and write to external systems without custom integrations.
| MCP Server | Use Case |
|---|---|
@modelcontextprotocol/server-github | Read PR history, create issues, review diffs |
@modelcontextprotocol/server-postgres | Query production DB schema (read-only) for migration analysis |
@modelcontextprotocol/server-filesystem | Access files outside the current repo |
| Custom Jira MCP | Fetch ticket details so Claude understands acceptance criteria |
{
"mcpServers": {
"github": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"],
"env": { "GITHUB_PERSONAL_ACCESS_TOKEN": "$GITHUB_TOKEN" }
}
}
}
5. <a href="/services/eu-ai-act-compliance">eu ai act</a> Considerations
The EU AI Act (fully applicable from August 2026) classifies AI coding assistants as general-purpose AI systems.
What you must do:
- Human-in-the-loop: Claude Code's permission model — it asks before running destructive commands — satisfies this by default. Do not disable permission prompts in production pipelines.
- Document AI-generated code: include commit message conventions flagging AI-assisted changes.
- Risk assessment for high-risk systems: medical devices, <a href="/services/nis2-ai-security">critical infrastructure</a>, and financial scoring require a documented assessment under Annex III.
- Data minimisation: use anonymized fixtures in test generation; do not feed production PII into prompts.
What you don't need to worry about: Claude Code is not a biometric or emotion-recognition system. Supervised coding assistance is not classified as high-risk.
6. Production Workflow Patterns
Parallel feature development with git worktrees:
claude --worktree "implement the user export feature per JIRA-1234"
# Works in a separate branch without touching your working copy
Automated PR review in CI:
name: AI Code Review
on: [pull_request]
jobs:
review:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
with: { fetch-depth: 0 }
- env:
ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
run: |
npm install -g @anthropic-ai/claude-code
git diff origin/main...HEAD | claude --print --no-interactive \
"Review this diff for security issues and GDPR compliance gaps."
Legacy COBOL/Java modernisation: With 200K context, Claude Code can ingest an entire module and produce a modernised Python 3.12 equivalent with full type hints, Pydantic validation, and pytest coverage.
7. Cost Management at Scale
| Model | Input (per 1M tokens) | Output (per 1M tokens) |
|---|---|---|
| Claude Opus 4.6 | $15 | $75 |
| Claude Sonnet 4.6 | $3 | $15 |
| Claude Haiku 4.5 | $0.25 | $1.25 |
Prompt caching reduces costs by up to 90% for repeated context. Claude Code caches your CLAUDE.md and repo structure automatically. Set hard spending limits per team in console.anthropic.com.
8. When Claude Code Is Not the Right Tool
| Scenario | Better Alternative |
|---|---|
| Real-time tab completion while typing | GitHub Copilot |
| AWS-native infrastructure code | Amazon Q Developer (formerly CodeWhisperer) |
| AI-enhanced editor with inline suggestions | Cursor |
| Offline / air-gapped environments | Local models via Ollama |
Claude Code excels at multi-step autonomous tasks on large codebases. It is not an autocomplete tool.
Getting Started: A 2-Week Pilot Plan
Week 1 — Low-Risk Validation: Install for 2–3 senior engineers on a non-critical tool. Write CLAUDE.md collaboratively. Use it only for test generation and PR review comments. Measure time saved per PR.
Week 2 — Supervised Autonomy: Enable git worktrees. Add compliance hooks. Run one full feature cycle with Claude Code as implementer and a human as reviewer. Measure rework rate.
For teams ready to move faster, Hyperion's AI Developer Acceleration service designs the CLAUDE.md strategy, MCP integrations, and compliance hooks for your specific stack. [Learn more about our AI services](https://hyperion-<a href="/services/coaching-vs-consulting">consulting</a>.io/en/services).
