AI Detective — User Guide

Version 2.00 · A practical guide to using AI Detective, and how it behaves under the hood.
Contents
  1. Getting Started
  2. Your API Key & Local Storage
  3. Single Document Mode
  4. Reading Your Results
  5. Batch Mode
  6. Citation Validation
  7. Security & Prompt Injection Detection
  8. Settings
  9. Cost & Billing
  10. Keyboard Shortcuts
  11. Troubleshooting & FAQ
  12. Privacy, Security & Legal

1. Getting Started

AI Detective analyzes text and estimates how likely it is to have been written by an AI, a human, or some combination of both. It runs entirely through Anthropic's Claude API, using your own API key — there is no account to create and nothing to sign up for on this site.

Getting an API key

  1. Go to console.anthropic.com and create a free account, or sign in.
  2. Navigate to API Keys and create a new key.
  3. Copy the key (it starts with sk-ant-).

Connecting

  1. Paste your key into the field at the top of the page.
  2. Click Connect.
  3. Once connected, the button turns green and reads Connected. Hover over it and it turns red — click it any time to disconnect.

Connecting does two things: it confirms your key is valid, and it fetches the actual list of models available to your account, replacing the three default options in the Model dropdown with your real list.

2. Your API Key & Local Storage

By default, your API key lives only in this browser tab's memory. Close the tab and it's gone — nothing is saved anywhere.

A status bar at the bottom of the screen shows whether your settings are currently being saved to this device, with a one-click toggle:

The first time you successfully connect a key, you'll be asked whether you'd like to remember it. Saying yes turns saving on and stores the key together, in one step.

Remembering your key is a convenience, not secure storage. Anyone with access to your browser could retrieve it via developer tools. Only use it on a personal, trusted device.

3. Single Document Mode

Provide your text one of three ways, using the tabs at the top of the input card:

TabWhat it does
Paste TextType or paste directly into the box.
Upload FileUpload a document. Supported formats: TXT, MD, HTML, XML, JSON, DOCX, PPTX, ODT, PDF, RTF, EML. All parsing happens in your browser — files are never uploaded anywhere except the extracted text, which goes to Anthropic when you click Analyze.
From URLEnter a web page URL and click Fetch page text. The server fetches the page and extracts the main article text (skipping navigation, ads, etc.), shown in a box below for review before analyzing.
Providing new input automatically clears any previous result on screen — uploading a new file, fetching a new URL, or editing pasted text all reset the display, so a stale result never lingers looking like it belongs to whatever's now in the input. Just switching between tabs to look around doesn't clear anything on its own; only an actual content change does.

Options

OptionWhat it does
ModelWhich Claude model runs the analysis. More capable models cost more per analysis.
EffortReasoning depth: Standard, Low, Medium, High, X-High, or Max. Higher levels can improve accuracy but cost more. Not every model supports every level — if rejected, you'll see a plain message and the app automatically resets it to Standard.
Extended ThinkingLets Claude reason step-by-step before answering. Works independently of Effort. Increases cost.
Flagged AI phrasesHighlights the specific phrases most indicative of AI writing. Adds cost.
Check citationsValidates any citations found in the document. See Citation Validation below.
Split large files into chunksFor documents beyond the recommended size limit, splits the text into pieces, analyzes each, then combines them into one length-weighted result. Without this on, oversized documents are truncated instead (you'll be warned either way).
Pre-AI-era warningUpload File only. When enabled in Settings (see below), warns if the file's date predates your AI era cutoff before analyzing it — such files are unlikely to contain AI-generated text. Not a separate toggle here; controlled from Settings.
Model, Effort, Extended Thinking, Show Flagged Phrases, Check Citations, and chunking settings all stay synced between Single and Batch mode — changing one in either mode updates the other automatically, since they represent the same underlying choice either way.

Running an analysis

Click Analyze Document. The first time you do this in a new browser session, you'll see:

  1. A Document Submission Notice — must be acknowledged once per session (see Privacy, Security & Legal).
  2. A brief human-verification check (CAPTCHA) — happens roughly once per hour of activity, to keep the service available for everyone.

While an analysis runs, the button becomes Cancel Analysis — click it to stop (you'll be asked to confirm). Once complete, results appear on the right, and a Clear button appears to reset for a new document.

4. Reading Your Results

Scores

The colored bar shows four percentages that always add up to 100%:

Confidence

A separate measure of how certain Claude is in the overall assessment — not one of the four categories above. Low confidence often means the text is short, technical, or has mixed characteristics.

Signals

Specific observations that informed the assessment, each tagged by type: Strong AI or Moderate AI (confidence in an AI indicator, strong being the higher-confidence of the two), Weak AI (ambiguous, could be either), Human (a specific human writing trait), or Edited (evidence of human revision to AI-generated text, or AI polish applied to human-written text). Color-coded to match the score bar above: AI-family tags in red, Human in green, Edited in blue, Weak AI in gray.

Citations

If citation checking was enabled, a list of every citation found, each marked valid, suspicious, or invalid. See Citation Validation below for full detail.

Summary

A plain-English paragraph explaining the verdict. If the document was chunked, this notes how many chunks were analyzed and the range of AI% scores observed across them.

Exporting

Two export buttons appear after an analysis completes:

5. Batch Mode

Switch to Batch using the toggle at the top of the page. Batch mode analyzes many files in one run.

Selecting files

Selecting files after a previous batch has already finished starts a genuinely new batch — the old run's results and file list are both cleared automatically, rather than mixing old and new files together. If you want to add more files to a batch you haven't run yet, selecting again beforehand works as expected (it only resets once a batch has actually completed).

Batch-specific options

OptionWhat it does
Spending limitThe batch stops automatically once this total is reached (checked after each file completes, not mid-file).
Pre-AI-era skippingWhen enabled in Settings (see below), automatically skips files dated before your AI era cutoff without analyzing them — saves time and cost. Not a separate toggle here; controlled from Settings.
Produce detailed Signals fileCollects every file's full signal list into one downloadable text file, in addition to the regular exports.

All the other options (Model, Effort, Thinking, Flagged Phrases, Citations, Chunking) work identically to Single mode and stay synced with it.

The batch log

Each file produces a [SIG] line showing its scores, color-coded by the dominant result (red = AI, green = Human, blue = Edited), followed by a [CIT] section if citation checking is on, with per-citation results and a summary count.

If chunking is enabled and a file is too large, it's split and each chunk appears as its own labeled row, e.g. report.docx [1/3], report.docx [2/3] — unlike Single mode, batch does not combine chunks into one result; each is shown and counted separately.

Exporting

Three export options once the batch completes: CSV, Text report, and PDF report (plus Signals Detail if that option was enabled).

6. Citation Validation

When enabled, Claude extracts every citation in the document and screens it for format validity and suspicious patterns. Optionally, uncertain citations are also checked against real external databases:

TagServiceChecksSetup
ClaudeAnthropic ClaudeFormat and plausibility screeningUses your existing API key — nothing extra needed
CRCrossRefAcademic journalsFree, no key needed
OAOpenAlexAcademic (broad)Free, no key needed
CLCourtListenerUS case lawFree token — register at courtlistener.com, add it in Settings
PMPubMedMedical literatureFree; an optional NCBI key raises the rate limit from 3 to 10 requests/sec
OLOpenLawsStatutes & regulationsComing soon — paid service

Each citation is marked:

Citation validation is a screening tool, not proof. A citation marked valid confirms only that its format appears correct and it was found in the checked database — not that it actually supports the point it's cited for. Always verify independently before relying on any citation professionally.

7. Security & Prompt Injection Detection

Every analysis is automatically checked for content that appears designed to manipulate the tool itself — this runs on every analysis, in both modes, with no setting to turn it off, since the people most exposed to this risk are usually the ones who don't know to look for it. There are two independent checks:

CheckWhat it looks for
StructuralText hidden in the document's actual file format — Word's "vanish" formatting, extremely small font sizes, CSS display:none/visibility:hidden tricks in HTML or HTML email content. This inspects the file's real markup, not just what's visibly rendered.
SemanticContent — hidden or in plain view — that reads as an attempt to instruct or override the analysis itself (e.g. text addressed to an AI telling it to ignore prior instructions or report a predetermined result). Runs as part of the same analysis call, on every input method including pasted text.

Where it's shown

Nothing appears if nothing is found — the common case stays uncluttered. If something is found:

Known limitations

This is a best-effort screen, not a guarantee. Specifically:

8. Settings

Open Settings via the gear icon in the top bar.

SectionContents
AppearanceColor theme: System (follows your OS/browser setting), Light, Lark, or Dark.
AI DetectionOne shared switch enabling the pre-AI-era checks in both modes, plus the cutoff date itself (default: November 30, 2022 — roughly when AI writing tools became widely available).
Batch ProcessingMax files per batch (default 50) — set to 0 or leave blank for no limit. The cost estimate and pre-run confirmation still apply regardless, so a very large batch can still be reviewed and aborted before it actually runs.
Remembered API KeyShows whether a key is currently saved on this device, with a Forget button.
Citation ServicesCourtListener token and PubMed/NCBI key fields.
Spending SummaryRunning total of what you've spent and how many analyses you've run (persists across sessions if you're saving settings; session-only otherwise), with a reset button.
SessionClear your session history (the list of recent analyses, viewable via the clock icon).

9. Cost & Billing

Every analysis uses your own Anthropic API credits — this site never sees or charges you anything itself. An estimated cost is shown before you click Analyze, and the actual cost (calculated from the real tokens used) appears afterward.

Extended Thinking and higher Effort levels can significantly increase token usage and therefore cost — the pre-analysis estimate accounts for this roughly, but actual usage varies with the specific document and model. Citation checking adds a second API call, and each chunk in a split document is its own full call.

10. Keyboard Shortcuts

ShortcutAction
F5 or Ctrl+EnterAnalyze (Single mode) or Run Batch (Batch mode)
Ctrl+TabSwitch between Single and Batch mode
Ctrl+SSave report as text (Single mode, once a result exists)
Ctrl+Shift+CCopy results (Single mode, once a result exists)
EscCancel the current analysis, abort a running batch, or close an open panel

11. Troubleshooting & FAQ

"Could not connect" when I click Connect

Double check your key is copied correctly (starts with sk-ant-) and that your Anthropic account has active credits.

A human-verification check keeps appearing

This is normal — it runs roughly once per hour of activity as a bot-prevention measure, not a sign of a problem.

My document seems cut off in the results

Very long documents are either truncated (with a warning first) or, if you've enabled chunking, split and analyzed in pieces. Turn on Split large files into chunks for full coverage of long documents.

A model I selected won't accept Effort or Extended Thinking

Not every model supports every setting — this varies and changes over time. If a request is rejected, you'll see a plain message saying so, and the app automatically resets that setting (Effort back to Standard, or Extended Thinking off) so you don't have to fix it manually before trying again.

My theme or saved key disappeared

Check the status bar at the bottom of the screen — if it says settings aren't being saved, nothing persists between visits. Turn saving on to keep your preferences.

This guide covers how to use the app. For the full legal and privacy detail, see:

See also Section 7 for how the app checks documents for hidden content and prompt-injection attempts.

In short: your document text goes only to Anthropic's API, using your own key. This site's server never logs, stores, or retains document text, citation content, or your full API key. An anonymous activity log tracks which actions were taken and whether they succeeded, for debugging and usage analysis — never document content.