Skip to main content
Showing 30 of 63 resources in guides
Saved
Active
Guides. Practical guides and playbooks
guidesReview firstSource-backedReview firstClaude Code

Adding Plugin Install Hints to Developer CLIs

by JPette1783

A practical walkthrough of emitting the claude-code-hint marker from your CLI so Claude Code prompts users to install your official plugin: the hint format, gating on CLAUDECODE, where to emit it, and the official-marketplace requirement.

Safety Privacy
guidesReview firstSource-backedReview firstClaude Code

Agent Skills in Claude Agent SDK Applications

by JPette1783

A practical walkthrough of using Agent Skills in the Claude Agent SDK: how skills are discovered from the filesystem via settingSources, the skills option to enable or filter them, tool access, and troubleshooting discovery.

Safety Privacy
guidesReview firstSource-backedReview firstClaude Code

Building a Claude Code Plugin Marketplace

by JPette1783

A practical walkthrough of creating and distributing a Claude Code plugin marketplace: the marketplace.json catalog, hosting on a git repository, adding it with /plugin marketplace add, private repositories, and how users install and update plugins.

Safety Privacy
guidesReview firstSource-backedReview firstClaude Code

Building In-Process MCP Tools with the Claude Agent SDK

by JPette1783

A practical walkthrough of defining in-process custom tools for the Claude Agent SDK with createSdkMcpServer and the tool helper, wiring them into query via mcpServers, allowing them, error handling, and returning images or structured data.

Safety Privacy
guidesReview firstSource-backedReview firstClaude Code

Channels and Webhooks into Running Claude Code Sessions

by JPette1783

A practical walkthrough of Claude Code channels: how an MCP-server channel pushes messages, alerts, and webhooks into a running session, how to install and enable Telegram, Discord, or iMessage, sender allowlists, and enterprise controls.

Safety Privacy
guidesReview firstSource-backedReview firstClaude Code

Checkpointing Claude Code Changes Before Risky Refactors

by JPette1783

A practical walkthrough of Claude Code checkpointing: how automatic checkpoints capture code before each edit, how to rewind and summarize with /rewind, the difference between restore and summarize, and the limitations you must know before a risky refactor.

Safety Privacy
guidesReview firstSource-backedReview firstClaude Code

Claude Code Output Styles Without Losing Coding Instructions

by JSONbored

A practical Claude Code guide for using output styles, keeping software engineering behavior intact, choosing the right settings scope, and avoiding durable-instruction drift.

Safety Privacy
guidesReview firstSource-backedReview firstClaude Code

Claude Code Subagent MCP Scope Guide

by JSONbored

Source-backed guide for scoping MCP servers, tools, permissions, hooks, and memory when building Claude Code subagents for focused review, research, and implementation workflows.

Safety Privacy
guidesReview firstSource-backedReview firstClaude Code

CLAUDE.md Hierarchy for Monorepos and Nested Packages

by JPette1783

A practical walkthrough of structuring CLAUDE.md across a monorepo: how files load up the directory tree and on demand in subdirectories, path-scoped rules, imports, excluding other teams' files, and keeping per-package context lean.

Safety Privacy
guidesReview firstSource-backedReview firstClaude Code

Cost Tracking for Claude Agent SDK Applications

by JPette1783

A practical walkthrough of tracking token usage and cost in the Claude Agent SDK: the result message total_cost_usd estimate, per-step and per-model usage, deduplicating parallel tool calls, accumulating across calls, and cache tokens.

Safety Privacy
guidesReview firstSource-backedReview firstClaude Code

Deep Links into Claude Code Runbooks and Alerts

by JPette1783

A practical walkthrough of Claude Code deep links: the claude-cli:// URL scheme, how to build links with repo, cwd, and prompt parameters, embedding them in runbooks and alerts, and the safety model where prompts are inert until you press Enter.

Safety Privacy
guidesReview firstSource-backedReview firstClaude Code

External Session Storage for Claude Agent SDK Hosts

by JPette1783

A practical walkthrough of mirroring Claude Agent SDK session transcripts to external storage: the SessionStore interface, the SessionKey shape, resuming across hosts, reference adapters for S3/Redis/Postgres, and behavior notes.

Safety Privacy
guidesReview firstSource-backedReview firstClaude Code

File Checkpointing in Claude Agent SDK Workflows

by JPette1783

A practical walkthrough of file checkpointing in the Claude Agent SDK: enabling it, capturing checkpoint UUIDs from user messages, rewinding files by resuming the session, multiple restore points, and the limitations you must know.

Safety Privacy
guidesReview firstSource-backedReview firstClaude Code

Headless Claude Code Automation from Scripts and CI

by JPette1783

A practical walkthrough of running Claude Code non-interactively with claude -p: bare mode, output formats (text, json, stream-json), JSON schema output, piping stdin, auto-approving tools, and authentication for scripts and CI.

Safety Privacy
guidesReview firstSource-backedReview firstClaude Code

MCP OAuth Token Audience Checklist

by JSONbored

Practical checklist for reviewing remote MCP server authorization, resource indicators, bearer-token handling, HTTPS transport, PKCE, and token passthrough risks before connecting an AI client.

Safety Privacy
guidesReview firstSource-backedReview firstClaude Code

MCP Protected Resource Metadata Verification Guide

by JSONbored

Practical guide for checking MCP protected resource metadata, authorization server discovery, resource indicators, token audience binding, and 401 challenge behavior before trusting a remote MCP server.

Safety Privacy
guidesReview firstSource-backedReview firstClaude Code

OpenAI Agents Trace to Eval Regression Guide

by JSONbored

Source-backed guide for converting OpenAI Agents SDK traces into regression eval cases, trace grades, tool-call assertions, and release checks for agentic workflows.

Safety Privacy
guidesReview firstSource-backedReview firstClaude Code

OpenTelemetry Observability for Claude Agent SDK Agents

by JPette1783

A practical walkthrough of exporting OpenTelemetry traces, metrics, and events from the Claude Agent SDK: enabling telemetry, configuring OTLP exporters, reading agent spans, linking traces to your app, and controlling sensitive data.

Safety Privacy
guidesReview firstSource-backedReview firstClaude Code

Permission Design for Claude Agent SDK Agents

by JPette1783

A practical walkthrough of permission design in the Claude Agent SDK: the evaluation order (hooks, deny, mode, allow, canUseTool), allow/deny rules, permission modes, the canUseTool callback, and locking down an agent.

Safety Privacy
guidesReview firstSource-backedReview firstClaude Code

Permission Modes for Claude Code Teams

by JPette1783

A practical walkthrough of Claude Code permission modes for teams: what each mode allows, how to switch and default them, protected paths, and how administrators enforce or lock modes with managed settings.

Safety Privacy
guidesReview firstSource-backedReview firstClaude Code

Playwright Trace Viewer AI Debugging Guide

by JSONbored

Source-backed guide for using Playwright traces, screenshots, snapshots, network events, console logs, and action timelines as evidence for AI-assisted frontend debugging.

Safety Privacy
guidesReview firstSource-backedReview firstClaude Code

Plugins in Claude Agent SDK Deployments

by JPette1783

A practical walkthrough of loading local plugins in the Claude Agent SDK: the plugins option with type local and a path, what plugins bundle (skills, agents, hooks, MCP servers), verifying loads via the init message, and invoking namespaced plugin skills.

Safety Privacy
guidesReview firstSource-backedReview firstClaude Code

Resuming, Branching, and Naming Claude Code Sessions

by JPette1783

A practical walkthrough of managing Claude Code sessions: resuming with --continue, --resume, and --from-pr, naming sessions, using the session picker, branching to try a different approach, and where transcripts are stored.

Safety Privacy
guidesReview firstSource-backedReview firstClaude Code

Secure Deployment for Claude Agent SDK Applications

by JPette1783

A practical walkthrough of securely deploying Claude Agent SDK applications: the prompt-injection threat model, isolation options (sandbox runtime, containers, gVisor, VMs), least privilege, the proxy credential pattern, and filesystem controls.

Safety Privacy
guidesReview firstSource-backedReview firstClaude Code

Slash Commands in Claude Agent SDK Sessions

by JPette1783

A practical walkthrough of using slash commands in the Claude Agent SDK: discovering available commands from the init message, sending commands in the prompt, built-in commands like compact and clear, and defining custom commands on the filesystem.

Safety Privacy
guidesReview firstSource-backedReview firstClaude Code

Streaming Output from Claude Agent SDK Agents

by JPette1783

A practical walkthrough of real-time streaming in the Claude Agent SDK: enabling partial messages, reading StreamEvent text and tool-call deltas, the message flow, and building a streaming UI.

Safety Privacy
guidesReview firstSource-backedReview firstClaude Code

Structured Output from Claude Agent SDK Workflows

by JPette1783

A practical walkthrough of structured outputs in the Claude Agent SDK: defining a JSON Schema via the outputFormat option, reading validated structured_output, type-safe schemas with Zod or Pydantic, and handling validation failures.

Safety Privacy
guidesReview firstSource-backedReview firstClaude Code

Subagents in Claude Agent SDK Applications

by JPette1783

A practical walkthrough of subagents in the Claude Agent SDK: defining them programmatically with the agents option and AgentDefinition, context isolation, parallelization, tool restrictions, invocation, and resuming.

Safety Privacy
guidesReview firstSource-backedReview firstClaude Code

Terminal, Tmux, and Vim Setup for Claude Code

by JPette1783

A practical walkthrough for configuring your terminal to work well with Claude Code: multiline newlines and Shift+Enter, the /terminal-setup command, tmux passthrough and extended keys, notifications, and Vim editor mode.

Safety Privacy
guidesReview firstSource-backedReview firstClaude Code

Using the Context Window Simulator for Prompt Design

by JPette1783

A practical walkthrough of the Claude Code context window explorer: what consumes context (system prompt, memory, CLAUDE.md, MCP tools, skills, file reads, history), how each loads, and how to use it plus /context to design leaner prompts and setups.

Safety Privacy