Quick Reference — Claude Code Training

Quick Start

5-Minute Installation

Choose your platform and be up and running in minutes.

🍎 macOS (Recommended)

brew install anthropic/brew/claude-code

cd ~/your/mobile/app
claude
# Follow browser login prompt

🪟 Windows (PowerShell)

irm https://install.anthropic.com | iex

# NOTE: Use PowerShell NOT CMD!
# CMD will show && token error

🐧 Linux

curl -sL https://install.anthropic.com | bash
# OR package managers:
sudo apt install claude-code
sudo dnf install claude-code

Common Commands

30+ Mobile Developer Commands

Natural language commands organized by category — copy and paste these as starting points.

⚡ Feature Development

"Create a settings screen with toggles"
"Build a user profile with avatar upload"
"Add search with debouncing"
"Create bottom navigation with 4 tabs"

🐛 Bug Fixing

"The app crashes when loading images. Error: [paste]"
"Navigation is broken on Android. Fix it."
"Fix memory leak in the list component"

✅ Code Quality

"Optimize this component for performance"
"Add proper error handling to this API call"
"Write unit tests for this function"
"Refactor to follow our design patterns"

🌿 Git Workflow

"Commit my changes with a good message"
"Create a feature branch for the payment system"
"Push my changes and open a PR"

🧪 Testing

"Write comprehensive tests for the auth module"
"Run tests and show coverage report"
"Add integration tests for the API layer"

Best Practices

Checklist for Every Task

Follow these checks to get the best results from Claude Code consistently.

🔍 Before You Start Coding

Update CLAUDE.md with current guidelines

Ensure project structure is clean and organized

Have clear requirements and acceptance criteria

Know your tech stack and framework versions

✍️ Writing Effective Prompts

Be specific about requirements

Include acceptance criteria

Mention design patterns to follow

Reference relevant files/components

Include constraints and limitations

Provide examples when helpful

🔎 Code Review Workflow

Review Claude's plan before execution

Review all diffs before committing

Run tests before merging

Check for security issues

Verify accessibility standards

Test on all target platforms

CLAUDE.md Template

Ready-to-Use Project Configuration

Copy this into your project root and customize for your team. Claude Code reads this every session.

📄 CLAUDE.md — place in your project root

# Mobile App Development Guidelines ## Project Overview Brief description of the app and its purpose. ## Tech Stack - React Native 0.72+ / TypeScript - Redux for state management - Jest for testing / ESLint for code quality ## Project Structure /src/screens - Main screens (full-page components) /src/components - Reusable UI components /src/services - API clients, utilities, helpers /src/redux - Redux store, slices, selectors /src/styles - Theme, colors, typography /src/hooks - Custom React hooks ## Naming Conventions - Components: PascalCase (UserProfile.tsx) - Functions: camelCase (getUserData) - Constants: UPPER_SNAKE_CASE (API_TIMEOUT) ## Code Standards - All code must be TypeScript (strict mode) - Props typed with interfaces - Minimum 80% code coverage - Accessibility: WCAG 2.1 - Max line length: 100 characters ## Git Workflow - Feature branches: feature/feature-name - Bugfix branches: bugfix/bug-name - Commit messages: "Feature: Description" ## Known Issues & Gotchas - Image picker has permission issue on Android 13 - Navigation state sometimes persists on logout

Workflow

From Request to Commit

Total time: 25–45 minutes vs. 2–4 hours manually.

1

Plan

What do I want to build? Clear requirements, acceptance criteria, dependencies.

⏱ 2 min

2

Brief Claude Code

"Build [feature] with [requirements]" — be specific about what you need.

⏱ 1 min

3

Review Plan

Claude Code shows its approach. Approve, reject, or request changes before any execution.

⏱ 3 min

4

Execute

Claude Code creates/edits files across your project, maintains consistency, runs tests.

⏱ 5–15 min

5

Review Diffs

Check code quality, style consistency, test results, no breaking changes, security.

⏱ 5 min

6

Iterate

"Can you adjust [component] to [requirement]?" — refine until satisfied.

⏱ 5–10 min

7

Commit & Push

"Commit and push these changes" — or commit manually when satisfied.

⏱ 2 min

Debugging Guide

When Something Goes Wrong

A structured approach to fixing bugs with Claude Code.

!

Gather Info

Error message, full stack trace, steps to reproduce, platform (iOS / Android).

2

Share with Claude

"I'm getting this error when loading the user profile:
[paste full error / stack trace]

Steps to reproduce:
1. Launch app
2. Tap on profile
3. Error appears"

3

Review the Fix

Understand what broke, verify the fix addresses root cause, check for side effects.

✓

Test Thoroughly

Run affected tests, test on both iOS and Android, verify the full flow works end-to-end.

Security Checklist

Keep Your Code Secure

Critical security practices when using AI-assisted code generation.

❌ Never hardcode credentials

const API_KEY = "sk_live_abc123xyz";
const DB_PASS = "myPassword123";

✓ Always use environment variables

const API_KEY = process.env.STRIPE_API_KEY;
const DB_PASS = process.env.DB_PASSWORD;

🔑 API Credentials

Use environment variables for all secrets

Never commit .env files

Rotate keys regularly

Different keys per environment

🛡️ Authentication & Data

Use secure token storage

Implement token refresh flow

Logout must clear all tokens

Encrypt sensitive data at rest

Use HTTPS for all API requests

Validate and sanitize user input

Example Prompts

Copy-Paste Starting Points

Use these as templates — adapt to your project's specific needs.

🔐 Authentication System

"Create a complete authentication system with:
- Login screen with email/password validation
- Signup screen with password strength indicator
- JWT token management
- Redux store for auth state
- API integration
- Error handling for auth failures
- Logout functionality
- Automatic token refresh"

📋 List Screen with Pagination

"Build a user list screen that:
- Shows users in a scrollable list
- Implements pagination (10 items per page)
- Has search/filter functionality
- Shows loading and empty states
- Handles network errors
- Has pull-to-refresh
- Uses FlatList for performance"

📸 Image Upload Feature

"Add image upload feature:
- Image picker integration
- Preview before upload
- Loading state during upload
- Error handling for large files
- Resize optimization
- Display success/error messages
- Store image URL in Redux"

⚡ Performance Optimization

"Optimize the ProductList component:
- It's re-rendering too often
- Current performance: 2000ms for 50 items
- Use FlatList instead of ScrollView
- Implement item memoization
- Add virtual scrolling
- Target: 500ms for 50 items with smooth scrolling"

📱 Cross-Platform Fix

"Fix navigation inconsistency:
- Works correctly on iOS
- Broken on Android (back button doesn't work)
- Use platform-specific handling where needed
- Test on both platforms
- Ensure consistent UX across devices"

Lab Exercises

4 Training Exercises

Complete these in order during the hands-on lab session.

1

Install & Explore (10 min) — Install Claude Code, navigate to sample project, run claude, ask "What does this project do?" and observe understanding.

2

Create a Component (15 min) — Ask: "Create a reusable Card component that accepts title (string), description (string), onPress callback, optional backgroundColor with TypeScript typing and basic styling."

3

Fix a Bug (15 min) — Introduce a simple bug, share the error/stack trace: "Fix this bug that crashes the app." Watch Claude diagnose and fix it, then verify tests pass.

4

Refactor Code (15 min) — Select an existing function/class: "Refactor this component to use hooks instead of class, extract logic to a custom hook, improve performance with memoization."

Troubleshooting

Quick Fixes Reference

Common issues and how to resolve them in under 2 minutes.

Error / Issue	Cause	Fix
"command not found: claude"	Installation incomplete or PATH not set	Restart terminal, check PATH variable, reinstall
"&& token not valid"	Running in CMD, not PowerShell	Open Windows PowerShell instead of CMD
Permission denied (macOS)	npm global permissions issue	Use nvm to install Node.js, or use Homebrew
Doesn't understand project	No CLAUDE.md, messy structure	Create/update CLAUDE.md with project details
Wrong code style generated	CLAUDE.md missing style rules	Add naming, indentation, patterns to CLAUDE.md
Tests failing after changes	Generated code broke tests	Ask: "Fix the failing tests broken by these changes"
"Model unavailable" error	API down, expired auth, no internet	Check internet → logout & re-login → check status page
Running slowly	Poor connection or large context	Check internet speed, break into smaller tasks

Full FAQ & Troubleshooting → 📄 View Syllabus

Quick Reference Guide