Anthropic Hello World

Overview

Send your first message to Claude and get a response using the Messages API.

Prerequisites

• Completed

  clade-install-auth

  setup

• ANTHROPIC_API_KEY

  environment variable set

Instructions

Step 1: Basic Message

import Anthropic from '@claude-ai/sdk';

const client = new Anthropic();

const message = await client.messages.create({
  model: 'claude-sonnet-4-20250514',
  max_tokens: 1024,
  messages: [
    { role: 'user', content: 'What is the capital of France?' }
  ],
});

console.log(message.content[0].text);
// "The capital of France is Paris."

Step 2: Add a System Prompt

const message = await client.messages.create({
  model: 'claude-sonnet-4-20250514',
  max_tokens: 1024,
  system: 'You are a helpful geography expert. Be concise.',
  messages: [
    { role: 'user', content: 'What is the capital of France?' }
  ],
});

Step 3: Multi-Turn Conversation

const message = await client.messages.create({
  model: 'claude-sonnet-4-20250514',
  max_tokens: 1024,
  messages: [
    { role: 'user', content: 'What is the capital of France?' },
    { role: 'assistant', content: 'The capital of France is Paris.' },
    { role: 'user', content: 'What is its population?' },
  ],
});

Python Example

import anthropic

client = anthropic.Anthropic()

message = client.messages.create(
    model="claude-sonnet-4-20250514",
    max_tokens=1024,
    messages=[
        {"role": "user", "content": "What is the capital of France?"}
    ],
)
print(message.content[0].text)

Output

• message.content[0].text

  — Claude's text response

• message.model

  — model ID used

• message.usage.input_tokens

  /

  message.usage.output_tokens

  — token counts

• message.stop_reason

  —

  end_turn

  ,

  max_tokens

  , or

  tool_use

Error Handling

authentication_error

ANTHROPIC_API_KEY

invalid_request_error

messages

max_tokens

not_found_error

claude-sonnet-4-20250514

Available Models

claude-opus-4-20250514

claude-sonnet-4-20250514

claude-haiku-4-5-20251001

Examples

See Step 1 (basic message), Step 2 (system prompt), and Step 3 (multi-turn) above. Python example included in its own section.

Resources

• Messages API Reference
• Model Overview

Next Steps

Proceed to

clade-model-inference