Claude Code Guide

This portal indexes 26,663 lines of reference documentation and 34 workflow guides. Use the paths below when you know your goal, or browse by topic for the complete curated map.

New and noteworthy

Translations and Language Status Read the canonical, maintained, and community editions with explicit version, sync date, and coverage status.

Loop & Graph Engineering Design bounded feedback loops, executable graphs, checkpoints, recovery, and explicit judgment allocation.

Agent Harness Engineering Build the reliability layer around a model: context, policy, tools, verification, observability, and recovery.

Agent Harness Landscape Compare 192 projects while separating strict runtimes, control planes, repository harnesses, and adjacent infrastructure.

Subscription Strategy at Team Scale Choose between seats, usage billing, API gateways, multi-vendor setups, and scenario-bound self-hosting.

Monitor & Safe Event Delegation Turn external events into verified, deduplicated, gated, and isolated agent work.

Agentic Software Factories Move from one coding session to governed multi-run production without adding a control plane too early.

Team AI Instructions Scale shared AI instructions across a team while preserving ownership, review, and local autonomy.

Practitioner Insights Trace field reports and academic evidence back to named speakers, videos, papers, and explicit limits.

Follow every guide update in the public changelog →

Choose your path

Learn Claude Code Install the CLI, complete a first task, then progress through memory, agents, skills, hooks, and MCP.

Engineer reliable agents Start with the runtime loop, then add graph structure, evaluation, observability, and orchestration only when needed.

Secure and govern Control permissions, sandboxes, MCP supply-chain risk, production gates, data handling, and organizational policy.

Scale a team Connect adoption, team instructions, knowledge infrastructure, metrics, gateways, and unit economics.

Browse by topic

Core Reference

Claude Code fundamentals and complete references.

Guide	What it covers	Time
Ultimate Guide	The complete chapter-by-chapter reference.	~3 hours
Translations	Verified status for English, French, Chinese, Ukrainian, and Latin American Spanish.	8 min
Cheatsheet	Essential commands and configuration on one page.	5 min
Architecture	Master loop, tool execution, context, and internal boundaries.	25 min
Tools Reference	Built-in tools, permissions, timeouts, and behaviors.	20 min
Hooks & Events Reference	Hook events, matchers, schemas, decisions, and timeouts.	15 min
Settings Reference	Confirmed settings and environment variables.	15 min
Methodologies	Development methodologies and combination patterns.	20 min
Visual Reference	Compact diagrams for core concepts.	5 min
Known Issues	Critical bugs and verified operational limits.	15 min
Glossary	Claude Code and agent-engineering terminology.	5 min
Community Patterns	Community-coined workflows and engineering patterns.	10 min
Skill Design Patterns	Architectural patterns for robust, efficient skills.	20 min

Agent Engineering

Loops, graphs, harnesses, evaluation, and orchestration.

Guide	What it covers	Time
Agent Harness Engineering	Runtime reliability architecture around the model.	35 min
Loop & Graph Engineering	Bounded loops, executable graphs, durable state, and judgment.	25 min
Agent Harness Landscape	Evidence-backed map of runtimes and adjacent systems.	20 min
Agentic Tools	Detailed tool profiles and comparison matrix.	20 min
Agent Evaluation	Measure model-harness quality across repeated runs.	20 min
Agentic Software Factories	Operating model from one session to a governed factory.	20 min

Context, Memory & Economics

Control what agents know, retain, spend, and share.

Guide	What it covers	Time
Context Engineering	Token budgets, modular context, ACE, and quality measurement.	25 min
Memory Systems	Native, cross-session, and team-shared memory.	30 min
Team Knowledge Infrastructure	Markdown, live connectors, and RAG at team scale.	18 min
Local vs Cloud Inference	Hardware, rental, API, throughput, and TCO boundaries.	20 min
AI Unit Economics	Accepted-task cost, three-level routing, cache effects, progressive spend controls, and break-even.	15 min
Subscription Strategy	Seats, Enterprise usage, gateways, and self-hosting scenarios.	20 min

Security & Governance

Permission, isolation, supply-chain, data, and production controls.

Guide	What it covers	Time
Security Hardening	Threat model, MCP vetting, and prompt-injection defenses.	25 min
Sandbox Isolation	Local and cloud isolation trade-offs.	15 min
Native Sandbox	Claude Code sandbox configuration and limits.	10 min
Production Safety	Guardrails, review gates, rollback, and recovery.	15 min
Data Privacy	Data flows, retention, and privacy controls.	10 min
Enterprise Governance	Usage charters, approval workflows, and risk tiers.	25 min

Operations & Team Adoption

Operate, observe, finance, and govern AI-assisted delivery.

Guide	What it covers	Time
DevOps & SRE	Infrastructure diagnosis and incident response.	30 min
Observability	Traces, reliability signals, cost, and recovery metrics.	20 min
API Gateway	Routing, progressive spend policy, terminal budgets, allowlists, and attribution.	15 min
AI Traceability	Attribution, disclosure, audit trails, and compliance.	20 min
Team Metrics	DORA, SPACE, Core 4, and agent-specific signals.	20 min
Adoption Approaches	Rollout strategies, trust calibration, and evidence.	15 min

Ecosystem & Tools

Complementary tools, MCP servers, research, and field evidence.

Guide	What it covers	Time
AI Ecosystem	Complementary AI tools and multi-provider workflows.	30 min
MCP Servers Ecosystem	Validated MCP servers and production configuration.	25 min
MCP vs CLI	Choose the smallest tool interface for the job.	15 min
Third-Party Tools	GUIs, TUIs, config managers, and token trackers.	15 min
Context Engineering Tools	Compression, RAG, gateways, and LLMOps tooling.	20 min
Remarkable AI	Power-user patterns and noteworthy projects.	10 min
Practitioner Insights	Attributed video, conference, and academic evidence.	20 min
AI Executive Agents	Virtual C-suites, board simulators, and governance limits.	12 min

Roles & Learning

Role-specific entry points and responsible learning paths.

Guide	What it covers	Time
AI Roles	Role definitions, routing, and the interactive quiz.	10 min
Learning with AI	Build skills without outsourcing understanding.	15 min
For Product Managers	Specs, review, and prototyping for PMs.	5 min
For Tech Leads	Shared config, rollout, and safety for leads.	5 min
For CTOs	Business case, governance, and adoption metrics.	5 min
For CIOs & CEOs	Executive brief and decision boundaries.	3 min

Workflows

Runnable patterns for planning, implementation, review, and delegation.

Guide	What it covers	Time
All Workflows	Browse the complete workflow index.	Index
TDD with Claude	Test-driven development with an agent.	15 min
Spec-First	Intent, specification, plan, and implementation gates.	20 min
Plan-Driven	Use planning as an explicit control boundary.	15 min
Agent Teams	Multi-agent coordination and worktree isolation.	25 min
Dynamic Workflows	Deterministic orchestration, fan-out, and resume.	20 min
Monitor & Safe Delegation	Event ingestion, verification, and gated handoff.	20 min
Team AI Instructions	Scale shared instructions across developers and tools.	20 min
Production Reliability	Escalation, circuit breakers, and graceful degradation.	20 min
Review code with a repeatable multi-provider workflow	Use independent providers, fixed review criteria, and a human acceptance gate.	20 min
Multi-Provider Code Review	Independent review across providers and evidence sources.	20 min
Cross-Session Messaging	Discover and communicate between independent sessions.	15 min
Search Tools Mastery	Combine lexical, semantic, and structural search.	20 min