How to Write a Claude System Prompt: A Practical Guide

TL;DR

  • A system prompt is a set of instructions you give Claude before a conversation starts — it shapes how Claude behaves for the entire session.
  • In Claude Projects, the project instructions field is your system prompt.
  • Good system prompts cover: who Claude is, what it should always do, what it should never do, and how to format responses.
  • Specific instructions produce consistent results. Vague instructions produce inconsistent results.
  • You do not need to be a developer to write effective system prompts.

The single biggest difference between users who get great results from Claude and users who find it frustrating is usually the system prompt. This guide explains what a system prompt is, how to write one that actually works, and gives you real examples you can use immediately.

What Is a System Prompt in Claude?

A system prompt is a block of instructions that sits at the beginning of a conversation with Claude, before any user messages. It tells Claude how to behave throughout the entire session — what role to take, what tone to use, what topics to focus on, and what to avoid.

Think of it as the briefing you give a new assistant before they start work. Without a briefing, they do their best based on general knowledge and guesswork. With a clear briefing, they know exactly what you expect and can deliver it consistently.

In Claude’s interface, system prompts appear in two places. In the Claude API, developers pass the system prompt as a dedicated parameter before the conversation begins. In Claude Projects, the “Project Instructions” field is your system prompt — Claude reads it automatically at the start of every conversation inside that project.

If you are a regular Claude user (not a developer), the Project Instructions field in Claude Projects is the main place you will write and use system prompts.

What Should a Good Claude System Prompt Include?

A well-written system prompt answers four questions for Claude:

1. Who are you in this context? Define Claude’s role and persona for this project. “You are a blog writer for AIUpToDate.online” or “You are a customer service assistant for [Company Name]” or “You are an expert Python developer helping a junior engineer.”

2. What context does Claude need? Give Claude the background it needs to be useful — who the audience is, what the project is about, what goals you are working toward, what domain or industry applies.

3. What should Claude always do? List your requirements. Format instructions, tone instructions, language instructions, structural requirements. “Always include a TL;DR. Use US English. Write in short paragraphs. Always respond in the same language the user writes in.”

4. What should Claude never do? Constraints are just as important as requirements. “Never use em dashes. Never add exclamation marks in body copy. Never recommend competitor products. Never make up statistics — if you are uncertain, say so.”

Covering all four areas produces a system prompt that Claude can follow consistently, session after session.

Claude System Prompt Examples You Can Use

Blog Writing System Prompt

You are a blog writer for [YourSite.com]. The site covers [topic] for [audience — e.g., beginners, freelancers, students in Pakistan]. Always write in US English. Use short paragraphs of 2-4 sentences. Headings in Title Case. No em dashes. No exclamation marks in body text. Always start with a TL;DR bullet list. Include an FAQ section at the end with 4-6 questions. Never keyword-stuff — mention the target keyword naturally 3-5 times total. Do not link to competitor websites.

Customer Support System Prompt

You are a friendly customer support agent for [Company Name], a [describe business]. Always greet the user warmly. Keep responses concise — 2-3 paragraphs maximum. If you cannot resolve an issue, always offer to escalate to a human agent. Never promise refunds or policy exceptions without explicit approval. Do not discuss competitor products. If a user is frustrated, acknowledge their frustration before addressing the issue.

Research Assistant System Prompt

You are a research assistant helping with [topic area]. When summarising material, always include: a one-paragraph overview, 3-5 key findings as bullet points, any important caveats or limitations, and a note on source quality if relevant. Do not make up facts — if you are uncertain, say “I am not certain about this” rather than guessing. When the user pastes an article or document, summarise it in the format above unless instructed otherwise.

Code Review System Prompt

You are a senior [language] developer reviewing code for a junior engineer. When reviewing code: first describe what the code does in plain language, then list any bugs or errors, then list improvements for readability and performance, then rate the code quality on a scale of 1-10 with justification. Be constructive — frame feedback as suggestions, not criticism. Use code blocks for all code examples. If the code looks good, say so clearly rather than inventing problems.

How Long Should a Claude System Prompt Be?

Long enough to cover everything Claude needs to know — but no longer. Most effective system prompts are between 100 and 500 words. Very short prompts (under 50 words) usually leave too much to interpretation. Very long prompts (over 1,000 words) can start to confuse Claude when instructions contradict each other or when there is too much competing detail.

One important technical note: system prompts count toward Claude’s context window. On a very long conversation with a very long system prompt, you may have less space for the actual dialogue. For most users this is not a practical issue, but it is worth knowing if you are building complex workflows on the API.

Common System Prompt Mistakes to Avoid

Being too vague: “Write good content” gives Claude nothing to work with. Specify exactly what “good” means for your use case.

Contradicting yourself: “Be concise but comprehensive” is a contradiction. Decide which matters more for each specific task type and write instructions that reflect that priority clearly.

Not testing it: Write a system prompt, then immediately run three or four realistic tasks through it. The gaps in your instructions will become obvious quickly. Fix them before using the prompt for real work.

Forgetting to update it: If your requirements change — new brand guidelines, a new client, a new output format — update the system prompt. Stale instructions produce outputs that no longer match your needs.

Using it as a substitute for context: A system prompt sets standing instructions. It does not replace giving Claude the specific context it needs for each individual task. Your trigger prompt for each task should still include the relevant details (topic, length, audience, etc.).

How Do System Prompts Work with Claude Projects?

In Claude Projects, the Project Instructions field is essentially a system prompt that Claude reads at the start of every conversation in that project. You do not need to be a developer or use the API to take advantage of system prompts — the Projects interface gives you full access to this functionality.

The knowledge base documents you upload to a project work alongside the system prompt. Think of the system prompt as your standing orders (“always write like this, always follow this format”) and the knowledge base as the reference materials Claude can consult (“here is the style guide, here is the client brief, here are the past examples”).

For a detailed walkthrough of Claude Projects setup, read our Claude Projects tutorial.

Frequently Asked Questions About Claude System Prompts

Can users see or override the system prompt?
In Claude Projects, users (you) set and can see the project instructions. In API deployments where a developer has set a system prompt, it may be hidden from end users depending on how the app is built. Users generally cannot override the system prompt unless explicitly allowed to.

Do system prompts work on the free Claude plan?
Yes. The Project Instructions field in Claude Projects is available on Free accounts (for up to 5 projects). You can write and use system prompts without a paid plan.

What language should I write system prompts in?
Write in the language you are most comfortable expressing precision and nuance in. Claude understands instructions in most major languages. That said, English tends to produce the most consistent results for technical and formatting instructions, so if you are bilingual, English system prompts with non-English conversation are a common pattern.

Can I use a system prompt to make Claude respond in Urdu or another language?
Yes. Add an instruction like “Always respond in Urdu regardless of what language the user writes in” or “Always respond in the same language the user uses.” Claude follows this reliably.


A well-written system prompt is the highest-leverage thing you can do to improve your Claude results. Spend 20 minutes writing clear instructions for your most-used workflow and you will save that time back within the first few sessions.

For more on building productive Claude workflows, read our guides on Claude AI workflows and Claude Projects.

Leave a Comment

Your email address will not be published. Required fields are marked *