Exam guide·8 min read·25 July 2026

Claude Code Agents: The CCAR-F Architect Exam Guide

Master claude code agents for the CCAR-F exam. Covers agentic loops, orchestration patterns, tool design, and the five exam domains with weights and practice strategies.

By Solomon Udoh · AI Architect & Certification Lead

Claude Code Agents: The CCAR-F Architect Exam Guide

What are Claude Code agents, and why do they dominate the CCAR-F exam?

Claude Code agents are autonomous or semi-autonomous processes that use Claude as their reasoning engine, invoke tools in a loop, and act on real systems rather than simply returning text. On the Claude Certified Architect, Foundations exam (CCAR-F, $125, 60 items, 120-minute limit), they are not a single topic but the connective tissue across all five domains. Domain 1 alone, Agentic Architecture & Orchestration, carries 27% of the exam weight, and agent-adjacent skills appear in every other domain too.

Understanding how claude code agents work at the implementation level, not just the conceptual level, is what separates candidates who score above the 720 passing mark from those who fall short.

How does the CCAR-F exam weight agent-related domains?

The exam draws from five domains with fixed percentage weights. The table below shows each domain, its weight, and the primary agent skill it tests.

DomainWeightCore agent skill tested
Domain 1: Agentic Architecture & Orchestration27%Loop design, multi-agent topology, session management
Domain 2: Tool Design & MCP Integration18%Tool descriptions, error propagation, MCP scoping
Domain 3: Claude Code Configuration & Workflows20%CLAUDE.md hierarchy, hooks, CI/CD integration
Domain 4: Prompt Engineering & Structured Output20%Goal-based prompts, schema design, few-shot examples
Domain 5: Context Management & Reliability15%Stale context, summary injection, attention dilution

Source: Anthropic CCAR-F exam guide, 12 March 2026.

Domain 1 and Domain 3 together account for 47% of the exam. If you are short on study time, those two domains return the highest yield per hour invested.

What is the agentic loop, and how does the exam test it?

The agentic loop is the repeating cycle in which Claude receives a message, decides whether to call a tool or return a final answer, receives the tool result, and continues until the task is complete or a stopping condition fires. The exam tests this loop at the level of practical diagnosis, not theory.

A typical scenario presents a loop that terminates too early or runs indefinitely and asks you to identify the root cause. The two most common failure modes are:

  1. Premature termination caused by a stop_reason of end_turn when the model should have called another tool. This usually traces to a missing or ambiguous tool description, or a system prompt that implies the task is complete before it is. See our concept on Debugging Premature Loop Termination for the diagnostic checklist.

  2. Infinite loops caused by a tool that always returns an error the model cannot resolve, combined with no maximum-iteration guard. The exam consistently rewards adding a deterministic iteration cap over probabilistic retry logic when stakes are high.

The stop_reason Field Inspection concept covers the exact field values (tool_use, end_turn, max_tokens, stop_sequence) and what each implies for loop control.

How do multi-agent topologies appear on the exam?

The CCAR-F exam uses scenario-based items, and multi-agent scenarios are the most complex. Each sitting draws four scenarios at random from a bank of six, so you will almost certainly face at least one multi-agent orchestration scenario.

The dominant topology tested is hub-and-spoke: a coordinator agent receives the user request, decomposes it, delegates subtasks to specialised subagents, and synthesises results. The exam tests three specific failure modes within this topology:

  • Narrow decomposition failure: the coordinator assigns subtasks so tightly scoped that no subagent has enough context to handle edge cases. Our Narrow Decomposition Failure concept explains the diagnostic pattern.
  • Attribution loss in synthesis: when the coordinator merges subagent outputs, source provenance is dropped, making the final answer unverifiable.
  • Subagent context isolation: each subagent receives only the context it needs, not the full conversation. Violating this principle causes token waste and, in high-stakes workflows, security leakage.

Each agent should receive only the context, tools, and permissions necessary for its specific task.

Anthropic , Claude Documentation (Building effective agents)

The Hub-and-Spoke Architecture concept maps each of these failure modes to the task statements in Domain 1.

What does Domain 3 test about Claude Code configuration?

Domain 3 (Claude Code Configuration & Workflows, 20%) tests the three-level configuration hierarchy: project-level CLAUDE.md, user-level settings, and enterprise policy. The exam asks you to identify which level controls a given behaviour and what happens when levels conflict.

The most frequently tested sub-topics are:

  • Hooks: PreToolUse and PostToolUse hooks intercept tool calls programmatically. The exam distinguishes hooks from prompt-based instructions: hooks are deterministic and cannot be overridden by the model; prompt instructions are probabilistic and can be ignored under adversarial or ambiguous conditions. When the scenario involves compliance or audit requirements, the correct answer is almost always a hook, not a prompt instruction.

  • Slash commands and skills: custom slash commands let teams encode repeatable workflows. The exam tests when a skill is the right abstraction versus when a plain CLAUDE.md instruction suffices.

  • Version control implications: CLAUDE.md files committed to a repository apply to every contributor. The exam tests the security and consistency implications of this, particularly in CI/CD pipelines.

A fenced example of a minimal PostToolUse hook that normalises tool output before it re-enters the context:

python
# hooks/post_tool_use.py
import json, sys
def normalise(result: dict) -> dict:
# Strip internal metadata fields before Claude sees the result
return {k: v for k, v in result.items() if not k.startswith("_")}
if __name__ == "__main__":
raw = json.load(sys.stdin)
print(json.dumps(normalise(raw)))

The Three-Level Configuration Hierarchy concept covers the precedence rules in full.

How does tool design affect agent reliability?

Tool design (Domain 2, 18%) is where many candidates lose points they did not expect to lose. The exam does not ask you to write tool implementations; it asks you to diagnose why an agent is calling the wrong tool or mishandling an error.

The two highest-yield concepts are:

Tool descriptions as the selection mechanism. Claude selects tools based on their descriptions, not their names. A vague description causes misrouting. The fix is almost always a description rewrite, not a system prompt addition, because description changes are lower-effort and higher-leverage. The Tool Descriptions as Selection Mechanism concept has the exact rewrite pattern.

MCP error propagation. When an MCP tool fails, the isError flag must be set to true in the response. If it is not, Claude treats the error payload as a valid result and continues reasoning on bad data. The exam tests four error categories and the correct structured metadata for each.

json
{
"content": [
{
"type": "text",
"text": "Database connection timed out after 5000ms."
}
],
"isError": true
}

Returning isError: false with an error message in the content field is the most common wrong answer in Domain 2 scenarios.

What context management patterns does the exam test?

Domain 5 (Context Management & Reliability, 15%) tests what happens to agent performance as context windows fill. The core problem is the attention dilution problem: as the context grows, Claude's effective attention to early instructions weakens. The exam tests three mitigations:

MitigationWhen to useRisk if misapplied
Summary injection for fresh sessionsLong-running tasks that span multiple sessionsLoss of detail if summary is too compressed
Subagent context isolationParallel workstreams with independent dataCoordinator loses visibility into subagent state
Stale context detectionSessions where earlier facts may have changedFalse positives cause unnecessary resets

The exam rewards proportionate fixes. If the scenario describes a context that is 80% full with mostly irrelevant tool results, the correct answer is to trim tool results before they re-enter the context, not to start a fresh session and lose all accumulated state.

Prefer compact, structured summaries over raw conversation history when injecting prior context into a new session. Verbatim history consumes tokens without proportionate benefit.

Anthropic , Claude Documentation (Context windows)

How should you approach exam scenarios involving agent safety?

The CCAR-F exam consistently applies three principles when agent safety is at stake:

  1. Deterministic over probabilistic. When a constraint must hold without exception (compliance, data deletion, financial authorisation), implement it in a hook or a programmatic gate, not a prompt instruction.
  2. Proportionate fixes. Match the intervention to the severity of the failure. A tool that occasionally returns a stale result needs a cache-invalidation fix, not a full architecture redesign.
  3. Root-cause tracing. Scenarios describe symptoms. The correct answer identifies the root cause, not the most visible symptom. A loop that terminates early is a symptom; a missing tool description is a root cause.

These principles appear across all five domains and are the clearest signal of what the exam rewards. When two answer choices both fix the symptom, the one that addresses the root cause is correct.

How does our platform help you prepare for Claude Code agent scenarios?

AI Skill Certs is an independent adaptive prep platform (not affiliated with or endorsed by Anthropic). Our CCAR-F preparation includes:

  • 174 atomic concepts mapped to all five domains and 30 task statements, available at /concepts. Each concept is a standalone, testable unit of knowledge.
  • Practice exams that mirror the real format: 60 scenario-based items, scored 100 to 1000 with 720 as the passing bar.
  • Archie, our Socratic tutor, which guides you through agent scenarios with graduated hints rather than giving you the answer directly. This mirrors the diagnostic reasoning the exam rewards.
  • Bayesian Knowledge Tracing with a 0.90 mastery threshold, so the platform only advances you past a concept when your demonstrated accuracy justifies it.

For the agentic architecture domain specifically, the Agentic Architecture & Orchestration concept library covers every task statement in Domain 1, including the session management, decomposition, and hook patterns that appear most frequently in scenarios.

What is the fastest study path if you have two weeks?

A two-week plan that prioritises by exam weight:

WeekFocusDomains coveredTarget concepts
Week 1, days 1 to 3Agentic loop mechanics and multi-agent topologyDomain 1 (27%)Loop termination, hub-and-spoke, subagent isolation
Week 1, days 4 to 5Claude Code configuration and hooksDomain 3 (20%)Three-level hierarchy, PreToolUse/PostToolUse, version control
Week 1, days 6 to 7Prompt engineering and structured outputDomain 4 (20%)Goal-based prompts, schema design, few-shot patterns
Week 2, days 1 to 2Tool design and MCP integrationDomain 2 (18%)Tool descriptions, isError flag, error propagation
Week 2, days 3 to 4Context management and reliabilityDomain 5 (15%)Attention dilution, summary injection, stale context
Week 2, days 5 to 7Full practice exams and scenario reviewAll domainsTimed 60-item sets, score 100 to 1000

The CCAR-F credential is valid for 12 months from the date it is awarded, so there is no benefit to delaying your attempt once you are consistently passing practice exams.

Frequently asked questions

What is the passing score for the CCAR-F Claude Code architect exam?
The CCAR-F exam is scored on a scale of 100 to 1000, and the passing score is 720. Anthropic does not publish the raw-to-scaled conversion formula, so there is no reliable way to state an exact number of questions you must answer correctly. The score report shows your scaled score and percent-correct by domain.
How many questions are on the CCAR-F exam and how long do you have?
The CCAR-F exam has 60 items and a 120-minute time limit. All items are scenario-based, mixing multiple-choice and multiple-response formats. Each item states how many responses to select. The exam draws four scenarios at random from a bank of six at each sitting.
What is the difference between a hook and a prompt instruction in Claude Code agents?
A hook (PreToolUse or PostToolUse) intercepts tool calls programmatically and executes deterministically regardless of what the model reasons. A prompt instruction is probabilistic: the model may follow it inconsistently under ambiguous or adversarial conditions. The CCAR-F exam consistently selects hooks as the correct answer when a constraint must hold without exception, such as compliance or audit requirements.
How long is the Claude Certified Architect, Foundations credential valid?
The CCAR-F credential is valid for 12 months from the date it is awarded. Anthropic has not published renewal details beyond that window. Because the credential expires, candidates should plan their exam attempt to align with when they need the certification active, such as for a partner programme requirement or a job application.
Does AI Skill Certs have a concept library for the CCAR-F architect exam?
Yes. The AI Skill Certs concept library at /concepts covers 174 atomic concepts mapped to all five CCAR-F exam domains and 30 task statements. It is specific to the CCAR-F architect track. AI Skill Certs is an independent platform and is not affiliated with or endorsed by Anthropic.
What is the cost of the CCAR-F exam?
The Claude Certified Architect, Foundations exam (CCAR-F) costs $125 USD per attempt. Tiered Claude Partner Network partners receive a discounted first attempt. This is separate from the Claude Certified Associate, Foundations exam (CCAO-F), which costs $99, and the Claude Certified Architect, Professional exam (CCAR-P), which costs $175.

People also ask

What do Claude Code agents do?
Claude Code agents are autonomous processes that use Claude as a reasoning engine, call tools in a repeating loop, and act on real systems such as databases, APIs, or file systems. They continue the loop until the task is complete or a stopping condition fires, rather than returning a single text response.
How does the agentic loop work in Claude?
Claude receives a message, decides whether to call a tool or return a final answer, receives the tool result appended to the conversation, and repeats. The loop ends when Claude returns an end_turn stop reason or a programmatic guard fires. Premature termination and infinite loops are the two most common failure modes tested on the CCAR-F exam.
What is the CCAR-F exam format for Claude agent architects?
The CCAR-F exam has 60 scenario-based items, a 120-minute limit, and costs $125. It is scored 100 to 1000 with a passing mark of 720. Five domains cover agentic architecture, tool design, Claude Code configuration, prompt engineering, and context management, weighted from 15% to 27%.
What is hub-and-spoke architecture in Claude multi-agent systems?
Hub-and-spoke is a multi-agent topology where a coordinator agent receives the user request, decomposes it into subtasks, delegates each subtask to a specialised subagent, and synthesises the results. The CCAR-F exam tests failure modes including narrow decomposition, attribution loss in synthesis, and improper subagent context isolation.
How do MCP tools handle errors in Claude agent workflows?
MCP tools must set the isError flag to true in their response when a failure occurs. If isError is false but the content contains an error message, Claude treats the payload as a valid result and continues reasoning on bad data. The CCAR-F exam tests four error categories and the correct structured metadata for each.

About the author

Solomon Udoh

AI Architect & Certification Lead

Solomon Udoh is an AI Architect who designs and ships production agent systems on the Claude API and Claude Code. He built AI Skill Certs' adaptive engine and authored its 174-concept knowledge graph, mapping every Claude Certified Architect - Foundations objective to hands-on, exam-aligned practice.

  • Designs production multi-agent systems on the Claude API and Agent SDK
  • Author of the AI Skill Certs knowledge graph (174 mapped exam concepts)
  • Builds with MCP, Claude Code, structured outputs, and agentic loops daily
  • Reviews every concept page against the official Anthropic exam guide

You might also like

Ready to put it into practice?

Study every exam concept with an adaptive tutor.

Start studying