Skip to content

01-getting-started.md

Latest commit

 

History

History
188 lines (127 loc) · 6.21 KB

01-getting-started.md

File metadata and controls

188 lines (127 loc) · 6.21 KB
layout default
title Chapter 1: Getting Started
nav_order 1
parent Claude Quickstarts Tutorial

Chapter 1: Getting Started

Welcome to Chapter 1: Getting Started. In this part of Claude Quickstarts Tutorial: Production Integration Patterns, you will build an intuitive mental model first, then move into concrete implementation details and practical production tradeoffs.

This chapter sets up the quickstarts repository and helps you pick the right project first.

Clone and Install

git clone https://github.com/anthropics/anthropic-quickstarts.git
cd anthropic-quickstarts

Each quickstart may have its own dependencies. Follow the local README in each project folder.

Configure Credentials

export ANTHROPIC_API_KEY="your_api_key_here"

Choosing Your First Quickstart

  • Start with Customer Support for straightforward chat workflows.
  • Pick Data Analyst for structured outputs and visualization.
  • Use Browser/Computer Use only when automation control is required.

Success Criteria

  • Project boots locally.
  • API credentials are loaded securely.
  • First request to Claude succeeds.

Summary

You now have a working local setup and a clear path for selecting a starter quickstart.

Next: Chapter 2: Customer Support Agents

What Problem Does This Solve?

Most teams struggle here because the hard part is not writing more code, but deciding clear boundaries for anthropic, quickstarts, clone so behavior stays predictable as complexity grows.

In practical terms, this chapter helps you avoid three common failures:

  • coupling core logic too tightly to one implementation path
  • missing the handoff boundaries between setup, execution, and validation
  • shipping changes without clear rollback or observability strategy

After working through this chapter, you should be able to reason about Chapter 1: Getting Started as an operating subsystem inside Claude Quickstarts Tutorial: Production Integration Patterns, with explicit contracts for inputs, state transitions, and outputs.

Use the implementation notes around https, github, anthropics as your checklist when adapting these patterns to your own repository.

How it Works Under the Hood

Under the hood, Chapter 1: Getting Started usually follows a repeatable control path:

  1. Context bootstrap: initialize runtime config and prerequisites for anthropic.
  2. Input normalization: shape incoming data so quickstarts receives stable contracts.
  3. Core execution: run the main logic branch and propagate intermediate state through clone.
  4. Policy and safety checks: enforce limits, auth scopes, and failure boundaries.
  5. Output composition: return canonical result payloads for downstream consumers.
  6. Operational telemetry: emit logs/metrics needed for debugging and performance tuning.

When debugging, walk this sequence in order and confirm each stage has explicit success/failure conditions.

Source Walkthrough

Use the following upstream sources to verify implementation details while reading this chapter:

Suggested trace strategy:

  • search upstream code for anthropic and quickstarts to map concrete implementation paths
  • compare docs claims against actual runtime/config code before reusing patterns in production

Chapter Connections

Depth Expansion Playbook

Source Code Walkthrough

agents/agent.py

The from class in agents/agent.py handles a key part of this chapter's functionality:

import asyncio
import os
from contextlib import AsyncExitStack
from dataclasses import dataclass
from typing import Any

from anthropic import Anthropic

from .tools.base import Tool
from .utils.connections import setup_mcp_connections
from .utils.history_util import MessageHistory
from .utils.tool_util import execute_tools


@dataclass
class ModelConfig:
    """Configuration settings for Claude model parameters."""

    # Available models include:
    # - claude-sonnet-4-20250514 (default)
    # - claude-opus-4-20250514
    # - claude-haiku-4-5-20251001
    # - claude-3-5-sonnet-20240620
    # - claude-3-haiku-20240307
    model: str = "claude-sonnet-4-20250514"
    max_tokens: int = 4096
    temperature: float = 1.0
    context_window_tokens: int = 180000


class Agent:
    """Claude-powered agent with tool use capabilities."""

This class is important because it defines how Claude Quickstarts Tutorial: Production Integration Patterns implements the patterns covered in this chapter.

agents/agent.py

The class class in agents/agent.py handles a key part of this chapter's functionality:

import os
from contextlib import AsyncExitStack
from dataclasses import dataclass
from typing import Any

from anthropic import Anthropic

from .tools.base import Tool
from .utils.connections import setup_mcp_connections
from .utils.history_util import MessageHistory
from .utils.tool_util import execute_tools


@dataclass
class ModelConfig:
    """Configuration settings for Claude model parameters."""

    # Available models include:
    # - claude-sonnet-4-20250514 (default)
    # - claude-opus-4-20250514
    # - claude-haiku-4-5-20251001
    # - claude-3-5-sonnet-20240620
    # - claude-3-haiku-20240307
    model: str = "claude-sonnet-4-20250514"
    max_tokens: int = 4096
    temperature: float = 1.0
    context_window_tokens: int = 180000


class Agent:
    """Claude-powered agent with tool use capabilities."""

This class is important because it defines how Claude Quickstarts Tutorial: Production Integration Patterns implements the patterns covered in this chapter.

How These Components Connect

flowchart TD
    A[from]
    B[class]
    A --> B
Loading