TL;DR
- The Claude API lets you use Claude programmatically — in your own apps, scripts, or automated workflows.
- You need an Anthropic account and an API key to get started. The key goes in your request headers.
- You can send your first request with a simple curl command — no complex setup required.
- API usage is billed per token (input + output). It is separate from your Claude.ai subscription.
- Python is the easiest language to start with using Anthropic’s official SDK.
The Claude API opens up everything a Claude.ai subscription does not — you can build Claude into your own tools, automate workflows, process thousands of documents, and integrate Claude into websites and apps. This tutorial walks you through everything from getting your API key to sending your first real request, even if you have never used an API before.
What Is the Claude API?
An API (Application Programming Interface) is a way for software to communicate with other software. The Claude API is Anthropic’s official way for developers and builders to send messages to Claude and receive responses programmatically — from code, rather than from the Claude.ai interface.
With the Claude API you can: process text at scale (summarising hundreds of articles automatically), build Claude-powered features into your own website or app, create automated workflows that run without you being present, integrate Claude with databases, spreadsheets, or other tools, and use Claude models directly in your code with full control over parameters.
The API is a paid service billed per token — separate from any Claude.ai subscription you might have. You pay for what you use, with no monthly minimum.
How to Get Your Claude API Key
Your API key is the credential that authenticates your requests to Claude. Here is how to get one:
- Go to console.anthropic.com and sign in (or create a free Anthropic account).
- Click on API Keys in the left sidebar.
- Click Create Key, give it a name (e.g., “My First Project”), and click Create API Key.
- Copy the key immediately — Anthropic only shows it once. Store it somewhere safe like a password manager.
- Add a payment method under Billing to enable API usage. You can set a monthly spending limit to control costs.
Never share your API key publicly or commit it to a GitHub repository. Anyone with your key can make API calls billed to your account.
Your First Claude API Request (No Coding Required)
The simplest way to test your API key is with a curl command in your terminal (Mac/Linux) or Command Prompt (Windows). Copy this command, replace YOUR_API_KEY with your actual key, and run it:
curl https://api.anthropic.com/v1/messages -H "x-api-key: YOUR_API_KEY" -H "anthropic-version: 2023-06-01" -H "content-type: application/json" -d '{
"model": "claude-sonnet-4-6",
"max_tokens": 1024,
"messages": [
{"role": "user", "content": "Hello, Claude! What can you help me with?"}
]
}'If your key is valid and billing is set up, Claude will respond with a JSON object containing its reply. You have just made your first API call.
How to Use the Claude API with Python
Python is the easiest language to work with for Claude API beginners. Anthropic provides an official Python SDK that handles the technical details for you. Here is how to get started:
Step 1: Install the SDK
pip install anthropicStep 2: Write your first script
import anthropic
client = anthropic.Anthropic(api_key="YOUR_API_KEY")
message = client.messages.create(
model="claude-sonnet-4-6",
max_tokens=1024,
messages=[
{"role": "user", "content": "Summarise this in 3 bullet points: [your text here]"}
]
)
print(message.content[0].text)Replace YOUR_API_KEY with your actual key and run the script. Claude’s response will print in your terminal. This is the foundation for any Claude API project — everything builds on this basic structure.
Best practice: Instead of putting your API key directly in the script, store it in an environment variable and read it with os.environ.get("ANTHROPIC_API_KEY"). This keeps your key out of your code files.
Understanding Claude API Pricing
Claude API usage is billed per million tokens (a token is roughly 3-4 characters of text). Pricing varies by model:
| Model | Input (per 1M tokens) | Output (per 1M tokens) |
|---|---|---|
| Claude Haiku 4.5 | $1.00 | $5.00 |
| Claude Sonnet 4.6 | $3.00 | $15.00 |
| Claude Opus 4.8 | $5.00 | $25.00 |
For context: a typical 800-word blog post is about 1,000-1,200 tokens. At Sonnet pricing, generating 1,000 blog posts would cost roughly $18-$22 in output tokens — much cheaper than most content writing services.
For most beginners running small scripts and experiments, API costs start very low — often a few cents per day. Set a spending limit in the Anthropic console when you start to avoid unexpected charges.
Key Claude API Concepts for Beginners
Model: Which Claude version to use. For most tasks, claude-sonnet-4-6 is the best balance of quality and cost. Use claude-haiku-4-5 for speed and volume, claude-opus-4-8 for maximum intelligence.
Max tokens: The maximum length of Claude’s response. Set this based on how long you need the response to be. 1024 tokens is about 750 words — enough for most use cases.
System prompt: Standing instructions that apply to the whole conversation. In the API, you pass this as a “system” parameter alongside your messages. This is the same concept as Claude system prompts in the Projects interface.
Messages array: The conversation history. Each message has a “role” (user or assistant) and “content” (the text). Multi-turn conversations are built by appending messages to this array.
Temperature: Controls how creative or consistent Claude’s responses are. Lower values (0.0-0.3) produce more predictable, factual responses. Higher values (0.7-1.0) produce more creative, varied responses.
Frequently Asked Questions About the Claude API
Do I need a Claude Pro subscription to use the API?
No. The Claude API is a completely separate product from Claude.ai subscriptions. You access it through console.anthropic.com with its own billing. A Claude Pro subscription does not give you API access, and API access does not give you a Claude.ai Pro subscription.
Is there a free tier for the Claude API?
Anthropic occasionally offers free trial credits for new accounts, but there is no permanent free tier. You need to add a payment method and pay per token used.
Which Claude model should I use for the API?
Start with claude-sonnet-4-6 for most tasks. Switch to claude-haiku-4-5 if you need faster responses or lower costs, or to claude-opus-4-8 if quality is critical and cost is not a constraint. For a full comparison, read our Claude models guide.
Can I use the Claude API without knowing how to code?
The raw API requires some technical knowledge, but no-code tools like Make (formerly Integromat) and Zapier have Claude integrations that let you use the API functionality without writing code. These are good starting points for non-developers.
The Claude API is the most powerful way to use Claude at scale. Start with the curl test, try the Python SDK, and set a spending limit in the console so you can experiment without worrying about costs. Once you have your first script running, the possibilities expand quickly.
For more on what Claude can do, read our guides on Claude MCP and Claude workflows.
