Clade data handling

Anthropic Data Handling

Overview

Handle data responsibly when building with Claude — manage the 200K token context window efficiently, implement conversation trimming strategies, redact PII before sending to the API, and configure data retention settings.

Context Window Management

Claude models have a 200K token context window. Managing it efficiently is critical.

// Count tokens before sending
const count = await client.messages.countTokens({
  model: 'claude-sonnet-4-20250514',
  messages,
  system: systemPrompt,
});

// Budget: 200K total - max_tokens (output) = available input
const MAX_CONTEXT = 200_000;
const MAX_OUTPUT = 4096;
const inputBudget = MAX_CONTEXT - MAX_OUTPUT;

if (count.input_tokens > inputBudget) {
  // Trim oldest messages, keep system prompt + recent context
  messages = trimToFit(messages, inputBudget);
}

Instructions

Step 1: Conversation Trimming

function trimConversation(messages: MessageParam[], maxTokens: number): MessageParam[] {
  // Always keep the first message (often contains key context)
  // Keep the most recent messages
  // Drop middle turns first
  if (messages.length <= 4) return messages;

  const first = messages[0];
  const recent = messages.slice(-6); // Last 3 turns
  return [first, ...recent];
}

PII Handling

// Strip PII before sending to Claude (if not needed for the task)
function redactPII(text: string): string {
  return text
    .replace(/\b[\w._%+-]+@[\w.-]+\.\w{2,}\b/g, '[EMAIL]')
    .replace(/\b\d{3}[-.]?\d{3}[-.]?\d{4}\b/g, '[PHONE]')
    .replace(/\b\d{3}-\d{2}-\d{4}\b/g, '[SSN]')
    .replace(/\b\d{4}[\s-]?\d{4}[\s-]?\d{4}[\s-]?\d{4}\b/g, '[CARD]');
}

Data Retention

• Default: Anthropic does not use API data for training
• Zero retention: Available on Enterprise plans
• Your responsibility: Don't store Claude responses containing user PII longer than needed

Output

• Token counting implemented before sending requests (prevents context overflow errors)
• Conversation trimming preserving first message and recent turns
• PII redaction applied for emails, phone numbers, SSNs, and card numbers
• Data retention policy documented and configured

Error Handling

Error	Cause	Solution
API Error	Check error type and status code	See clade-common-errors

Examples

See Context Window Management (token counting + budget), Conversation Trimming function, and PII Handling regex patterns above.

Resources

• Anthropic Privacy Policy
• Token Counting
• Context Window

Next Steps

See clade-enterprise-rbac for organization and access management.

Prerequisites

• Completed clade-install-auth
• Application handling user conversations or document processing
• Understanding of token counting and context windows