Exam guide·9 min read·1 July 2026

Claude Code Configuration: Master Domain 3 for CCA-F

Claude Code configuration is 20% of the CCA-F exam. Learn the three-level hierarchy, CLAUDE.md patterns, and workflow automation that the exam tests.

By Solomon Udoh · AI Architect & Certification Lead

Claude Code Configuration: Master Domain 3 for CCA-F

Domain 3 of the Claude Certified Architect, Foundations exam covers claude code configuration and workflows, and it carries a 20% weight, making it one of the four heaviest domains on the 60-question paper. If you are preparing for the CCA-F, this domain rewards engineers who understand how Claude Code is configured at multiple scopes, how those scopes interact, and how automated workflows are composed from that configuration. This post maps the domain systematically so you know exactly what to study.

What does Domain 3 actually test?

Domain 3 tests your ability to configure Claude Code correctly across different deployment contexts and to design workflows that are reproducible, version-controlled, and team-safe. Per Anthropic's exam guide, the domain sits alongside Prompt Engineering and Structured Output (also 20%) as a mid-weight area. The exam does not test trivia about flag names in isolation; it tests whether you can reason about which configuration scope to use, why, and what breaks when you choose the wrong one.

The five domain weights are worth keeping in front of you throughout your preparation:

DomainTopicWeight
1Agentic Architecture & Orchestration27%
2Tool Design & MCP Integration18%
3Claude Code Configuration & Workflows20%
4Prompt Engineering & Structured Output20%
5Context Management & Reliability15%

Domain 3 is not the heaviest, but a 20% domain that you under-prepare for costs you roughly 12 questions, which is enough to move a borderline candidate from a pass to a fail at the 720 scaled-score threshold.

What is the three-level configuration hierarchy?

The three-level configuration hierarchy is the structural backbone of Domain 3. Claude Code resolves configuration at three scopes: enterprise (system-level), project (repository-level), and personal (user-level). Each scope has a defined precedence, and the exam tests candidates on what happens at the boundaries.

Our Three-Level Configuration Hierarchy concept page covers this in full, but the practical summary is:

  1. Enterprise scope is set by administrators and cannot be overridden by lower scopes. It is appropriate for compliance requirements, approved model lists, and network proxy settings.
  2. Project scope lives in the repository, typically in a CLAUDE.md file or .claude/ directory. It travels with the codebase and applies to every team member who clones it.
  3. Personal scope is stored in the user's home directory. It is appropriate for individual preferences such as editor integration or personal API key routing, but it must never carry secrets that belong to the team.

The exam consistently rewards answers that place configuration at the lowest scope that satisfies the requirement. Putting a compliance rule in personal scope is wrong; putting a personal editor preference in enterprise scope is also wrong. Proportionate placement is the pattern.

How does CLAUDE.md work and why does it matter for teams?

CLAUDE.md is a markdown file placed at the root of a repository (or within subdirectories for path-scoped rules) that Claude Code reads as persistent project context. It is the primary mechanism for encoding project conventions, architectural constraints, and workflow instructions that should apply to every session a team member opens against that codebase.

A minimal but well-structured CLAUDE.md might look like this:

markdown
# Project: Payments Service
## Architecture conventions
- All external API calls go through `src/clients/`. Never call third-party APIs directly from handlers.
- Use structured logging via `logger.info({event, payload})`. No `console.log` in production paths.
## Testing
- Unit tests live in `__tests__/` adjacent to the module they test.
- Run `npm test -- --coverage` before committing. Coverage must not drop below 80%.
## Claude Code behaviour
- Do not modify `src/generated/` files. These are auto-generated from the OpenAPI spec.
- When suggesting refactors, prefer incremental changes over full rewrites.

The exam tests whether candidates understand that CLAUDE.md is version-controlled and therefore subject to the same review process as code. A change to CLAUDE.md that relaxes a constraint is a change that affects every engineer on the team. This is not a configuration file to edit casually.

Version control implications for CLAUDE.md are a distinct concept the exam probes. The key principle: because CLAUDE.md is committed to the repository, it inherits all the governance properties of source code, including code review, audit history, and branch protection rules.

How do path-scoped rules change behaviour in large codebases?

In a monorepo or a codebase with distinct subsystems, a single root-level CLAUDE.md can become unwieldy. Claude Code supports path-scoped CLAUDE.md files placed in subdirectories. When Claude Code operates on a file, it reads the CLAUDE.md files from the root down to the file's directory, merging them in order of specificity.

This matters for the exam in two ways. First, more specific rules override less specific ones, so a subdirectory CLAUDE.md can tighten (but should not silently contradict) a root-level rule. Second, the exam tests candidates on diagnosing misconfiguration: if a rule appears to have no effect, the first diagnostic step is to check whether a more specific CLAUDE.md is overriding it.

A common exam scenario: a root CLAUDE.md forbids direct database queries outside the src/db/ module, but a subdirectory CLAUDE.md for a legacy service does not repeat this constraint. The question asks what Claude Code will do when operating on files in that subdirectory. The answer is that the root constraint still applies unless the subdirectory file explicitly overrides it, because the merge is additive by default.

What workflow automation patterns does Domain 3 cover?

Beyond configuration files, Domain 3 covers how Claude Code is integrated into automated workflows, including CI/CD pipelines, pre-commit hooks, and non-interactive batch operations. The exam tests the -p flag (non-interactive mode), structured output from CI runs, and how to design workflows that are deterministic enough to run unattended.

Claude Code can be run in a fully non-interactive mode suitable for CI/CD pipelines, enabling automated code review, test generation, and documentation updates as part of a standard engineering workflow.

Anthropic , Claude Code Documentation

A representative CI workflow using the -p flag looks like this:

bash
# Run Claude Code in non-interactive mode to generate a test coverage report
claude -p "Review the diff in this PR and identify any functions that lack unit tests. Output a JSON array of {file, function, reason} objects." \
--output-format json \
> coverage-gaps.json

The exam does not ask you to memorise flag syntax verbatim, but it does ask you to reason about when non-interactive mode is appropriate versus when an interactive session is required. The rule of thumb the exam rewards: non-interactive mode is correct when the task is well-specified, the output format is deterministic, and no human judgement is needed mid-task. If any of those conditions fail, an interactive session or a human-in-the-loop checkpoint is the right answer.

For teams building CI pipelines around Claude Code, structured JSON output is the preferred format because it is parseable by downstream tools without brittle string matching. Our Claude Code Configuration & Workflows concept domain covers the full set of patterns the exam draws from.

How do skills and commands extend Claude Code for teams?

Claude Code supports two extension mechanisms that Domain 3 tests: skills (reusable prompt templates stored as .md files in a .claude/skills/ directory) and slash commands (shortcuts that invoke those skills or other predefined prompts). Together they allow teams to encode institutional knowledge into Claude Code in a way that is discoverable, version-controlled, and consistent across engineers.

The distinction the exam draws is between skills and CLAUDE.md entries. A CLAUDE.md entry is always active context; a skill is invoked on demand. Use CLAUDE.md for constraints and conventions that should apply to every interaction. Use skills for complex, multi-step tasks that engineers invoke occasionally, such as generating a migration script or producing a release notes draft.

text
.claude/
skills/
generate-migration.md
draft-release-notes.md
review-security.md
commands/
/migration -> generate-migration.md
/release -> draft-release-notes.md
/sec-review -> review-security.md

The exam tests whether candidates can identify when a skill should be split (because it is trying to do two distinct things) versus when it should be merged (because two skills always run together and splitting them creates coordination overhead). This mirrors the tool splitting for specificity principle from Domain 2, applied to the configuration layer.

How does Domain 3 connect to agentic workflows?

Domain 3 does not exist in isolation. The exam frequently presents scenarios that span Domain 3 (configuration) and Domain 1 (agentic architecture). A well-configured Claude Code environment is a prerequisite for reliable agentic workflows: if the project-level CLAUDE.md does not encode the right constraints, a subagent operating autonomously may violate architectural conventions that a human engineer would have caught interactively.

The connection runs in the other direction too. Agentic loop anti-patterns often trace back to configuration failures: a missing constraint in CLAUDE.md allows Claude Code to take an action that the loop was not designed to handle, causing the agent to stall or produce incorrect output. Diagnosing these failures requires understanding both the agentic architecture and the configuration layer.

When Claude operates as an agent, the configuration environment it inherits shapes every decision it makes autonomously. A misconfigured project scope is not a minor inconvenience; it is a reliability risk for any workflow that runs without human review at each step.

Anthropic , Claude Code Documentation

This cross-domain reasoning is exactly what the CCA-F exam is designed to test. The 60 scenario-based questions are not isolated knowledge checks; they are situations that require you to reason across domains. A candidate who has memorised Domain 3 facts but cannot connect them to Domain 1 agentic patterns will struggle with the multi-domain scenarios that appear throughout the paper.

How should you prepare for Domain 3 specifically?

Preparation for Domain 3 should be hands-on wherever possible. Reading about the three-level hierarchy is useful; actually creating a CLAUDE.md file, testing path-scoped overrides, and running Claude Code in non-interactive mode against a real codebase is more useful. The exam rewards candidates who have encountered the failure modes, not just the happy paths.

For structured concept review, our Claude Code Configuration & Workflows section maps all 174 atomic concepts in our library to the five exam domains. Domain 3 concepts include the three-level hierarchy, version control implications, path-scoped rules, CI/CD integration patterns, and the skills-versus-CLAUDE.md distinction.

For practice under exam conditions, our adaptive engine uses Bayesian Knowledge Tracing with a 0.90 mastery threshold. It will not mark you ready on a Domain 3 concept until you have demonstrated consistent correct reasoning across multiple scenario variants, not just a single correct answer. Practice exams are 60 questions, scored on the same 100 to 1000 scale as the real exam, with 720 as the passing bar. (AI Skill Certs is an independent prep platform; we are not affiliated with or endorsed by Anthropic.)

The CCA-F launched on 12 March 2026 at $99 per attempt. As of 3 June 2026, more than 10,000 individuals have earned the certification. With further architect, developer, and seller certifications planned for later in 2026, the CCA-F is the foundation credential in what Anthropic is building into a full certification programme. Getting Domain 3 right is not just about passing this exam; it is about building the configuration discipline that every subsequent Claude-based role will assume you have.

Frequently asked questions

How much of the CCA-F exam is about Claude Code configuration?
Domain 3, Claude Code Configuration and Workflows, carries a 20% weight on the CCA-F exam. With 60 questions on the paper, that represents roughly 12 questions. The domain covers the three-level configuration hierarchy, CLAUDE.md design, path-scoped rules, CI/CD integration, and the distinction between skills and persistent project context.
What is the difference between CLAUDE.md and a Claude Code skill file?
CLAUDE.md provides always-active project context: conventions, constraints, and architectural rules that apply to every Claude Code session in that repository. A skill file is a reusable prompt template stored in .claude/skills/ and invoked on demand via a slash command. Use CLAUDE.md for persistent constraints; use skills for complex, occasional tasks.
Can CLAUDE.md files be version-controlled?
Yes, and this is a key exam concept. CLAUDE.md files committed to a repository inherit all the governance properties of source code: code review, audit history, and branch protection rules. A change to CLAUDE.md that relaxes a constraint affects every engineer on the team, so it should go through the same review process as any other code change.
What is the three-level configuration hierarchy in Claude Code?
Claude Code resolves configuration at three scopes in order of precedence: enterprise (administrator-set, cannot be overridden), project (repository-level, travels with the codebase via CLAUDE.md), and personal (user-level, stored in the home directory). The exam rewards placing configuration at the lowest scope that satisfies the requirement.
When should Claude Code be run in non-interactive mode?
Non-interactive mode (the -p flag) is appropriate when the task is well-specified, the output format is deterministic, and no human judgement is needed mid-task. It is the correct choice for CI/CD pipelines, automated code review, and batch documentation generation. If any of those conditions fail, an interactive session or a human-in-the-loop checkpoint is the right design.
How does path-scoped CLAUDE.md work in a monorepo?
Claude Code reads CLAUDE.md files from the repository root down to the directory of the file being worked on, merging them in order of specificity. More specific (deeper) rules override less specific ones. Root-level constraints still apply in subdirectories unless explicitly overridden, so a missing constraint in a subdirectory CLAUDE.md does not cancel the root-level rule.

People also ask

What is Claude Code used for?
Claude Code is Anthropic's AI-powered coding tool that operates directly in a developer's terminal. It reads codebases, writes and edits files, runs tests, and executes commands. It can be configured via CLAUDE.md files for team-wide conventions and run non-interactively in CI/CD pipelines for automated code review and test generation.
How do I configure Claude Code for a team project?
Place a CLAUDE.md file at the repository root encoding architectural conventions, testing requirements, and behavioural constraints. This file is version-controlled and applies to every team member. For subdirectory-specific rules in a monorepo, add path-scoped CLAUDE.md files. Enterprise-wide settings are managed at the administrator scope and cannot be overridden by project or personal configuration.
Does the CCA-F exam test Claude Code configuration?
Yes. Domain 3, Claude Code Configuration and Workflows, carries 20% of the CCA-F exam weight, equivalent to roughly 12 of the 60 scenario-based questions. The domain covers the three-level configuration hierarchy, CLAUDE.md design, path-scoped rules, version control implications, CI/CD integration, and the skills-versus-persistent-context distinction.
What is a CLAUDE.md file?
CLAUDE.md is a markdown file placed in a repository that Claude Code reads as persistent project context. It encodes conventions, architectural constraints, and workflow instructions that apply to every session. Because it is version-controlled, changes to it go through the same code review process as any other source file, making it a governance artefact as much as a configuration file.
How is Claude Code different from the Claude API?
The Claude API is a programmatic interface for building applications that call Claude models. Claude Code is a terminal-based coding assistant that uses the API under the hood but adds file system access, shell execution, and a configuration layer (CLAUDE.md, skills, commands). The CCA-F exam tests both, with Claude Code configuration covered in Domain 3 and API design patterns across Domains 1, 2, and 4.

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