{"slug": "prompting-claude-opus-5", "title": "Prompting Claude Opus 5", "summary": "Anthropic's Claude Opus 5 is built for complex agentic coding and enterprise work, with particular strengths in long-horizon agentic tasks, and performs well out of the box on existing Claude Opus 4.8 prompts. The model introduces an effort parameter (low, medium, high, xhigh) to control thinking volume and token cost, and benefits from explicit guidance on response length and narration style in agentic sessions.", "body_md": "We use cookies to deliver and improve our services, analyze site usage, and if you agree, to customize or personalize your experience and market our services to you. You can read our Cookie Policy [here](https://www.anthropic.com/legal/cookies).\n\nThis guide covers the prompting patterns specific to Claude Opus 5. For the model's capabilities and API changes, see [What's new in Claude Opus 5](/docs/en/about-claude/models/whats-new-opus-5). For techniques that apply across all current Claude models, see [Prompting best practices](/docs/en/build-with-claude/prompt-engineering/claude-prompting-best-practices).\n\nClaude Opus 5 is built for complex agentic coding and enterprise work, with particular strengths in long-horizon agentic tasks. It performs well out of the box on existing Claude Opus 4.8 prompts. The following patterns cover the behaviors that most often require tuning.\n\nFor API changes when migrating from Claude Opus 4.8 (thinking on by default, and disabling thinking capped at `high`\n\neffort), see the [migration guide](/docs/en/about-claude/models/migration-guide#migrating-from-claude-opus-4-8-to-claude-opus-5).\n\nCompared with Claude Opus 4.8, the improvements most relevant to prompting are:\n\n`low`\n\nand `medium`\n\n`high`\n\n) and adjust based on your evals: use `low`\n\nand `medium`\n\nliberally as your primary control for token cost and response time wherever quality holds, and step up to `xhigh`\n\nfor demanding coding and agentic work. If you carried effort defaults over from a prior model, re-run an effort sweep on your own evals. See Claude Opus 5's default user-facing responses run longer than prior Opus models'. The [effort parameter](/docs/en/build-with-claude/effort) controls how much the model [thinks](/docs/en/build-with-claude/thinking-steering-and-cost) rather than how much it says: lowering effort can reduce thinking volume without reliably shortening the visible response. To control response length, prompt for it explicitly.\n\nA short conciseness instruction is effective. For example, for a user-facing multi-turn product:\n\n```\nKeep responses focused, brief, and concise. Keep disclaimers and caveats short, and spend most of the response on the main answer. When asked to explain something, give a high-level summary unless an in-depth explanation is specifically requested.\n```\n\nIn a long system prompt, pair the instruction with a short reminder near the end of the prompt:\n\n```\n<tone_preference>\nKeep outputs reasonably concise.\n</tone_preference>\n```\n\nClaude Opus 5 narrates readily during agentic work: it tends to announce what it is about to do, and its per-message output in agentic sessions is often longer than prior models'. It benefits from explicit guidance on how to communicate with the user during a task. To tune narration down, describe the cadence and shape you want:\n\n```\nBefore your first tool call, say in one sentence what you're about to do. While working, give a brief update only when you find something important or change direction. When you finish, lead with the outcome: your first sentence should answer \"what happened\" or \"what did you find,\" with supporting detail after it for readers who want it.\n```\n\nTo tune narration up, or change its style, the same lever applies in the other direction: explicitly describe what updates should look like and provide examples. Positive examples of the communication style you want tend to be more effective than instructions about what not to do.\n\nSeparate from conversational verbosity, files that Claude Opus 5 writes to disk (reports, Markdown documents, summaries) are often longer than on prior models. If your product includes Claude-authored documents, add explicit length calibration:\n\n```\nMatch the length of written documents to what the task needs: cover the substance, but do not pad with filler sections, redundant summaries, or boilerplate.\n```\n\nClaude Opus 5 verifies its own work without being told to. If your prompt contains explicit verification instructions (\"include a final verification step for any non-trivial task,\" \"use a subagent to verify\"), remove them: instructions like these cause over-verification on Claude Opus 5, and removing them reduces wasted tokens with no loss in quality. The same applies to legacy harness scaffolding that adds separate verification steps.\n\nClaude Opus 5 can also expand the scope of a task, adding steps that weren't requested or applying its own judgment about what the task should be. For narrow tasks, constrain scope explicitly:\n\n```\nDeliver what was asked, at the scope intended. Make routine judgment calls yourself, and check in only when different readings of the request would lead to materially different work. If the request seems mistaken or a better approach exists, say so in a sentence and continue with the task as asked rather than quietly narrowing, widening, or transforming it. Finish the whole task, and stop short of actions that are clearly beyond what was asked.\n```\n\nClaude Opus 5 delegates to subagents more readily than prior models. Delegation pays off on genuinely independent, sizeable tracks of work, but it multiplies cost and time when applied to small tasks. If your harness supports subagents, give explicit guidance on which scenarios warrant delegation, or set deterministic caps on how many agents can be launched. For example:\n\n```\nDelegate to a subagent only for large tasks that are genuinely independent and parallelizable, such as a wide multi-file investigation. Do not delegate work you can finish yourself in a handful of tool calls, and do not use subagents to verify or double-check your own work. If one subagent can complete the task, use one rather than several, and keep spawn counts low.\n```\n\nClaude Opus 5 catches and fixes its own mistakes well without prompting. Avoid instructing re-checks it already performs (\"double-check your answer,\" \"re-verify before responding\"); like verification instructions, these compound with the model's own behavior and add cost without improving results.\n\nThe model also narrates corrections to its earlier statements more than prior models do, which can be undesirable in user-facing products. To limit correction narration to corrections that matter:\n\n```\nOnly correct an earlier statement when the error would change the user's code, conclusions, or decisions. State corrections plainly and briefly, then continue the task. For slips that change nothing for the user, make the fix and move on without noting it.\n```\n\nClaude Opus 5 runs with [thinking](/docs/en/build-with-claude/thinking) on by default, and thinking can be disabled only at [effort](/docs/en/build-with-claude/effort) `high`\n\nor below; see the [migration guide](/docs/en/about-claude/models/migration-guide#migrating-from-claude-opus-4-8-to-claude-opus-5). With thinking disabled, two artifacts can occasionally appear in the model's visible output. The primary mitigation for both is to keep thinking enabled and control token cost with lower effort levels instead of disabling thinking: for most tasks, thinking enabled at `low`\n\neffort performs better than thinking disabled at similar cost.\n\n**Tool calls as text.** With thinking disabled, the model occasionally writes a tool call into its user-facing text instead of emitting a structured `tool_use`\n\nblock. The turn completes normally and the call never runs, and in agentic loops the leaked text stays in the conversation history, so later turns are affected as well. This is most common on tool-heavy workloads such as search.\n\n**Internal XML tags in output.** With thinking disabled, the model can emit `<thinking>`\n\ntags or other internal XML tags into its visible response. If your system prompt contains a rule instructing the model not to think or not to reason, remove it; that kind of instruction increases tag leakage.\n\nFor integrations that must keep thinking disabled, a single combined instruction mitigates both artifacts: it gives the model explicit permission to speak before a tool call, an alternative to forcing a call when no tool fits, and a general rule against internal tags:\n\n```\nWhen you use a tool, you may say a brief sentence first. If no tool can express what the user asked for, say so instead of guessing. Do not include internal or system XML tags in your response.\n```\n\nInstructions that call out thinking tags by name are less effective than the general form, so avoid naming them specifically.\n\nWas this page helpful?", "url": "https://wpnews.pro/news/prompting-claude-opus-5", "canonical_source": "https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/prompting-claude-opus-5", "published_at": "2026-07-28 06:29:08+00:00", "updated_at": "2026-07-28 06:52:37.764041+00:00", "lang": "en", "topics": ["large-language-models", "ai-products", "ai-agents", "developer-tools"], "entities": ["Anthropic", "Claude Opus 5", "Claude Opus 4.8"], "alternates": {"html": "https://wpnews.pro/news/prompting-claude-opus-5", "markdown": "https://wpnews.pro/news/prompting-claude-opus-5.md", "text": "https://wpnews.pro/news/prompting-claude-opus-5.txt", "jsonld": "https://wpnews.pro/news/prompting-claude-opus-5.jsonld"}}