목록으로 돌아가기

블로그

튜토리얼: Tactic Remote로 풀스택 앱 원격 개발하기

iPhone에서 Claude Code를 지시하여 완전한 태스크 관리 앱을 만드는 과정을 따라가 보세요 — 모바일에서도 상당한 개발 작업이 가능함을 증명합니다.

게시일 태그: 시작 가이드 / fullstack / workflow / hands-on
블로그

이 카테고리의 제품 및 엔지니어링 업데이트를 확인하세요.

카테고리 보기

이 튜토리얼에서는 완전한 풀스택 애플리케이션 — React 프론트엔드가 있는 태스크 관리 API — 을 Tactic Remote를 통해 완전히 빌드하는 과정을 안내합니다. iPhone에서 Claude Code를 지시하고 Mac이 무거운 작업을 수행합니다.

끝나면 작동하는 애플리케이션과 Tactic Remote가 가능하게 하는 원격 개발 워크플로우에 대한 실용적 경험을 갖게 됩니다.

사전 요구 사항

시작하기 전에 다음을 확인하세요:

  • Tactic Remote가 설정되고 연결됨 (시작하기 가이드)
  • Mac에 Node.js 18+ 설치됨
  • 작업 프로젝트 디렉토리 (여기서는 ~/projects/taskflow 사용)

파트 1: 프로젝트 설정 (10분)

iPhone에서 Tactic Remote를 열고 프로젝트 디렉토리를 가리키는 새 세션을 시작합니다.

프롬프트 1: 프로젝트 스캐폴딩

Claude Code에 다음 프롬프트를 전송합니다:

Create a full-stack task management application called TaskFlow.

Backend:
- Express.js server with TypeScript
- SQLite database with better-sqlite3
- RESTful API: CRUD for tasks and projects
- Input validation with zod

Frontend:
- React 18 with TypeScript
- Vite for bundling
- Tailwind CSS for styling
- React Query for data fetching

Set up the monorepo structure with packages/api and packages/web.
Use a root package.json with workspaces.

Claude Code가 이 작업에 3-5분 동안 작업합니다. 디렉토리를 만들고, 설정 파일을 작성하고, 의존성을 설치하는 것을 볼 수 있습니다. 이때 휴대폰을 내려놓아도 됩니다 — Tactic Remote가 작업이 완료되거나 승인이 필요하면 알림을 보내줍니다.

주의할 점: Claude Code가 npm install 실행 승인을 요청할 가능성이 높습니다. 알림에서 승인하세요 — 프로젝트의 의존성을 설치하는 것입니다.

프롬프트 2: 설정 검증

스캐폴딩이 완료되면 모든 것이 작동하는지 검증합니다:

Start both the API server and the frontend dev server.
Run any initial tests. Report the URLs where each is accessible.

Claude Code가 서버를 시작하고 API의 경우 http://localhost:3001, 프론트엔드의 경우 http://localhost:5173 같은 URL을 보고하는 것을 볼 수 있습니다.

파트 2: API 구축 (20분)

이제 실질적인 비즈니스 로직으로 백엔드 API를 구축합니다.

프롬프트 3: 데이터베이스 스키마 및 모델

Create the database schema and models:

Tables:
- projects: id, name, description, color (hex), created_at, updated_at
- tasks: id, project_id (FK), title, description, status (todo/in_progress/done),
  priority (low/medium/high/urgent), due_date, created_at, updated_at

Include:
- Migration system that runs on server start
- Type-safe model layer with full TypeScript types
- Seed data: 2 sample projects with 5 tasks each

이 프롬프트는 AI 지원 개발의 핵심 장점을 보여줍니다: 무엇을 설명하면 Claude가 어떻게를 처리합니다. 결과에는 적절하게 타입이 지정된 모델, SQL 마이그레이션, 시드 데이터가 포함됩니다 — 인간 개발자가 30-60분이 걸리는 작업입니다.

프롬프트 4: 검증이 포함된 API 라우트

Implement the full REST API:

Projects:
- GET /api/projects (list all, with task counts)
- POST /api/projects (create, validate with zod)
- PUT /api/projects/:id (update)
- DELETE /api/projects/:id (cascade delete tasks)

Tasks:
- GET /api/projects/:id/tasks (list by project, support ?status= filter)
- POST /api/projects/:id/tasks (create with validation)
- PUT /api/tasks/:id (update, including status transitions)
- DELETE /api/tasks/:id

Include proper error handling with consistent error response format.
Add request logging middleware.

승인 참고: Claude Code가 여러 파일 수정 승인을 요청할 수 있습니다. 승인 카드에서 파일 목록을 검토하세요 — 프로젝트의 packages/api/ 디렉토리 내 파일로 제한되어야 합니다. 이 범위 밖의 파일이 보이면 거부하고 프롬프트를 명확히 하세요.

프롬프트 5: API 테스트

Write integration tests for all API endpoints using vitest and supertest.
Test both success cases and error cases (invalid input, not found, etc.).
Run the tests and report results.

터미널 뷰에서 테스트 결과가 스트리밍되는 것을 지켜보세요. 녹색 통과 테스트는 휴대폰 화면에서도 만족스럽습니다. 테스트가 실패하면 Claude Code가 일반적으로 자동으로 문제를 진단하고 수정합니다.

파트 3: 프론트엔드 구축 (25분)

프롬프트 6: 핵심 UI 컴포넌트

Build the frontend UI:

1. Layout with sidebar (project list) and main area (task board)
2. ProjectList component: shows projects with task counts and color indicators
3. TaskBoard component: kanban-style columns for todo/in_progress/done
4. TaskCard component: shows title, priority badge, due date
5. Drag-and-drop between columns to change task status

Use React Query for all data fetching. Show loading skeletons.
Style with Tailwind - clean, modern look with the project color as accent.

지금까지 가장 실질적인 프롬프트입니다. Claude Code가 여러 컴포넌트를 생성하고, 라우팅을 설정하고, React Query를 구성하고, 드래그 앤 드롭을 구현합니다. 5-8분의 작업이 예상됩니다.

프롬프트 7: 폼과 인터랙션

Add interactive features:

1. Create Project modal: name, description, color picker
2. Create Task modal: title, description, priority selector, due date picker
3. Inline task editing: click to edit title, click priority to cycle through levels
4. Delete confirmation dialogs for projects and tasks
5. Toast notifications for successful operations

All forms should validate input and show helpful error messages.

프롬프트 8: 마무리 및 반응형 디자인

Polish the UI:

1. Make everything fully responsive (mobile-friendly at 375px+)
2. Add empty states for projects and tasks (with calls-to-action)
3. Add a search/filter bar: filter tasks by title or status
4. Add keyboard shortcuts: N for new task, / for search
5. Add subtle animations for card transitions and modal open/close

Fix any visual issues you notice.

파트 4: 통합 및 최종 검증 (10분)

프롬프트 9: 엔드 투 엔드 검증

Verify the complete application:

1. Start the API server and frontend
2. Create a new project through the UI
3. Add several tasks with different priorities
4. Move tasks between columns
5. Edit and delete tasks
6. Test responsive layout at mobile sizes
7. Report any issues found and fix them

Provide the final URLs to access the application.

프롬프트 10: 문서화

Create a README.md in the project root with:

1. Project description and screenshot placeholder
2. Tech stack overview
3. Getting started instructions (install, run, test)
4. API endpoint documentation with example requests/responses
5. Project structure explanation

방금 완성한 것

약 한 시간 동안 휴대폰에서 Claude Code를 지시하여 다음을 만들었습니다:

  • SQLite 지속성이 있는 TypeScript Express API
  • 드래그 앤 드롭 칸반 보드가 있는 React 프론트엔드
  • 검증이 포함된 전체 CRUD 작업
  • 통합 테스트
  • 반응형 디자인
  • 프로젝트 문서

이것은 사소한 애플리케이션이 아닙니다 — 수십 개 파일에 걸쳐 수백 줄의 코드입니다. 그리고 책상에 앉지 않고도 만들었습니다.

원격 풀스택 개발 팁

작업을 명확한 단계로 나누세요. 전체 애플리케이션을 하나의 프롬프트로 설명하려 하지 마세요. 단계별 프롬프팅이 더 나은 결과를 내는데, 각 프롬프트가 이전 단계의 검증된 작업 위에 구축되기 때문입니다.

각 단계 후 검증하세요. 각 주요 작업 후에 Claude Code에 테스트를 실행하거나 서버를 시작하도록 요청하세요. 초기에 문제를 잡으면 연쇄적인 문제를 방지합니다.

승인 알림을 현명하게 사용하세요. 승인 흐름은 단순한 보안 기능이 아닙니다 — Claude Code가 수행하는 작업을 검토하고 필요시 방향을 수정할 수 있는 체크포인트입니다.

지속적으로 보고 있지 마세요. 원격 개발의 핵심은 자유입니다. 프롬프트를 시작하고, 휴대폰을 내려놓고, 알림을 받으면 돌아오세요. 시스템을 신뢰하세요.

다음 단계

Tactic Remote 사용해 보기

휴대전화로 코딩 에이전트를 원격 제어하세요

Mac, Windows, Linux 컴퓨터의 Claude Code, Codex 등에 연결하세요. iPhone이나 iPad에서 진행 상황을 확인하고 다음 요청을 보낼 수 있습니다.