Claude Code setup

Claude Code is Anthropic’s official CLI tool. This guide shows how to configure it with the approved repo governance layout for Livepeer Docs.

Canonical Repo Governance

• Repo-wide baseline: AGENTS.md
• Native Claude adapter: .claude/CLAUDE.md
• Canonical governance docs:
  • docs-guide/policies/agent-governance-framework.mdx
  • docs-guide/policies/root-allowlist-governance.mdx

Keep the Claude adapter minimal. Shared repo policy belongs in AGENTS.md, not duplicated in the Claude-specific file.

Prerequisites

• Active Claude subscription (Pro, Max, or API access)

Setup

1. Install Claude Code globally:

npm install -g @anthropic-ai/claude-code

2. Navigate to your docs directory.
3. Create the Claude adapter directory:

mkdir -p .claude

4. Add .claude/CLAUDE.md.
5. Run claude to start.

Adapter Content Guidelines

• Read AGENTS.md first for repo-wide rules.
• Use .claude/CLAUDE.md only for Claude-specific workflow notes or memory hints.
• Link back to the canonical governance docs instead of restating the full repo contract.
• For this repo’s canonical layout, prefer .claude/CLAUDE.md over a root CLAUDE.md.

Minimal Starter

Create .claude/CLAUDE.md with a minimal adapter, for example:

# Claude Code adapter

Read `AGENTS.md` first for repo-wide rules.

This file is reserved for Claude-specific adapter notes only.

Canonical governance:
- `docs-guide/policies/agent-governance-framework.mdx`
- `docs-guide/policies/root-allowlist-governance.mdx`