기본 콘텐츠로 건너뛰기

글

Pinned Post

Claude Code로 투두리스트 만들기: 기획부터 구현, 테스트, 문서화까지

Claude Code로 투두리스트 만들기: 기획부터 구현, 테스트, 문서화까지 AI 코딩 도구를 활용할 때 처음부터 모든 기능을 한 번에 구현하도록 요청하면 요구사항이 누락되거나 기존 프로젝트 구조와 맞지 않는 코드가 만들어질 수 있습니다. 이번 글에서는 투두리스트(To-do List)를 예제로 Claude Code를 활용한 개발 과정을 정리합니다. 요구사항 분석부터 설계, 구현, 테스트, 문서화, 최종 점검까지 여섯 단계로 나누어 진행합니다. 작성 기준일: 2026년 11월 3일 핵심 내용 Sonnet을 주 작업 모델로 사용하고, 복잡한 설계나 반복 오류 검토에는 Opus Advisor를 활용합니다. 기존 코드 탐색은 Haiku 기반 Subagent에 맡기고, 단계별 결과는 Markdown 파일로 저장해 다음 작업에 전달하는 방식입니다. 1. 전체 개발 프로세스 전체 과정은 다음과 같습니다. 기획: 요구사항 수집 및 확정 설계: 화면, API, 데이터베이스, Command/Query 설계 구현: DB, Handler, Controller, Vue 순서로 개발 테스트: 테스트 시나리오 작성 및 실행 문서화: 실제 구현 내용을 개발 문서로 정리 종료: 보안 점검, 사용량 확인, Git 커밋 각 단계가 끝나면 결과물을 파일로 저장하고, 다음 단계에서는 해당 파일을 읽어 작업합니다. 작업 성격에 따라 /clear 로 새로운 세션을 시작하면 이전 대화의 불필요한 문맥이 누적되는 것을 줄일 수 있습니다. 2. 사전 준비 2-1. 프로젝트 폴더 구성 프로젝트 루트에 다음 구조를 준비합니다. ProjectRoot/ ├── CLAUDE.md ├── .claude/ │ └── agents/ │ └── explorer.md └── docs/ ├── 01-requirements.md ├── 0...
최근 글

부산 상어 '부캉이' 어디로 갔을까? 나흘째 모습 감춰…당국, 현장 모니터링 중단

NEWS · 부산 · 해양 생태 부산 상어 '부캉이' 어디로 갔을까? 나흘째 모습 감춰…당국, 현장 모니터링 중단 한 달 넘게 부산 북항 친수공원 인공 수로에 머물렀던 상어 부캉이가 바다로 나간 뒤 모습을 드러내지 않고 있다. 당국은 매일 진행하던 현장 관찰을 중단하고 시민 제보에 대응하는 방식으로 전환했다. 작성 기준일 : 2026년 10월 30일 원문 송고 : 2026년 10월 30일 15시 52분 출처 : 연합뉴스 이번 소식의 핵심 부캉이는 10월 21일 당국의 외해 유도 작업으로 인공 수로를 벗어났다. 10월 24일에는 국제여객터미널 앞바다에서 목격됐다. 10월 27일부터 당국의 모니터링에 포착되지 않고 있다. 국립수산과학원은 10월 30일부터 매일 진행하던 현장 모니터링을 중단했다. 앞으로는 시민 제보가 접수되면 비상 대기조가 현장에 출동한다. 1. 한 달 넘게 머물던 수로를 떠난 부캉이 부산 북항 친수공원 인공 수로에 한 달 넘게 머물렀던 상어 '부캉이'가 바다로 나간 뒤 좀처럼 모습을 드러내지 않고 있다. 부캉이는 10월 21일 당국의 외해 유도 작업을 통해 친수공원 수로 밖으로 이동했다. 이후 수로와 가까운 제1부두 앞바다에서 모습을 보였고, 10월 24일에는 기존 장소에서 약 2km 떨어진 국제여객터미널 앞바다에서도 목격됐다. 처음에는 북항 주변에서 이동하는 모습이 확인됐지만, 10월 27일부터는 당국의 모니터링에서도 더 이상 발견되지 않았다. 당국은 부캉이를 찾기 위해 제5부두 등으로 관찰 범위를 넓혔다. 그러나 추가 목격은 없었다. 27일에는 시민 제보도 접수됐지만, 이후에는 별다른 제보가 들어오지 않은 상황이다. 2. 10월 30일부터 현장 모니터링 방식 변경 국립수...

3편. Docker 볼륨, PostgreSQL 백업과 복구 실습

실무 실습 가이드 · 기준일: 2026년 10월 30일 3편. Docker 볼륨, PostgreSQL 백업과 복구 실습 컨테이너를 재생성한 뒤 데이터가 남는지 확인하고, 백업 파일을 만들어 별도 데이터베이스에 복원합니다. 운영을 시작하기 전에 꼭 연습해야 할 절차입니다. 1. 데이터 영속성 확인 Docker 볼륨은 컨테이너와 데이터 파일의 수명을 분리합니다. 먼저 보존 여부를 확인할 데이터를 등록합니다. Set-Location D:\Dev\DockerCourse\TaskApi $t=Invoke-RestMethod -Uri http://localhost:5080/api/tasks -Method Post -ContentType application/json -Body (@{title='볼륨 영속성 확인'} | ConvertTo-Json -Compress) docker compose exec db psql -U taskuser -d taskdb -c 'SELECT "Id","Title" FROM tasks ORDER BY "Id";' Compose 서비스를 내렸다가 다시 올립니다. docker compose down docker compose up -d docker compose exec db pg_isready -U taskuser -d taskdb docker compose exec db psql -U taskuser -d taskdb -c 'SELECT "Id","Title" FROM tasks ORDER BY "Id";' 주의: 이번 테스트에서는 docker compose down -v 를 실행하지 않습니다. -v 는 Compose가 관리하는 명명된 볼륨을 삭제할 수 있습니다. 볼륨은 컨테이너 재생성에는 데이터를 보존하지만, 서버 장애나 볼륨 손실에 대비하려면 별도 백업이 필요합니다. 2. PostgreSQL...

2편. PostgreSQL 연결과 ASP.NET Core CRUD 구현

실무 실습 가이드 · 기준일: 2026년 10월 30일 2편. PostgreSQL 연결과 ASP.NET Core CRUD 구현 PostgreSQL, EF Core, CRUD를 실습합니다. 1. 패키지 설치 프로젝트 폴더에서 EF Core와 PostgreSQL 공급자를 설치합니다. .NET 10과 호환되는 패키지 버전을 맞춥니다. Set-Location D:\Dev\DockerCourse\TaskApi dotnet add package Microsoft.OpenApi --version 2.13.0 dotnet add package Npgsql.EntityFrameworkCore.PostgreSQL --version 10.0.3 dotnet add package Microsoft.EntityFrameworkCore.Design --version 10.0.14 dotnet tool install --global dotnet-ef --version 10.0.14 EF CLI가 이미 있다면 마지막 명령 대신 dotnet tool update --global dotnet-ef --version 10.0.14 를 실행합니다. 2. 모델과 DbContext Models , Data 폴더를 만들고 파일을 추가합니다. New-Item -ItemType Directory -Force Models,Data | Out-Null Models/TaskItem.cs namespace TaskApi.Models; public sealed class TaskItem { public int Id { get; set; } public string Title { get; set; } = string.Empty; public bool IsCompleted { get; set; } } Models/TaskRequests.cs namespace TaskApi.Models; public sealed class CreateTaskRequest { public string? Title { get; init...

1편. Docker 설치부터 ASP.NET Core API 컨테이너 실행까지

실무 실습 가이드 · 기준일: 2026년 10월 30일 1편. Docker 설치부터 ASP.NET Core API 컨테이너 실행까지 Docker를 처음 사용하는 개발자를 위해 설치, 프로젝트 생성, 이미지 빌드, 컨테이너 실행을 단계별로 살펴봅니다. 아래 명령은 Windows 11 PowerShell 기준입니다. 1. Docker와 .NET 설치 Windows 11에서 Linux 컨테이너를 실습합니다. Docker Desktop은 공식 설치 안내 를 따르고, .NET 10 SDK는 다운로드 페이지 에서 설치합니다. WSL이 없다면 관리자 PowerShell에서 아래 명령을 실행하고 Windows를 재시작합니다. wsl --install wsl --update 설치 후 Docker Desktop을 열고 Linux/WSL 2 엔진이 시작되도록 합니다. 다음 세 명령을 확인합니다. dotnet --list-sdks docker version docker compose version .NET SDK 목록에 10.0.x가 표시되고, Docker의 Client와 Server 정보 및 Compose 버전이 나오면 준비가 끝났습니다. .NET 10은 2028년 11월까지 지원되는 LTS 버전입니다( 지원 정책 ). 2. 첫 Web API 만들기 프로젝트 폴더를 만들고 Minimal API를 생성합니다. 8080 포트는 기존 Nginx 실습 컨테이너가 사용할 수 있으므로 Windows 쪽 API 포트는 5080으로 고정합니다. New-Item -ItemType Directory -Force D:\Dev\DockerCourse | Out-Null Set-Location D:\Dev\DockerCourse dotnet new webapi -n TaskApi --framework net10.0 --no-https Set-Location .\TaskApi 템플릿에서 Microsoft.OpenApi 의 NU1903 취약성 경고가 나올 수 있습니다. 2편에서 수정된 패키지 버전 적용 ...

MoAI-ADK 워크플로우 명령어 사용법: 누가나 이해하는 프로젝트·계획·구현·정리 가이드

AI 개발 도구 · MoAI-ADK 사용 가이드 MoAI-ADK 워크플로우 명령어 익히기: 프로젝트 분석부터 코드 구현까지 AI 코딩 도구를 사용하다 보면 원하는 기능을 설명하고 코드를 만들어 달라고 요청하는 일이 많습니다. 하지만 기존 프로젝트에 새로운 기능을 추가할 때는 코드를 작성하는 것만큼 먼저 구조를 파악하고, 요구사항을 정리하고, 구현 결과를 확인하는 과정도 중요합니다. MoAI-ADK의 워크플로우 명령어를 익혀 두면 이러한 작업을 단계별로 진행할 수 있습니다. 작성 기준일: 2026년 10월 28일 · 공식 문서 기준 먼저 알아둘 네 가지 명령어 처음부터 모든 명령어를 외울 필요는 없습니다. 우선 프로젝트를 이해하고, 계획을 세우고, 코드를 구현한 다음, 결과를 정리하는 흐름부터 익혀 보세요. 01. project 기존 프로젝트 분석 02. plan 요구사항과 작업 계획 정리 03. run 계획에 따른 코드 구현 04. sync 결과 검증과 문서 정리 공식 문서: MoAI-ADK 워크플로우 명령어 1. 학교 프로젝트에 비유하면 이해하기 쉽습니다 친구들과 함께 숙제 관리 웹사이트를 만든다고 생각해 보겠습니다. 학생들이 숙제를 등록하고, 완료한 항목을 표시하고, 남은 숙제를 확인할 수 있는 프로그램입니다. AI에게 "숙제 관리 웹사이트를 만들어 줘"라고 요청하면 곧바로 코드를 작성할 수도 있습니다. 하지만 필요한 기능이 빠지거나, 기존 프로그램의 구조와 맞지 않는 코드가 만들어질 수 있습니다. 나중에 이런 문제를 발견하면 코드를 다시 수정해야 하므로 작업이 더 복잡해집니다. MoAI-ADK의 워크플로우는 작업을 몇 단계로 나누어 진행합니다. 먼저 현재 프로그램을 살펴보고, 무엇을 만들지 정리한 뒤, 계획에 따라 구현하고 결과를 확인하는 방식입니다. ...

Aside 브라우저를 Claude Code에 MCP로 연결하기: Windows 설치 및 설정 가이드

Aside 브라우저를 Claude Code에 MCP로 연결하기: Windows 설치 및 설정 가이드 웹 개발을 하다 보면 코드를 작성하는 것만으로는 부족할 때가 있습니다. 실제 브라우저에서 페이지를 열어 보고, 화면이 제대로 표시되는지 확인하고, 웹 애플리케이션의 동작까지 살펴봐야 하죠. Claude Code에서 이런 브라우저 작업을 활용하고 싶다면 Aside와 MCP를 연결하는 방법을 살펴볼 만합니다. 설정 과정은 복잡하지 않습니다. 다만 Aside에서 CLI를 설치하는 것과 Claude Code에 MCP 서버를 등록하는 것은 별개의 작업이므로 순서대로 진행해야 합니다. 이 글에서 다루는 내용 Aside 브라우저와 CLI 설치 Claude Code용 Skill 설정 Aside MCP 서버 활성화 Windows 경로를 사용한 MCP 설정 연결 상태 확인 및 문제 해결 작성 기준일: 2026년 10월 28일 대상 환경: Windows 11, Aside 브라우저, Claude Code CLI 참고: 아래 절차는 제공된 설정 내용을 바탕으로 정리했습니다. 실제 PC에서 설치하거나 연결 테스트를 진행한 결과는 아닙니다. 1. 먼저 준비할 것 시작하기 전에 Aside 브라우저와 Claude Code를 준비합니다. Claude Code는 터미널에서 claude 명령을 실행할 수 있는 상태여야 합니다. Aside 브라우저: 설치 후 실행할 수 있어야 합니다. Aside CLI: 브라우저의 Developers 화면에서 설치합니다. Claude Code CLI: 터미널에서 실행할 수 있도록 설치와 초기 설정을 마칩니다. 2. Aside 브라우저 설치 먼저 Aside 공식 홈페이지 에서 브라우저를 설치한 뒤 실행합니다. 이후 CLI 설치와 MCP 설정은 Aside 앱 안에서 진행합니다. 브라우저를 설치했다고 해서 Claude Code와 자동으로 연결되는 것은 아니므로 다음 단계를 이어서 진행해야 합니...