Editing Troubleshooting of Claude (section)

== Troubleshooting of Claude ==
=== How to fix "stop_reason": "refusal" in Claude API ===

'''Error message'''
<pre>
{
    "id": "msg_xxx",
    "type": "message",
    "role": "assistant",
    "model": "claude-opus-4-20250514",
    "content": [],
    "stop_reason": "refusal",
    "stop_sequence": null,
    "usage": {
        "input_tokens": 2164,
        "cache_creation_input_tokens": 0,
        "cache_read_input_tokens": 0,
        "output_tokens": 0
    }
}
</pre>

'''Model Affected''': Claude Opus 4

'''Suggestion'''

Prompt met "refusal" error
<pre>
Please help find the company's unified business number:
Company name: {$companyName}
</pre>

Revised prompt:
<pre>
Please help find the following company's publicly available basic information: the company's unified business number:
Company name: {COMPANY_NAME}
</pre>

'''Root cause:''' Common Triggers:
* Privacy-related requests - asking for personal data or private information
* Confidential information queries - requesting internal data or business secrets
* Security-sensitive content - potentially harmful or inappropriate requests
* Ambiguous identity information - queries that may involve identity identification

'''Suggested:'''
* Replace sensitive keywords in your prompts (e.g., "confidential" → "public", "internal data" → "public documents", "private information" → "publicly available information")
* Add safety declarations explicitly stating you only want publicly available information
* Use structured prompts that specify data source limitations and public nature requirements
* Implement the smart retry mechanism with prompt modification when refusal is detected
* Consider using the `RefusalPreventionHelper` class to assess and sanitize prompts before sending to API

'''Official Documentation:'''
* [https://docs.anthropic.com/en/api/handling-stop-reasons Handling stop reasons - Anthropic] mentioned "Claude’s response includes a stop_reason field that indicates why the model stopped generating its response ..."
* [https://www.anthropic.com/transparency Anthropic’s Transparency Hub \ Anthropic]
* [https://www.anthropic.com/news/activating-asl3-protections Activating AI Safety Level 3 Protections \ Anthropic]
* [https://support.anthropic.com/en/articles/8241216-i-m-planning-to-launch-a-product-using-claude-what-steps-should-i-take-to-ensure-i-m-not-violating-anthropic-s-usage-policy I’m planning to launch a product using Claude. What steps should I take to ensure I’m not violating Anthropic’s Usage Policy? | Anthropic Help Center]

=== Troubleshooting "Wiggle: Upload Failed" Error ===

'''Error Details'''
<pre>
Wiggle: Upload failed: 400 - File: 1120390382845847 - 5,176 -T
觀看•192個心情|#...txt (61013 bytes, text/plain) - URL:
/api/organizations/xxxx/conversations/47ef2ad3-ac54-4441-a67e-xxx/wiggle/upload-file
</pre>

'''Affected Model''': Claude 4 Sonnet

'''Troubleshooting Steps''':
# Use alternative method - Copy and paste the text content directly into the chat
# Rename file - Use a simple filename containing only English letters, numbers, and basic characters (avoid special symbols, spaces, or non-English characters)
# "To solve this, I had to: turn off Code execution and file creation feature and turn on the Analysis tool." Thanks, slacreddit! {{access | date = 2025-10-30}}<ref>[https://www.reddit.com/r/ClaudeAI/comments/1oh0wv9/claude_ai_upload_failed_due_to_a_network_issue/ Claude AI “Upload failed due to a network issue” — anyone else getting this since Oct 23? : r/ClaudeAI]</ref><ref>[https://status.claude.com/incidents/k1hywp210cxl Claude Status - Elevated errors with uploading files to claude.ai]</ref>

'''Additional Recommendations''':
# Ensure stable internet connection before uploading
# Check if file size is within platform limits: 30MB<ref>[https://support.claude.com/en/articles/8241126-what-kinds-of-documents-can-i-upload-to-claude What kinds of documents can I upload to Claude? | Anthropic Help Center]</ref>

=== How to fix "Text extraction failed for one of the uploaded files. Please try again." ===
'''Error message'''
<pre>
Text extraction failed for one of the uploaded files. Please try again.
</pre>

'''Model Affected''': Claude 3 Sonnet

'''Suggested Workaround:'''
* When uploading PDF files in the Claude system, consider paste the relevant text directly into our conversation for better processing<ref>[https://www.reddit.com/r/ClaudeAI/comments/1bquumd/cant_upload_pdf_or_text/?rdt=54340 Can’t upload pdf or text : r/ClaudeAI]</ref>. Use [[Convert PDF to Text]] tools to help with the conversion.
* For other file types encountering errors, it's likely due to file conversion issues. It's recommended to manually convert files beforehand into formats that are easier for machines to read, such as Unicode (UTF-8) encoded TXT or CSV files<ref>[https://www.reddit.com/r/ClaudeAI/comments/1e4nzb5/claude_giving_me_text_extraction_failure/ Claude giving me text extraction failure : r/ClaudeAI]</ref>.

=== How to fix "Files of the following format are not supported: xlsx." ===

'''Model Affected''': Claude 3 Sonnet, Claude 3 Opus, Claude 3 Haiku

'''Suggested Workaround:'''
* When uploading Excel files for analysis in the Claude system, consider converting and uploading an alternative CSV (Comma-Separated Values) or TSV (Tab-Separated Values) file instead.

=== How to fix "You may not upload files larger than 30mb." ===

'''Model Affected''': Claude 3 Sonnet

'''Suggested Workaround:'''

Option 1: Web Interface
* When uploading PDF files in the Claude system, Split your PDF into smaller sections using PDF tools (such as [https://pdfsam.org/download-pdfsam-basic/ PDFsam]) under 30MB.

Option 2: Messages API
* Use PDFs with the Messages API for programmatic handling<ref>[https://docs.anthropic.com/en/docs/build-with-claude/pdf-support PDF support (beta) - Anthropic]</ref>

=== How to Set Monthly Spending Limits for Claude API ===

# Navigate to the [https://console.anthropic.com/settings/workspaces Workspaces section] in your Anthropic Console
# Create a new workspace by selecting "Add Workspace"
# Go back to your Workspaces overview, then click the menu icon (three dots) beside your workspace name and select "Manage API Keys"
# Access the "Limits" tab and configure your monthly spending cap (Monthly limit)