Troubleshooting and Optimization — study note
Troubleshooting and Optimization — study note
Domain 7 of the Claude Certified Associate – Foundations exam. Its three objectives ask you to:
- diagnose and resolve common issues with prompts and responses;
- adjust your approach when results are weak;
- optimize your workflows for efficiency.
Diagnose before you fix
Start with one question: did you get an answer, or a message? A message about length, capacity or an incident has its own remedy, and rewording the prompt is not it.
| Symptom | Likely cause | Fix |
|---|---|---|
| Generic or off-target answer | The ask is unclear | Explain the ask simply and clearly |
| Complete answer built on a wrong assumption | Context is missing | Include as much context as you can |
| Some parts of a multi-part answer are thin | A complex request left in one piece | Break it into substeps |
| Short because the prompt asked for brevity | The prompt shaped it | Retool the prompt: say what to cover, and in how much detail |
| Stopped partway | The reply was cut off | In a new chat, give the previous prompt and response so Claude can pick up where it left off (house practice: in the same chat, ask it to continue) |
The help center lists four principles for a helpful answer; three map to the symptoms above (house mapping), and the fourth, giving Claude feedback, is how you act on them. Its article on brief responses notes that Claude’s context window applies to the prompts you provide but not the output it generates; the limits article adds that a portion of the context window is always reserved for Claude’s response. Either way, the article’s advice for a reply that is too brief or only partially complete is to consider retooling your prompts.
Messages that are not about the prompt
| Message or pattern | What it means | Fix |
|---|---|---|
| Message too long | This message is too long to send | Attach fewer or smaller files, or start a new conversation. On paid plans with code execution, long conversations are summarized automatically, so most users will rarely encounter the error; in rare cases such as a very large first message, summarize, extract key sections or split the content first |
| Capacity constraints | High demand on Claude’s infrastructure, system-wide; not an outage | Try again in a few minutes. Capacity issues do not appear on the status page |
| Errors for all or most users | A service incident | Check the status page for confirmed incidents |
| Cannot log in | An access problem | Check you are not using a VPN, disable active browser extensions, and clear your browser’s cache and cookies |
Adjust the approach
If a rewrite has not helped, change what Claude is working with, not only the wording.
| Result | Adjustment |
|---|---|
| Complex work comes back shallow | Raise effort, turn on thinking, or both, where your model offers them |
| Routine work uses up your limits | Lower effort; the defaults work well for everyday tasks |
| The format or tone drifts between runs | Add a few varied examples (the guide suggests 3–5) |
| Too much markdown in replies | Remove markdown from your prompt, say what format you want, or use XML format indicators |
| Long documents give weak answers | Put them near the top of the prompt, above the question |
| You need more examples | Ask Claude to generate more from your set |
| Parts of a large request are skipped | Split it into substeps |
| The answer needs current facts | Web search for a quick fact; research for many sources across the web and your integrations |
| The question needs no outside information | Extended thinking on its own, not research |
| Thinking stops with a note that the rest is not available | Safety systems stopped part of the thinking; reframe the prompt to approach the problem from a different angle |
Two conditions matter. Not every model has effort levels (on those, thinking is the Extended toggle), and on some models thinking is always on and cannot be switched off. Effort and thinking are separate settings, and you can use any combination. Whatever the settings, be specific about the problem. To check how Claude reached a conclusion, review the Thinking section. Web search and research depend on your plan and settings.
Optimize the workflow
Your usage depends on the length and complexity of your conversations, the features you use, the model, and the effort level.
| Habit | Why it helps |
|---|---|
| Plan, and group related questions in one message | Fewer back-and-forth messages |
| Review a message before sending it | Fewer follow-ups to fix an unclear message |
| Refer back instead of repeating | Claude remembers context from earlier in the conversation |
| Start a new conversation when a long chat nears your usage limit | The help center’s suggestion for longer chats |
| Keep core documents in the project knowledge | Project content is cached and counts less when reused. Caches expire after inactivity, so after a long break the first message counts it in full again |
| Clean up project files you no longer use | Less content to carry |
| Turn off connectors and web search a chat does not need | Tools and connectors are token-intensive |
| Turn off extended reasoning, or lower effort, for routine tasks | Where the model allows it, less thinking for work that does not need it |
| Describe recurring work once as a scheduled task | Claude runs it on your cadence |
Scheduled tasks are available on paid plans, in Cowork and in the new Claude experience. They run remotely and work with your connectors and the files saved to your Claude account; if a task requires local files or apps, it runs only locally. Reading the help page’s three statements together, our house reading is that a remote run cannot reach a folder on your computer (choosing a folder is optional in manual setup). You can edit a task’s instructions or cadence, pause and resume it, run it on demand, and review upcoming and past runs.
Sources
- My prompt isn’t giving me a helpful answer — https://support.claude.com/en/articles/7996857-my-prompt-isn-t-giving-me-a-helpful-answer
- Claude’s response to my prompt is too brief — https://support.claude.com/en/articles/8114518-claude-s-response-to-my-prompt-is-too-brief
- Troubleshoot Claude error messages — https://support.claude.com/en/articles/12466728-troubleshoot-claude-error-messages
- Change the model, effort, and thinking settings — https://support.claude.com/en/articles/8664678-change-the-model-effort-and-thinking-settings
- Prompting best practices — https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/claude-prompting-best-practices
- When should I use web search, extended thinking, and research? — https://support.claude.com/en/articles/11095361-when-should-i-use-web-search-extended-thinking-and-research
- Usage limit best practices — https://support.claude.com/en/articles/9797557-usage-limit-best-practices
- How do usage and length limits work? — https://support.claude.com/en/articles/11647753-how-do-usage-and-length-limits-work
- Schedule recurring tasks in Claude Cowork — https://support.claude.com/en/articles/13854387-schedule-recurring-tasks-in-claude-cowork