How to Use Claude Artifacts to Build and Revise a Prototype

How to Use Claude Artifacts to Build and Revise a Prototype

Olivia Park
September 4, 2026· Updated September 5, 2026· 11 min read

To use Claude Artifacts for a prototype, define one testable user journey, ask for the smallest runnable slice, inspect both the preview and code, and revise against a written acceptance matrix. An Artifact can make an idea interactive, but a working preview is not evidence that the design is accessible, secure, accurate, maintainable, or ready for production.[1]

This guide uses a synthetic “meeting-cost estimator” with no real employee data. If you need the product basics first, read the Claude beginner guide; for the broader safety method, start with the practical AI workflow.

Before you begin, confirm that Code execution and file creation is enabled. Anthropic currently directs Free, Pro, and Max users to Settings > Capabilities; Team and Enterprise owners manage the same capability in organization settings. Treat those menu names and availability as implementation-day details because they can change.[1]

Key Takeaways

  • Write the prototype brief and non-goals before asking Claude to build.
  • Limit the first Artifact to one complete user journey.
  • Test expected, boundary, failure, and accessibility cases yourself.
  • Inspect code and behavior; a polished preview can hide fragile logic.
  • Change one variable per revision and label the reason.
  • Share only the intended version and review attached context.
  • Rebuild and review production software in its real repository.

When should you use Claude Artifacts for a prototype?

A good prototype answers a specific question cheaply. It may test whether users understand a flow, whether a calculation is explained clearly, or whether an interaction order feels natural. It should not pretend to prove production reliability.

Anthropic describes Artifacts as substantial, self-contained content shown in a dedicated window, including code, documents, diagrams, and interactive components. Claude can update an Artifact through conversation, and users can move among versions.[1] That makes the feature useful for controlled exploration, provided you preserve the question being tested.

Use this filter:

Prototype questionSuitable ArtifactNot proven by the Artifact
Can a user complete one flow?Small interactive interfaceProduction usability at scale
Is a concept understandable?Diagram or explainerTechnical correctness without review
Does a calculation layout make sense?Synthetic calculatorAccuracy for every input or jurisdiction
Is the copy hierarchy clear?Clickable content mockupBrand, legal, or accessibility approval
Can a data view support a discussion?Synthetic chartCorrectness of private source data

For general coding boundaries, the AI coding guide explains why generated code still needs an owner and a testable repository workflow.

How do you write the prototype brief?

Start outside the chat. A brief should name one user, one problem, one successful path, explicit non-goals, and the evidence needed to accept a revision.

Prototype: meeting-cost estimator
User: facilitator preparing an internal agenda
Question: can the user understand cost before scheduling?
Inputs: attendee count, duration in minutes, synthetic hourly rate
Output: estimated cost plus a plain-language calculation
Success: keyboard-only completion with valid and invalid input feedback
Non-goals: authentication, storage, payroll integration, analytics, deployment
Data rule: synthetic values only; no employee names or compensation records

Include the target viewport and interaction constraints, but avoid prescribing a whole production stack. Ask Claude to list ambiguities before building. Resolve only the ambiguities that affect the test question; park the rest under non-goals.

If the prototype involves uploaded material, minimize it. Anthropic documents supported uploads and notes that processing differs by file type.[3] A redacted excerpt is safer and easier to verify than a large private source bundle.

How do you generate the smallest runnable slice?

1. Request one end-to-end path

Ask for a single screen with three inputs, one action, one result, and one reset. Require local synthetic data and no network calls, account system, external tracking, or persistent storage. This keeps the preview explainable.

Create an interactive Artifact for the brief above.
Build only the successful calculation path plus visible validation.
Use semantic labels and keyboard-operable controls.
Do not add authentication, APIs, storage, analytics, or real employee data.
Show the formula in plain language beside the result.
After creating it, list assumptions and untested behavior separately.

2. Check the interface contract

Before judging colors, confirm that every input has a label, units are visible, the action is clear, and the output states what it represents. A meeting “cost” without currency, time basis, or rounding rule is ambiguous even if the number changes correctly.

3. Inspect the generated code

Use the code view where available and look for hidden defaults, magic numbers, unsafe HTML injection, network access, unbounded input, and state that does not reset. Anthropic documents switching among Artifact versions and editing through the conversation, but the presence of a version history does not replace source control.[1]

The AI code review checklist provides a deeper pass for dependencies, data flow, and security assumptions.

How do you build a prototype acceptance matrix before revising?

Write tests before asking Claude to improve the prototype. Otherwise each revision will optimize for whatever looks most noticeable.

IDCaseInputExpected observationStatus
N1Normal6 people, 30 minutes, valid rateFormula and result agreeUntested
B1Lower boundary1 person, 1 minuteAccepted without rounding to zeroUntested
B2Large valueDocumented maximumUI remains readable and responsiveUntested
F1Missing valueBlank durationSpecific inline error; no resultUntested
F2Invalid valueNegative attendee countRejected; prior result clearedUntested
A1KeyboardTab, type, submit, resetLogical focus order and visible focusUntested
A2Zoom200 percentNo clipped instruction or actionUntested

The matrix is an observation tool, not an automated test suite. Record the Artifact version, browser, date, input, actual result, and evidence for every run. Do not mark a row “pass” because Claude says it fixed the issue.

How should you test the preview and code?

Test the expected path

Calculate one result independently. If six attendees meet for thirty minutes at the synthetic hourly rate, write the formula yourself and compare the displayed number. Check whether the explanation uses the same units and rounding.

Test boundaries

Try zero, one, the stated maximum, decimals, pasted text, and very long input. Decide which values should be rejected rather than letting the prototype invent a policy. A browser accepting a value does not mean the product should accept it.

Test failures and recovery

Submit missing and invalid fields. Errors should identify the field, preserve unrelated valid input, clear stale results when necessary, and allow recovery without a page refresh. Inspect the code to confirm that validation happens before calculation.

Test accessibility basics

Use only the keyboard. Check focus order, visible focus, labels, error association, contrast, zoom, and whether status changes are conveyed beyond color. A prototype cannot certify accessibility, but it can expose obvious barriers before handoff.

Test assumptions against the source

Ask Claude to list all assumptions, then verify the list against the brief and code. Models can omit assumptions and can produce confident but incorrect explanations; Anthropic advises checking important information rather than relying on a generated answer.[4]

The AI-generated test guide can help turn these observations into repository tests after a human confirms the expected behavior.

How do you revise one variable at a time?

Create a revision ticket with one failed condition, the evidence, and the allowed change. Keep layout, data model, and unrelated wording fixed.

Revision R3
Failed check: F2 negative attendee count
Observed: result remains visible after invalid input
Required change: reject negative values and clear the stale result
Do not change: formula, labels, layout, colors, or maximum values
Evidence required: describe the code path changed and ask me to rerun F2

After Claude updates the Artifact, compare the prior and current versions. Run the failed case first, then the normal path and adjacent boundaries. This catches regressions introduced by a narrow-looking patch.

Do not combine “fix validation, redesign the card, rewrite the copy, and add export.” If you cannot attribute an improvement or regression to one change, the revision is too broad.

Keep a version log:

RevisionSingle purposeChecks rerunDecision
R1Establish minimal flowN1, F1Baseline
R2Add keyboard focusA1, N1Keep
R3Clear stale resultF2, N1, B1Keep after retest
R4Explore compact copyA2, N1Reject; instructions unclear

How should you share or publish a Claude Artifact?

First select the exact version. Anthropic distinguishes public publishing for some account types from organization-only sharing for others, and the available action depends on the account and workspace.[2] Do not describe a link as private without checking its actual audience.

Review the conversation and attachments that may become accessible. Anthropic warns that sharing can give viewers access to attachments and files from the conversation that created an Artifact.[2] Build public demonstrations from synthetic content in a clean conversation when possible.

Before sharing, record:

  1. Version and acceptance matrix result.
  2. Intended audience and actual access setting.
  3. Data and attachments included.
  4. Known failures and non-goals.
  5. Owner and removal date.

If a version contains a logo, customer name, proprietary design, or personal data, stop and get the relevant rights and privacy review. “It is only a prototype” does not reduce the audience created by a public link.

How do you hand the prototype to a production team?

Treat the Artifact as a behavioral reference, not a deployable package. Export or copy the version you tested, the brief, acceptance matrix, screenshots if authorized, known failures, and version log. Then recreate the feature in the real repository under its architecture, dependencies, security controls, accessibility system, tests, and review process.

The handoff must separate decisions from generated implementation:

Handoff itemWhat it proves
Prototype briefThe question and non-goals
Selected versionThe interaction chosen for further work
Acceptance evidenceWhat was manually observed
Open issuesWhat remains unproven
Production ownerWho decides architecture and release
Rebuild planHow behavior enters the real system

Do not paste prototype code into production without reviewing licenses, dependencies, data handling, error behavior, and tests. The Canvas revision workflow is useful for documents, but software handoff needs the stronger repository controls above.

Final checklist

  • The brief names one user, question, success path, and non-goals.
  • Inputs are synthetic, minimal, and authorized.
  • The first Artifact implements one complete journey.
  • Preview and code have both been inspected.
  • Expected, boundary, failure, recovery, and accessibility cases are recorded.
  • Each revision changes one variable and reruns adjacent checks.
  • The selected version and actual audience are confirmed before sharing.
  • Attachments and conversation context are reviewed.
  • Production work is rebuilt in the real repository with normal controls.

FAQ

What is a Claude Artifact?

It is substantial content Claude displays in a separate working area, such as code, a document, a diagram, or an interactive component. It can be revised through conversation and revisited by version.[1]

Is an Artifact the same as a production application?

No. An Artifact is useful for exploration and communication, but it does not prove production security, reliability, accessibility, monitoring, data governance, or maintainability.

Should I ask Claude to fix every issue at once?

No. Use one failed acceptance condition per revision, hold unrelated variables constant, and rerun the failed and adjacent cases.

Does a successful preview prove the calculation is correct?

No. Calculate representative cases independently and inspect units, rounding, defaults, and validation in the code.

Can Claude automatically fix Artifact errors?

Claude may propose or apply corrections, but the result still needs independent testing. An automatic repair is a new version to evaluate, not a passed test.

Can I publish an Artifact publicly?

The action and audience depend on your account and workspace. Anthropic currently distinguishes public publishing from organization sharing, so verify the current setting and exact version first.[2]

Can shared viewers see attachments?

They may gain access to attachments associated with the creating conversation, depending on the sharing context. Review the current official sharing guidance and use a clean synthetic conversation for public demos.[2]

Should production engineers reuse the generated code?

They may use it as a reference, but they should review or rebuild it in the real repository with approved dependencies, architecture, tests, accessibility, security, and release controls.

Can a VPN test or deploy a Claude Artifact?

No. A VPN cannot validate prototype behavior, approve access, review code, or convert an Artifact into production software.

Sources

  1. Anthropic, “What are artifacts and how do I use them?” — https://support.claude.com/en/articles/9487310-what-are-artifacts-and-how-do-i-use-them
  2. Anthropic, “Publish and share artifacts” — https://support.claude.com/en/articles/9547008-publish-and-share-artifacts
  3. Anthropic, “Upload files to Claude” — https://support.claude.com/en/articles/8241126-upload-files-to-claude
  4. Anthropic, “Claude is providing incorrect or misleading responses” — https://support.claude.com/en/articles/8525154-claude-is-providing-incorrect-or-misleading-responses-what-s-going-on

Sources checked 5 September 2026.

Related articles

Start your 3-day free trial

Sign up to experience all premium features at no cost.

*Available only to new users. Each user is limited to one trial.

How to Use Claude Artifacts to Build and Revise a Prototype | AethoVPN