65 entries

Claude Guides

Read practical Claude guides and AI workflow walkthroughs covering setup, implementation steps, troubleshooting, and source-backed recommendations.

Browse & filter all Guides

Quick start

Scan prerequisites first.
Follow the guide steps in order.
Use troubleshooting notes before adapting the workflow.

Top Guides

Auditing MCP Client Configuration Before Team Rollout

Audit MCP client configuration before sharing it with a team.

Review firstSource-backedReview firstAdded 3d ago

Safety ✓ Privacy ✓

Publishing An MCP Server To The Official Registry

Publish public MCP server metadata with mcp-publisher and server.json.

Review firstSource-backedReview firstAdded 3d ago

Safety ✓ Privacy ✓

Adding Plugin Install Hints to Developer CLIs

Emit the claude-code-hint marker from your CLI so Claude Code prompts users to install your official plugin, gated on CLAUDECODE.

Review firstSource-backedReview firstAdded 8d ago

Safety ✓ Privacy ✓

Agent Skills in Claude Agent SDK Applications

Use Agent Skills in the Claude Agent SDK: filesystem discovery via settingSources, the skills option to enable or filter, and tool access.

Review firstSource-backedReview firstAdded 8d ago

Safety ✓ Privacy ✓

Building a Claude Code Plugin Marketplace

Create and distribute a Claude Code plugin marketplace with marketplace.json, git hosting, private repos, and /plugin marketplace add.

Review firstSource-backedReview firstAdded 8d ago

Safety ✓ Privacy ✓

Building In-Process MCP Tools with the Claude Agent SDK

Define in-process MCP tools for the Claude Agent SDK with createSdkMcpServer and the tool helper, then wire them into query.

Review firstSource-backedReview firstAdded 8d ago

Safety ✓ Privacy ✓

Channels and Webhooks into Running Claude Code Sessions

Push messages, alerts, and webhooks into a running Claude Code session with channels, with sender allowlists and enterprise controls.

Review firstSource-backedReview firstAdded 8d ago

Safety ✓ Privacy ✓

Checkpointing Claude Code Changes Before Risky Refactors

Use Claude Code checkpoints to rewind code and conversation with /rewind before risky refactors, and know what they do not track.

Review firstSource-backedReview firstAdded 8d ago

Safety ✓ Privacy ✓

Claude Code Output Styles Without Losing Coding Instructions

Use Claude Code output styles without weakening coding behavior.

Review firstSource-backedReview firstAdded 8d ago

Safety ✓ Privacy ✓

Claude Code Subagent MCP Scope Guide

Scope MCP servers and permissions cleanly for Claude Code subagents.

Review firstSource-backedReview firstAdded 8d ago

Safety ✓ Privacy ✓

CLAUDE.md Hierarchy for Monorepos and Nested Packages

Structure CLAUDE.md across a monorepo: load order, nested files, path-scoped rules, imports, and excluding other teams' files.

Review firstSource-backedReview firstAdded 8d ago

Safety ✓ Privacy ✓

Cost Tracking for Claude Agent SDK Applications

Track token usage and cost in the Claude Agent SDK via the result message estimate, per-step/per-model usage, and cache tokens.

Review firstSource-backedReview firstAdded 8d ago

Safety ✓ Privacy ✓

Deep Links into Claude Code Runbooks and Alerts

Build claude-cli:// deep links that open Claude Code in the right repo with a prepared prompt, for runbooks, alerts, and dashboards.

Review firstSource-backedReview firstAdded 8d ago

Safety ✓ Privacy ✓

External Session Storage for Claude Agent SDK Hosts

Mirror Claude Agent SDK session transcripts to S3, Redis, or a database with a SessionStore so any host can resume them.

Review firstSource-backedReview firstAdded 8d ago

Safety ✓ Privacy ✓

File Checkpointing in Claude Agent SDK Workflows

Use file checkpointing in the Claude Agent SDK: enable it, capture checkpoint UUIDs, and rewind files by resuming the session.

Review firstSource-backedReview firstAdded 8d ago

Safety ✓ Privacy ✓

Headless Claude Code Automation from Scripts and CI

Run Claude Code non-interactively with claude -p: bare mode, JSON output, piping, tool auto-approval, and CI authentication.

Review firstSource-backedReview firstAdded 8d ago

Safety ✓ Privacy ✓

MCP OAuth Token Audience Checklist

Review remote MCP OAuth and token-audience handling before connecting clients.

Review firstSource-backedReview firstAdded 8d ago

Safety ✓ Privacy ✓

MCP Protected Resource Metadata Verification Guide

Verify MCP resource metadata and token audience handling before connecting remote servers.

Review firstSource-backedReview firstAdded 8d ago

Safety ✓ Privacy ✓

OpenAI Agents Trace to Eval Regression Guide

Turn OpenAI agent traces into repeatable regression evals.

Review firstSource-backedReview firstAdded 8d ago

Safety ✓ Privacy ✓

OpenTelemetry Observability for Claude Agent SDK Agents

Export OpenTelemetry traces, metrics, and events from the Claude Agent SDK with OTLP, and control what content is exported.

Review firstSource-backedReview firstAdded 8d ago

Safety ✓ Privacy ✓

Permission Design for Claude Agent SDK Agents

Design permissions for Claude Agent SDK agents: evaluation order, allow/deny rules, permission modes, and the canUseTool callback.

Review firstSource-backedReview firstAdded 8d ago

Safety ✓ Privacy ✓

Permission Modes for Claude Code Teams

Understand and govern Claude Code permission modes across a team, from default to auto and bypass, with managed-settings controls.

Review firstSource-backedReview firstAdded 8d ago

Safety ✓ Privacy ✓

Playwright Trace Viewer AI Debugging Guide

Use Playwright Trace Viewer evidence instead of guesswork when debugging UI failures with AI.

Review firstSource-backedReview firstAdded 8d ago

Safety ✓ Privacy ✓

Plugins in Claude Agent SDK Deployments

Load local plugins in the Claude Agent SDK via the plugins option, verify them in the init message, and invoke namespaced plugin skills.

Review firstSource-backedReview firstAdded 8d ago

Safety ✓ Privacy ✓

See all 65 Guides →

Frequently asked

What are Claude Guides?: Long-form guides and practical walkthroughs.
How do I use Guides from HeyClaude?: Use guides as reference docs and implementation walkthroughs, not as standalone assets.
Are HeyClaude Guides reviewed before they are listed?: Each entry is metadata-reviewed for source, trust, and safety/privacy signals before it appears. HeyClaude does not scan for malware, so always review the linked source before installing anything that touches your filesystem, network, or credentials.

New Guides, weekly

A short, calm digest of reviewed Claude resources. Unsubscribe any time.