내 Claude Code 워크플로우

Daniel Bergholz 구독자 14,400명

요약

이 영상에서는 Claude Code를 활용한 전체 AI 기반 소프트웨어 개발 워크플로우를 소개합니다. 과거 Windsurf와 Gemini를 사용하다가 Claude Code로 전환한 후에는 마치 에이전트와 협업하듯 기획과 구현 단계를 빠르게 반복할 수 있게 되었습니다. 워크플로우는 크게 기능 기획과 기술 구현 두 단계로 나뉘며, GitHub CLI와 커스텀 slash 커맨드를 활용해 이슈 생성부터 커밋·종료까지 자동화합니다. 복잡한 프로젝트에서도 단순함을 유지하기 위한 철학과 향후 개선 방향도 공유합니다.

주요 키워드

Claude Code AI 워크플로우 slash 커맨드 GH CLI GitHub Issues VS Code 커밋 자동화 MVP GitHub Projects

하이라이트

🔑 Claude Code 전환 후 기획·구현 사이클이 5~10분 내에 반복될 정도로 속도가 빨라졌습니다.
⚡️ VS Code는 단순 파일 뷰어로만 사용하고, AI 기능은 모두 Claude Code에 맡깁니다.
📌 AI가 거의 환각(hallucination) 없이 정확히 동작해 중간 확인 없이도 작업을 이어갈 수 있습니다.
🔧 워크플로우를 ‘기획(planning)’과 ‘구현(implementing)’ 두 단계로 나누어 불필요한 충돌을 줄입니다.
🚀 커스텀 slash 커맨드를 만들어 GitHub 이슈 기획부터 자동 생성·레이블링까지 원스톱으로 처리합니다.
🛠 ‘implement issue’ 커맨드를 통해 이슈 URL만 입력하면 코드 작성·커밋·이슈 종료를 일괄 수행합니다.
🎯 GitHub CLI(GH CLI)를 활용해 별도 프로젝트 보드 없이도 간편하게 이슈 트래킹이 가능합니다.
🌱 프로젝트 복잡도가 올라가면 더 정교한 워크플로우를 도입할 수 있지만, 초기에는 단순함을 유지하는 것이 핵심입니다.

용어 설명

Claude Code

Anthropic에서 제공하는 AI 코딩 에이전트로, 코드 생성·수정·커밋을 자동화합니다.

VS Code

마이크로소프트의 경량 에디터로, Claude Code가 변경한 파일을 시각적으로 확인하는 용도로 사용합니다.

GH CLI

GitHub에서 공식 지원하는 명령줄 인터페이스로, 이슈 생성·레이블링·닫기 등을 터미널에서 수행합니다.

slash 커맨드

Claude Code 내에 직접 정의한 명령어로, '/init' 등 기본 명령 외에 사용자가 원하는 워크플로우를 자동화할 수 있습니다.

GitHub Issues

GitHub 저장소 기반 이슈 트래킹 시스템으로, 개발할 기능을 기록하고 상태를 관리합니다.

MVP

Minimum Viable Product(최소 기능 제품)로, 필수 기능만 구현해 빠르게 출시하는 개발 전략입니다.

GitHub Projects

GitHub 저장소에 내장된 칸반 보드로, 이슈를 To Do→In Progress→Done 형태로 시각화해 관리합니다.

AI 워크플로우 전반과 사용 도구를 안내합니다. 과거에는 Windsurf, Gemini 커스텀 모델을 사용했으나, 이후 Claude Code를 도입해 개발 속도가 크게 향상된 배경을 설명합니다.

[00:00] AI 워크플로우 전체 소개와 사용 도구들에 대한 설명을 시작합니다. 차세대 소프트웨어 개발에서 AI를 어떻게 활용하고 어떤 도구를 사용하는지 전반적인 내용을 다룹니다.

라이브 스트림 경험 이후 Claude Code를 사용하면서 마치 에이전트와 대화하듯 기획·구현을 지시하고 결과를 바로 확인할 수 있게 된 과정을 소개합니다.

[00:15] Claude Code를 사용하게 된 계기와 이전 도구들과의 차이점을 설명합니다. Windsurf와 Gemini 커스텀 모델을 사용했던 경험과 Claude Code로 전환한 후의 변화를 상세히 비교합니다.

[00:45] Claude Code의 핵심 장점들을 구체적으로 설명합니다. 에이전트와 함께 일하는 느낌, 끝없는 주고받기 없이 효율적인 작업 가능, 환각 현상 거의 없음 등의 실제 경험을 바탕으로 한 평가를 제시합니다.

[01:24] VS Code를 IDE로 선택한 이유와 AI 기능에 대한 관점을 설명합니다. Copilot보다 Claude Code를 선택한 이유와 VS Code를 단순한 파일 시각화 도구로 활용하는 접근 방식을 상세히 설명합니다.

Copilot 대신 Claude Code를 AI 엔진으로 선택하고, VS Code를 단순 파일 뷰어로만 사용하는 이유를 설명합니다. 별도 IDE 비용 지출 없이 효율적으로 파일 변경 사항을 확인하는 방법을 공유합니다.

[02:23] 비용 효율성과 도구 선택 철학을 설명합니다. 비싼 래퍼 대신 무료 IDE를 사용하는 논리와 Windsurf를 버리고 베어본 VS Code와 Claude Code 조합을 선택한 배경을 제시합니다.

[02:39] 실제 워크플로우의 핵심 구조를 소개합니다. 계획 단계와 구현 단계로 나누어 작업하는 방식과 AI의 빠른 코드 생성 속도에 맞춰 계획에 더 많은 시간을 투자하는 접근법을 설명합니다.

개발을 ‘기획(planning)’과 ‘구현(implementing)’ 두 단계로 명확히 나누어 진행하는 방식을 설명합니다. AI가 코드 생성을 빠르게 수행하므로, 사전 기획에 더 많은 시간을 투자해야 하는 이유를 강조합니다.

[03:16] 급하게 기능을 구현할 때 발생하는 문제점들을 구체적인 예시로 설명합니다. 불안감으로 인한 성급한 구현, 기능 간 충돌 발생, 결국 제거와 재작업의 반복이라는 악순환에 대한 실제 경험을 공유합니다.

[03:43] 개발자가 기능을 구현할 때 계획 없이 시작하면 원하는 것을 위해 계속 수정하며 많은 시간을 낭비하게 됩니다. 따라서 기능을 미리 계획하는 시간을 갖는 것이 중요합니다.

[03:53] 기능 계획을 위해 Claude Code에서 커스텀 슬래시 명령을 만들어 사용하고 있습니다. Claude Code는 /clear, /init 같은 기본 명령 외에도 사용자가 직접 커스텀 명령을 만들 수 있습니다.

Claude Code의 기본 slash 명령 외에 사용자가 직접 명령어를 추가하는 방법을 다룹니다. 예시로 기능 기획 모드를 실행하는 커맨드를 작성해 .cloud/commands 폴더에 배치하는 과정을 설명합니다.

[04:19] .cloud/commands 폴더에 두 개의 커스텀 명령을 만들었습니다. 첫 번째는 이슈 계획 명령으로, GitHub 이슈 계획 모드로 들어가서 아이디어를 브레인스토밍하고 준비가 되면 GH CLI를 사용해 이슈를 생성합니다.

[04:57] Linear, Jira, Trello 같은 다른 티켓 추적 도구 대신 GitHub 이슈를 사용하는 이유는 게으르고 Linear MCP를 설치하기 싫기 때문입니다. GH CLI는 어떤 프로젝트에서든 바로 사용할 수 있어서 편리합니다.

[05:18] 이슈에 라벨과 마일스톤을 추가하는 것도 좋아합니다. 예를 들어 라이트/다크 모드 테마 전환기 이슈에는 enhancement, JavaScript 라벨과 priority low, post MVP 마일스톤을 설정했습니다.

[05:54] 두 번째 커스텀 명령은 implement issue로, 이슈 URL을 붙여넣으면 GitHub 이슈 구현 모드로 들어가서 구현을 도와주고 완료 후 커밋을 생성하고 이슈를 닫도록 합니다.

두 번째 custom slash 커맨드인 'implement issue'를 통해 이슈 URL을 입력하면 자동으로 코드 작성·커밋·이슈 종료까지 수행하는 방법을 소개합니다. CLI로 전 과정이 원스톱 처리됩니다.

[06:18] 티켓 추적을 위해 GitHub 프로젝트의 칸반 뷰를 사용할 수도 있지만, 할 일/진행 중/완료 같은 컬럼이 정말 필요한지 의문입니다. 이슈를 만들고 해결됨으로 표시하는 것만으로도 충분히 간단하지 않을까요?

칸반 보드 형태의 GitHub Projects 사용 여부를 검토합니다. 초기에는 불필요한 칼럼 없이 GitHub Issues만으로 충분하다 판단해 단순하게 이슈를 생성·해결하는 방식을 유지한다고 설명합니다.

[07:02] 현재는 GitHub 프로젝트를 사용하지 않고 있으며, 미래에 더 많은 기능을 추적해야 한다면 사용할 수도 있습니다. 처음부터 일을 과도하게 복잡하게 만드는 것은 좋아하지 않습니다.

[07:16] Windsurf 사용을 중단하고 이제 Claude Code와 VS Code를 사용합니다. 보통 하루나 이틀은 기술적인 것 없이 기능에 대해서만 Claude와 공동 창업자로서 이야기하고, 그 후에는 기술 리더나 엔지니어링 매니저처럼 대화합니다.

현재 워크플로우 요약과 함께, 프로젝트가 복잡해지면 더 진화된 체계를 도입할 수 있음을 예고합니다. 미공개 프로젝트에 대한 간단한 스포일러와 다음 영상 예고로 마무리합니다.

타임라인 정보가 없습니다.

[00:00] 여러분, 오늘 제가 AI를 활용하는 전체 워크플로우를 설명해드리겠습니다.

[00:05] 차세대 소프트웨어 개발에서 AI를 어떻게 활용하고 어떤 도구를 사용하는지 말이죠.

[00:08] 우선 제가 사용하는 도구들부터 소개해드리겠습니다.

[00:12] 어떤 도구를 사용하고 있을까요?

[00:15] 저는 Claude Code를 사용하고 있습니다.

[00:19] Elixir Mentor 채널에서 Andrew와 Jacob과 함께 한 라이브 스트림 이후로

[00:23] 제 인생이 바뀌었습니다.

[00:26] 이전에는 Windsurf를 사용했었고

[00:30] Windsurf의 Gemini 커스텀 모델을 시도해보고 있었습니다.

[00:35] 그 워크플로우에도 어느 정도 만족하고 있었죠.

[00:39] 하지만 Claude Code를 시도해본 후

[00:42] 제 인생이 변했습니다.

[00:45] 처음으로 정말 에이전트와 함께 일하는 느낌이 들었습니다.

[00:48] 더 이상 끝없이 주고받을 필요가 없어졌죠.

[00:52] Claude와 대화하는 것 같습니다.

[00:55] 계획을 세우고 나면 Claude에게 말하죠.

[00:58] "이제 구현해줘"

[01:00] 그리고 10분 후, 5분 후에

[01:03] 결과를 확인하고 다음으로 넘어갑니다.

[01:06] Claude가 작업하는 동안에는

[01:08] 중간에 멈추지 않습니다.

[01:11] 보통 올바른 방향으로 진행하기 때문이죠.

[01:14] 환각 현상도 거의 없습니다.

[01:16] 그래서 Claude Code로 완전히 전환했습니다.

[01:21] 그럼 IDE는 어떨까요?

[01:24] 저는 VS Code를 사용하고 있습니다.

[01:26] VS Code는 AI 기능이 별로 아닌가요?

[01:30] 어떤 면에서는 그렇죠.

[01:33] AI 기능 면에서 Copilot은

[01:36] Cursor나 Windsurf에 비해 많이 부족합니다.

[01:39] 하지만 저는 Copilot을 사용하지 않아요.

[01:41] Claude Code를 사용합니다. Claude Code가 제 모델이자

[01:45] 모델과 상호작용하는 도구입니다.

[01:48] 제가 VS Code를 사용하는 유일한 이유는

[01:51] Claude가 변경한 파일들을 미리 보기 위해서입니다.

[01:54] 말 그대로 그게 전부예요.

[01:58] 만약 Anthropic이 더 나은 방법을 찾아서

[02:01] 커밋하기 전에 모든 파일 변경사항을 미리 볼 수 있다면

[02:04] IDE를 완전히 사용하지 않아도 될 것 같습니다.

[02:07] 터미널 탭 5개만 열어두고

[02:09] 모든 작업을 거기서 할 수 있을 것 같아요.

[02:12] 제 IDE는 단순한 파일 시각화 도구이기 때문입니다.

[02:16] 래퍼를 사용하는 대신 VS Code 같은 무료 IDE를 사용하는 이유는 뭘까요?

[02:19] 그게 제 논리입니다.

[02:23] 비싼 래퍼에 돈을 쓰고 싶지 않아요.

[02:26] 거기서 AI 기능을 사용하지 않는다면요.

[02:29] 그래서 Windsurf를 버렸습니다.

[02:32] Claude Code와 함께 베어본 VS Code를 사용하고 있습니다.

[02:35] 그럼 제 워크플로우는 어떨까요?

[02:39] Claude Code로 어떻게 코딩하는지 말이죠.

[02:42] 이미 관련 영상을 몇 개 만들었습니다.

[02:44] 예를 들어

[02:46] 제가 생각하는 완벽한 Claude MD 파일을 만드는 방법에 대한 영상이 있습니다.

[02:48] 어딘가에 링크를 걸어두겠습니다.

[02:52] 하지만 워크플로우 관점에서

[02:54] 어떻게 시작하고 어떻게 끝내는지

[02:56] 저는 두 단계로 나누어 작업합니다.

[02:59] 첫 번째 단계는 계획이고

[03:02] 두 번째 단계는 그 계획의 기술적 구현입니다.

[03:04] AI가 코드를 생성하는 속도가 너무 빠르다는 걸 깨달았습니다.

[03:07] 이제 코딩보다 기능 계획에 더 많은 시간을 투자하는 게 합리적이에요.

[03:11] 가끔 약간의 불안감이 들면

[03:16] "이 기능을 구현해보자"라고 생각하죠.

[03:18] 그런데 30초 만에 끝나버리고

[03:20] "와, 대단하네! 이것도 구현해보자"라고 하고

[03:22] "다른 기능도 구현해보자"라고 하죠.

[03:25] 그리고 하루가 끝나면

[03:27] 처음 만든 기능이 두 번째 기능과 충돌하는 걸 발견합니다.

[03:29] 그래서 이 기능을 제거하고

[03:31] 저 기능도 제거하고

[03:33] 다시 처음부터 시작하는 상황이 벌어집니다.

[03:36] 그래서 저는 이제

[03:38] 기능을 제거하고 다시 만들고

[03:41] 계속 반복하게 됩니다.

[03:43] 그러면 원하는 것을 위해 앞뒤로

[03:45] 오가며 많은 시간을 소비하게 됩니다. 그러니

[03:50] 기능을 계획하는 시간을 가져보세요. 그럼

[03:53] 어떻게 기능을 계획할까요? 저는 Claude Code에서

[03:56] 커스텀 슬래시 명령을 만들었습니다. 만약

[03:59] 모르신다면, Claude Code에는 몇 가지

[04:02] 기본 명령들이 있습니다. 현재 세션을 지우는 /clear나

[04:06] claude.md 파일을 생성하는 /init 같은 것들이요.

[04:09] 하지만 자신만의 슬래시 명령을 만들 수 있습니다.

[04:12] 그리고 이것이 작동하려면

[04:15] 프롬프트를 작성하고 그것을

[04:17] cloud commands 폴더에 넣어야 합니다.

[04:19] 예를 들어, .cloud/commands 안에 두 개의

[04:24] 커스텀 명령이 있습니다. 첫 번째는 이슈를

[04:28] 계획하는 것입니다. 저는 'GitHub 이슈

[04:30] 계획 모드에 들어가 몇 가지 아이디어를

[04:33] 브레인스토밍해보자'라고 하고

[04:36] 좋은 지점에 도달했다고 느끼면

[04:40] '이제 작업을 시작할 준비가 되었다'라고 하고

[04:43] 그럼 Claude에게 GH CLI를 사용해서

[04:46] 이슈를 만들어달라고 요청합니다.

[04:50] 맞습니다, GH입니다. 저는 GitHub 이슈를

[04:53] 사용하고 있습니다. Linear를 사용하지 않고

[04:57] Jira, Trello 또는 다른 티켓 추적 소프트웨어도

[05:01] 사용하지 않습니다. 왜냐하면

[05:03] 솔직히 말하면, 저는 너무 게으르고

[05:06] Linear MCP를 설치하고 싶지 않습니다. 저는

[05:09] GH CLI를 사용할 수 있습니다. 어떤 프로젝트에서든

[05:11] 바로 사용할 수 있습니다. MCP가 필요하지 않습니다.

[05:14] 그래서 훌륭합니다. 그리고 선택적으로

[05:18] 이슈에 라벨과 마일스톤을 추가하는 것도

[05:22] 좋아합니다. 이 이슈를 예로 들어보겠습니다.

[05:24] 애플리케이션에 라이트 및 다크 모드 테마

[05:26] 전환기를 추가하는 것입니다.

[05:29] enhancement, JavaScript 라벨을 사용하고

[05:31] 있는 것을 볼 수 있습니다. 그리고 우선순위에 대한

[05:33] 라벨도 만들었는데, 이것은 priority low입니다.

[05:36] 그리고 여기에 몇 가지 마일스톤도 있습니다.

[05:39] 기본값은 MVP launch이지만

[05:41] post MVP도 있습니다. 이것이 라이트 및

[05:44] 다크 테마 전환기의 경우입니다.

[05:47] 이것은 MVP에서 필수가 아닙니다.

[05:49] 그리고 이슈가 완료되고 이미

[05:51] 많은 이슈들이 생성되면

[05:54] 두 번째 커스텀 명령인

[05:57] implement issue를 만들었습니다.

[06:00] 이 명령을 실행하고 이슈의 URL을

[06:02] 붙여넣으면 'GitHub 이슈 구현 모드에

[06:06] 들어가서 이슈 구현을 도와드리겠습니다'라고

[06:09] 나옵니다. 그리고 완료된 후

[06:13] 커밋을 생성하고 이슈를 닫도록 요청합니다.

[06:16] 그래서 그것이 제 현재 워크플로우입니다.

[06:18] 티켓 추적을 위해 GitHub 프로젝트를

[06:22] 사용할 수도 있습니다. 예를 들어

[06:25] tech school에서 저는 프로젝트를 사용하고

[06:29] 프로젝트에서 칸반 뷰를 사용해서

[06:32] 백로그에 있는 것들을 추적할 수 있습니다.

[06:35] 준비됨, 진행 중, 완료 상태로 나누어

[06:38] 이동시킬 수 있습니다. 하지만 솔직히

[06:41] 저는 생각했습니다. '정말 할 일, 진행 중,

[06:43] 완료 컬럼이 필요할까? 정말로

[06:45] 필요할까? 이슈를 만들고 해결됨으로

[06:48] 표시하면 안 될까? 이게 충분히

[06:52] 간단해 보이지 않을까?' 그래서

[06:55] 이 비디오를 녹화하는 시점에서

[06:58] 저는 프로젝트를 사용하지 않고 있습니다.

[07:02] 미래에 더 많은 기능을 추적해야 한다면

[07:04] 사용할 수도 있지만 지금은

[07:06] GitHub 이슈만으로도 충분하다고 생각합니다.

[07:10] 저는 처음부터 일을 과도하게

[07:12] 복잡하게 만드는 것을 좋아하지 않습니다.

[07:16] 좋습니다. 그래서 이것이 제 워크플로우입니다.

[07:18] 저는 Windsurf 사용을 중단했습니다.

[07:20] 이제 Claude Code와 VS Code를 사용합니다.

[07:23] 보통 하루나 이틀 정도 오랜 시간을 기술적인

[07:26] 것은 없이 기능에 대해서만 이야기하는 데

[07:29] 소비합니다. 저는 Claude와 프로그래머가 아닌

[07:34] 공동 창업자로서 직접 이야기합니다.

[07:37] 그리고 둘째, 셋째 날에는

[07:40] Claude와 기술 리더, 엔지니어링 매니저처럼

[07:43] 이야기하기 시작합니다. 그리고 지금부터

[07:46] 제 워크플로우는 꽤 간단하다고 생각합니다.

[07:49] 이 프로젝트가 더 복잡해지면

[07:51] 미래에 이 워크플로우를 어떻게

[07:53] 개선했는지 설명하는 다른 비디오를

[07:56] 녹화할 수도 있습니다. 하지만 그게 전부입니다.

[07:59] 그리고 아니요, 이 프로젝트는 아직

[08:02] 발표되지 않았습니다. 미래에

[08:05] 더 자세히 이야기하겠습니다. 스포일러 경고입니다.

[08:09] 여러분이 이 비디오를 즐겨보셨기를 바랍니다.

[08:12] 다음에 만나요.

[08:14]