A Non-Developer's Path
Nightschool AI: Build Your First iPhone App with Claude Code and Xcode
Apple's Xcode, iPhone, the App Store, and TestFlight, and Anthropic's Claude are named here only to describe them accurately. Nightschool AI is independent and not affiliated with or endorsed by Apple or Anthropic.
Install Xcode (26.3 or later) free from the Mac App Store, then connect Claude in its coding-intelligence settings, which needs a Claude plan that includes Claude Code. Describe your app in plain English, and preview and test it in the free iOS Simulator. TestFlight and the App Store also require the paid Apple Developer Program: 99 US dollars a year.
Published
Key Takeaways
- Xcode 26.3 gives Claude subagents, background tasks, and plugins inside the IDE, plus the ability to read Xcode Previews to check how a screen actually renders.
- A Mac and a free Apple Account build an app by hand, run it in the Simulator, and test it on your own iPhone, but using Claude needs a paid Claude plan with Claude Code.
- TestFlight, for handing a beta to other people, and the App Store both require the paid Apple Developer Program: 99 US dollars a year, per Apple's own enrollment page.
- Xcode 26.3 also exposes its capabilities over the Model Context Protocol, so Claude Code running in a terminal can connect to Xcode directly.
- The fastest way to learn the workflow is to copy a tiny existing app's worst complaints and build a version that fixes exactly those, then check it yourself in the simulator.
Copy and Paste
Prompts You Can Use Today
Describe your first app idea
I want to build a very small iPhone app: [describe it in one or two sentences, e.g. a single-screen timer for pour-over coffee]. I have no programming background. Start by asking me the handful of questions you actually need answered before you write any code, then propose a plan with just the screens and features this needs, nothing extra.
Keep the scope small on purpose. One screen that works beats five that don't.
Turn App Store complaints into a spec
Here are the three most common complaints I found in the one- and two-star App Store reviews for [name an existing app that does roughly what I want]: [paste the three complaints in the reviewers' own words]. Help me turn these into a short, concrete spec for my own small app so that it specifically avoids each of these three problems, and nothing more ambitious than that.
This is the 'first app idea' exercise below, as a prompt you can paste in directly.
Review a change before accepting it
Before I accept this change, explain in plain language what you just edited, which files changed, and what would visibly break in the app if this turned out to be wrong. I want to understand the change, not just approve it because it compiles.
Run this every time Claude proposes an edit until reading diffs feels normal.
Get ready for TestFlight
I've enrolled in the Apple Developer Program and want to send this app to five friends for feedback through TestFlight. Walk me through what I need to set up in Xcode and App Store Connect for a TestFlight beta, in order, and tell me which steps need my Apple Developer account rather than just Xcode.
Save this for after your free testing in the simulator and on your own phone looks solid.
Prepare an honest App Store listing
Help me write an App Store listing for this app: a name, a short description, and a longer description, that describes only what the app actually does today, with nothing promised that isn't built yet. Also list anything Apple's App Store review guidelines commonly flag for an app like this, so I can check it myself before submitting.
Submit only once your TestFlight testers have actually used the app for a few days.
The full guide
Tap any section to open it.
About this guide
Apple's Xcode 26.3 added a native integration with the Claude Agent SDK, the same engine behind Anthropic's Claude Code, which changes what a first-time builder with no programming background can realistically do with just an idea, a Mac, and some patience. This guide covers what actually shipped, what it costs at each stage, a path from install to the App Store, common mistakes, and a first-app exercise with a way to check your own work.
What Just ShippedXcode Can Now Build With You, Not Just Autocomplete
Xcode 26.3 adds a native integration with the Claude Agent SDK, the same harness that runs Anthropic's Claude Code, going beyond the turn-by-turn-only assistant that shipped in Xcode 26 (anthropic.com/news/apple-xcode-claude-agent-sdk).
Inside Xcode you get, in Anthropic's own words, the full power of Claude Code: subagents that split up work, background tasks that keep running while you do something else, and plugins, all without leaving the editor.
Claude can also read Xcode Previews to check what a SwiftUI screen actually looks like, explore how a project's files connect before editing anything, and break a goal into steps it carries out on its own. Xcode 26.3 also exposes these capabilities over the Model Context Protocol, so Claude Code running in a terminal can connect to Xcode too.
Inside The IDEWhat Claude Actually Does Once It's Connected
Six capabilities Apple and Anthropic describe once Xcode 26.3 is connected to Claude, per Anthropic's own announcement.
Subagents
Claude can split a task across subagents working in parallel instead of doing everything in one long, serial pass.
Background tasks
Longer jobs keep running in the background while you keep working in Xcode, instead of freezing the editor until they finish.
Plugins
Plugins extend what Claude can do inside Xcode, the same way they extend Claude Code's terminal, alongside subagents and background tasks.
Visual verification with Previews
Claude can capture an Xcode Preview, look at the rendered interface, and catch a problem a person would normally have to notice by eye first.
Cross-project reasoning
Before editing, Claude can explore how a project's files and folders actually connect, instead of guessing from one file in isolation.
An MCP connection to Claude Code
Xcode exposes its own capabilities over the Model Context Protocol, so Claude Code in a terminal can reach into Xcode and capture Previews without you switching windows.
Before You StartWhat You Need, and What It Actually Costs
You need a Mac that can run Xcode (26.3 or later), Xcode itself, free from the Mac App Store, and an Apple Account.
A free Apple Account is enough to install Xcode, build an app by hand, and run it on your own iPhone through Xcode itself (developer.apple.com/programs). Connecting Claude is a separate cost: Anthropic's own page says Claude in Xcode works with any Claude plan that includes Claude Code, Pro, Max, or a premium Team or Enterprise seat, and that your usage limit is shared across every platform where you use Claude (anthropic.com/news/claude-in-xcode).
Apple's own enrollment page is specific about what its paid tier adds on top of a free account: inviting testers and managing beta builds through TestFlight, and distributing apps on the App Store. That tier, the Apple Developer Program, costs 99 US dollars a year (developer.apple.com/programs). A free account's on-device testing is also capped: Apple's compare-memberships page limits it to 3 registered devices, with provisioning profiles that expire after 7 days and need reinstalling through Xcode (developer.apple.com/support/compare-memberships).
Put plainly: Xcode itself and testing on your own phone cost nothing beyond owning a Mac. Using Claude inside Xcode needs a Claude plan that includes Claude Code, on top of that. Only sharing the app with other people, through TestFlight or the App Store, requires that 99-US-dollar-a-year Apple Developer Program membership.
The First HalfFrom Nothing to a Running Preview
The free part of the path, from an empty Mac to an app you can see working.
1. Install Xcode and sign in
Install Xcode (26.3 or later) free from the Mac App Store, open it, and sign in with your Apple Account. This step alone needs no paid Claude or Apple Developer plan.
2. Connect Claude
Open Xcode's coding-intelligence setup and connect Claude, which needs a Claude plan that includes Claude Code, so the agent can work inside the editor rather than only answering one question at a time.
3. Describe the app in plain English
Tell Claude what you want in a sentence or two. Let it ask clarifying questions and propose a small plan before it writes any code.
4. Preview as it builds
Use Xcode Previews to see each screen as Claude builds it, and ask it to look at the same Preview itself when something looks wrong.
The Second HalfFrom Prototype to Real Testers
The part that costs 99 US dollars a year, once you have something worth sharing.
5. Test it properly in the Simulator
Run the app in the iOS Simulator and use it the way a stranger would, start to finish, before you show it to anyone else.
6. TestFlight it to a few friends
Once you've enrolled in the Apple Developer Program, use TestFlight to send a beta build to a handful of real people and watch what confuses them.
7. Submit to the App Store
Write an honest listing, submit for Apple's review, and expect a round or two of feedback before it goes live. This step also needs the paid membership.
Avoid TheseMistakes First-Time Builders Make
Most of these cost time, not money, which is exactly why they're easy to walk into.
Skipping the free testing stage
Jumping straight to TestFlight or the App Store skips the free simulator and on-device testing that would have caught the same bugs for nothing.
Accepting changes without reading them
Claude edits real files directly. Ask it to explain a change in plain language before you accept it, not after something breaks.
Treating TestFlight as the finish line
TestFlight is for beta testers, not customers. The App Store is a separate submission with its own review, after TestFlight feedback, not instead of it.
Assuming the free tier covers everything
A free Apple Account builds, previews, and runs an app on your own device. It doesn't include Claude, which needs its own paid plan, and it doesn't let you hand the app to anyone else outside your device; only the paid Apple Developer Program does that.
A Concrete ExerciseYour First App Idea: Steal the Complaints, Fix Them
Pick something small on purpose: a timer, a tip calculator, a single-screen habit tracker, not a social network. Then open the App Store listing for an existing app that does roughly the same thing and read its most recent one- and two-star reviews.
Write down the three complaints that come up most, in the reviewers' own words rather than your paraphrase. Those three complaints become your spec: your app's whole job is to not do the thing people are complaining about.
Build just enough to address those three complaints and nothing more, then open it in the iOS Simulator and go through each complaint one at a time, checking whether your app actually avoids it or only looks like it might.
That simulator pass is the outside check on the exercise: a build that still has one of the three original complaints baked into it hasn't actually finished the assignment, no matter how polished the rest of the screen looks.
Practice Describing Software Before You Describe an App
Everything above assumes you can already turn a vague idea into a clear instruction Claude can act on. Nightschool AI's free first lesson teaches exactly that with Anthropic's Claude Code, before you spend a Mac and an afternoon on your first app.
Frequently Asked Questions
What exactly did Xcode 26.3 add for Claude Code?
A native integration with the Claude Agent SDK, the same harness behind Anthropic's Claude Code, going beyond the turn-by-turn-only assistant Xcode 26 shipped with. Inside Xcode, Claude gets subagents, background tasks, and plugins, can read Xcode Previews to check rendered screens, and can reason across a project's files before editing anything, per Anthropic's own announcement.
Do I need to already know how to code?
No. You need patience, a small idea, and a willingness to describe what you want clearly and check the result yourself. Claude writes the code; your job is to specify what the app should do and verify what it actually does, in the simulator and on your own phone.
What do I actually need to start building?
A Mac able to run Xcode (26.3 or later), Xcode itself (free from the Mac App Store), and an Apple Account. A free account is enough to build an app by hand, preview it, and run it on your own iPhone through Xcode. Using Claude to write the code for you needs a Claude plan that includes Claude Code.
Is Xcode free?
Yes, Xcode itself is a free download from the Mac App Store. Two other things can cost money: a Claude plan that includes Claude Code, if you want Claude's help inside Xcode, and the Apple Developer Program, once you want to share an app with other people through TestFlight or the App Store.
How much is the Apple Developer Program, and what does it unlock?
99 US dollars a year, per Apple's own enrollment page. It adds TestFlight beta distribution, the ability to publish on the App Store, analytics and sales reports, and direct technical support from Apple, on top of what the free account already gives you.
Can I test my app without paying anything?
Partly. A free Apple Account lets you build in Xcode, preview screens, run the app in the iOS Simulator, and install it on your own iPhone through Xcode directly, and you only need the paid Apple Developer Program once someone else needs to open the app on their own device. Using Claude to help you build it is a separate cost: that needs a Claude plan that includes Claude Code, Pro, Max, or a premium Team or Enterprise seat, whether or not you ever distribute the app.
What's the actual difference between the Simulator, TestFlight, and the App Store?
The Simulator runs on your Mac and costs nothing. TestFlight sends a beta build to real people's phones and requires the paid Apple Developer Program. The App Store is the public release, submitted separately for Apple's review, also gated behind that same paid membership.
Is this guide affiliated with Apple or Anthropic?
No. This is an independent educational guide from Nightschool AI. It names Apple's Xcode, iPhone, App Store, and TestFlight, and Anthropic's Claude, only to describe how they actually work, with no affiliation, partnership, or endorsement from Apple or Anthropic in either direction.
Learn the Habit Before You Lean on the Agent
A small, well-described app and a habit of checking the result yourself matter more here than any single feature Xcode just added.