Claude Code가 최고의 AI 코딩 에이전트인 이유 [튜토리얼]

Ras Mic 구독자 52,600명

요약

이 영상에서는 Anthropic의 Cloud Code(클로드 코드)를 활용해 빠르게 코드베이스를 이해하고, 버그를 수정하며 Git 워크플로우까지 자동화하는 방법을 보여준다. Cloud Code는 IDE에 상관없이 실행할 수 있고, 현재 작업 중인 파일의 컨텍스트를 인식해 코드 설명부터 수정 제안까지 즉시 제공한다. 특히 대규모 프로젝트나 처음 접하는 코드 베이스에서 온보딩 시간을 크게 단축시키며, 에이전트 기반 개발의 가능성을 확인시켜 준다.

주요 키워드

Cloud Code Agentic Coding IDE Pull Request 토큰 온보딩 API Git 자동화 디버깅 Anthropic

하이라이트

🔑 Cloud Code는 IDE 종류와 무관하게 사용할 수 있어 개발 환경 제약 없이 즉시 도입할 수 있다.
⚡️ 파일 단위 컨텍스트 인식을 지원해 `@파일명`만 입력하면 해당 코드가 어떤 역할을 하는지 바로 설명해 준다.
🌟 대규모 또는 초기 미숙지 코드베이스에서 온보딩 시간을 획기적으로 줄여주며 팀 단위 협업에도 큰 도움이 된다.
🚀 실제 버그 수정 예시: 삭제 버튼이 나타나지 않는 Apple Pass 앱에서 클라이언트·서버 권한 체크를 스마트하게 조합해 버튼 표시 로직을 개선했다.
📌 토큰 사용량과 수정 이력, PR 생성까지 한 번에 처리해 Git 커밋·푸시 과정을 에이전트가 자동화한다.
✨ Agentic Coding(에이전트 기반 코드 작성) 흐름을 실시간으로 체험하며, 반복 작업·테스트 작성 등 다양한 업무를 자동화할 수 있다.
💡 구독 플랜 외에도 Pay-as-you-go 형태 API 사용을 지원해 필요에 따라 유연하게 비용을 관리할 수 있다.

용어 설명

Cloud Code

Anthropic에서 제공하는 AI 코딩 에이전트 툴로, 코드 설명·수정·커밋까지 지원한다.

IDE

통합 개발 환경(Integrated Development Environment)의 약자로, 코드 작성·디버깅을 위한 소프트웨어 도구다.

토큰

AI 모델이 텍스트를 처리할 때 사용하는 단위로, 입력·출력 비용을 산정하는 기준이다.

Pull Request(PR)

코드 변경 내역을 버전 관리 시스템에 리뷰 요청하는 작업 흐름이다.

Agentic Coding

AI 에이전트를 활용해 코드 작성, 수정, 테스트, 커밋까지 자동으로 수행하는 방식이다.

Cloud Code 발표 현장 경험을 공유하며, 출시 이후 매일 사용해온 이유를 설명한다. Anthropic 콘퍼런스 실시간 체험부터 현재 프로그래밍 에이전트 시장에서의 위치까지 간략히 소개한다.

[00:00] Claude Code를 최고의 프로그래밍 에이전트로 소개하며, 출시 이후 매일 사용하고 있다고 설명합니다. 컨퍼런스에서 라이브 발표를 직접 보았고, 시작하는 방법과 사용법을 튜토리얼로 제공하겠다고 말합니다.

[00:20] Claude Code가 사물을 보고 생각하는 방식과 도구 사용법을 완전히 바꿔놓았다고 설명합니다. 시작하는 방법은 간단하며, npm install -g @anthropic-ai/claude-code 명령어만 실행하면 됩니다.

`npm install -g @anthropic-ai/cloudcode` 명령 한 줄로 글로벌 설치 후, 프로젝트 디렉터리에서 `claude`를 입력해 바로 실행할 수 있는 과정을 안내한다. IDE와 무관하게 작동한다는 점을 강조한다.

[00:36] Claude Code는 VS Code, JetBrains, Cursor, Windsurf, Zed 등 모든 IDE와 호환됩니다. Zed에서는 일부 기능 문제가 있지만 곧 해결될 것으로 예상됩니다. 사용법은 프로젝트 디렉토리에서 claude 명령어를 입력하는 것입니다.

현재 편집 중인 파일을 자동으로 인식해 `tell me what this page is doing` 같은 명령만으로 코드 역할을 즉시 설명하는 방법을 실습한다. `@middleware`처럼 특정 파일 태그 입력 기능도 소개한다.

[00:58] 가격은 구독형과 API 사용량 기반 두 가지 방식이 있습니다. 예전에는 최대 플랜만 있었지만 이제 월 17달러 플랜에도 Claude Code가 포함되어 있어 접근성이 좋아졌습니다.

[01:16] 실제 프로젝트에서 Claude Code 사용법을 시연합니다. 터미널에서 claude를 입력하면 인터페이스가 나타나며, 현재 작업 중인 페이지의 컨텍스트를 자동으로 파악합니다.

[01:30] page.tsx에 있을 때 Claude Code가 이를 인식하고, '이 페이지가 무엇을 하는지 알려주세요'라고 질문하면 해당 페이지의 코드를 분석하여 상세한 설명을 제공합니다.

[01:48] 홈 랜딩 페이지 컴포넌트에 대한 상세한 분석 결과를 보여줍니다. Lock Screen AI 타이틀, 히어로 섹션, Apple Pass 생성 기능, 대시보드 링크 버튼 등의 구성 요소를 정확히 파악했습니다.

[02:05] 다른 IDE처럼 @를 사용하여 특정 파일을 지정할 수 있습니다. @middleware처럼 특정 파일을 태그하여 해당 파일의 기능에 대해 질문하면 인증 보호, 초대 플로우, 공개 경로 등을 설명해줍니다.

[02:28] Claude Code의 진정한 장점은 대규모 코드베이스나 익숙하지 않은 기존 코드베이스에서 발휘됩니다. 새로운 코드베이스 온보딩 속도가 극적으로 향상되었으며, 간단한 질문만으로도 플로우와 컴포넌트 작동 방식을 쉽게 이해할 수 있습니다.

익숙하지 않은 거대한 프로젝트에서 Cloud Code를 활용해 빠르게 구조와 흐름을 파악하는 사례를 언급한다. 기업 내 팀, 프리랜서, 신규 입사자 온보딩 효율성을 중점으로 설명한다.

[02:47] Claude Code가 코드베이스 온보딩을 빠르게 도와주며, 특히 계약직이나 프리랜서, 새로운 회사 입사자들에게 유용하다고 설명합니다.

관리자 권한이 있는 경우에만 삭제 버튼을 보여주려 했으나 클라이언트 쪽에서 제대로 동작하지 않는 버그를 Cloud Code가 UI와 서버 사이드 로직을 함께 분석해 해결하는 과정을 단계별로 시연한다.

[03:01] 실제 버그 수정 데모를 시작하며, Apple Pass 삭제 기능이 작동하지 않는 문제를 Claude Code로 해결하는 과정을 보여줍니다.

[03:11] dashboard/page.tsx 파일에서 관리자가 패스를 삭제할 수 있어야 하는데 삭제 버튼이 보이지 않는 문제를 Claude Code에 설명합니다.

[04:03] 잠시 찬양의 시간을 가지며 예수님에 대한 신앙을 표현하는 개인적인 순간을 보여줍니다.

[04:37] Claude Code가 진정한 에이전트로서 작업을 반복하며, 서버 사이드 권한 확인을 통해 클라이언트 사이드 관리자 확인을 제거하는 솔루션을 제안합니다.

수정된 코드를 빌드하고, `git add`·`git commit`·`git push`까지 Cloud Code가 자동으로 수행한다. PR 생성과 코드 설명까지 한 번에 처리해 전체 워크플로우를 매끄럽게 완성하는 방법을 보여준다.

[04:55] Claude Code가 편집 권한을 요청하고 사용자가 승인하는 과정을 보여주며, 토큰 사용량도 추적할 수 있음을 설명합니다.

[05:18] 버그가 성공적으로 수정되어 삭제 버튼이 나타나고 패스를 삭제할 수 있게 되었으며, UI가 실제 권한에 따라 스마트하게 작동하도록 개선되었음을 확인합니다.

[05:49] 클라우드 코드가 깊은 사고를 장려하도록 설정했더니 실제로 작동하기 시작하고, diff 뷰를 통해 작성된 코드와 구현된 작업을 확인할 수 있었습니다.

[06:04] 자동으로 실행하도록 설정하여 실제로 기능이 제대로 구축되는지 테스트해보기로 했습니다.

[06:37] 클라우드 코드가 작업을 완료하고 빌드 실행, 변경사항 커밋, 푸시까지 자동으로 처리하여 적절한 설명과 함께 PR을 생성했습니다.

[07:11] 코드래빗으로 코드 리뷰도 가능하며, 현재는 다양한 분야의 워크플로우에서 에이전트를 활용하는 시대에 살고 있어 클라우드 코드와 즐거운 경험을 하고 있습니다.

테스트 작성, Git 작업 자동화 등 추가 업무를 Cloud Code에 명시적으로 요청해 에이전시 강화를 권장한다. 기존 툴 구독을 중단하고 Cloud Code로 전환한 소감을 전하며, 시청자에게 직접 사용 후기를 부탁하며 마무리한다.

[07:26] Anthropic에서 제안하는 다른 작업들로는 테스트 작성이 있는데, 아무도 테스트 작성을 좋아하지 않지만 클라우드 코드를 활용하면 좋을 것 같습니다.

[07:42] 복잡한 문제에 대해 클로드에게 더 깊이 생각해달라고 명시적으로 요청하는 것이 중요하며, 이것이 진정한 에이전틱 코딩의 첫 경험이었습니다.

[07:50] 클라우드 코드가 가장 좋아하는 프로그래밍 에이전트가 되어 다른 구독들을 취소하고 순전히 클라우드 코드만 사용하고 있으며, Zed와 함께 API 키를 활용하고 있습니다.

[00:00] Claude Code는 제 개인적인 견해로는 최고의 프로그래밍 에이전트입니다.

[00:02] 출시된 이후로 계속 사용하고 있어요.

[00:03] 실제로 Claude Code 컨퍼런스에 참석했었는데

[00:05] 발표를 보게 되었습니다.

[00:07] 라이브로 발표를 보았고

[00:10] 그 이후로 매일 사용하고 있습니다.

[00:11] 그래서 여러분께

[00:13] 시작하는 방법, 사용법, 그리고

[00:15] 현재 프로그래밍 에이전트 세계에 대한

[00:17] 제 생각을 간단하고 빠르게 튜토리얼로 알려드리고 싶습니다.

[00:20] Claude Code는 정말로

[00:22] 제가 사물을 보고 생각하는 방식과

[00:24] 이러한 도구들을 사용하는 방식까지 바꿔놓았습니다.

[00:26] 시작하는 방법은 꽤 간단합니다.

[00:28] 정말로 해야 할 일은

[00:30] npm install -g 명령어를 실행하는 것뿐입니다.

[00:34] @anthropic-ai/claude-code를 실행하면 됩니다.

[00:36] 여기서 중요한 점은

[00:38] Claude Code는 모든 IDE와 함께 사용할 수 있다는 것입니다.

[00:41] VS Code, JetBrains, Cursor, Windsurf, Zed 등

[00:44] 모든 것과 호환됩니다.

[00:46] 다만 Zed의 경우 일부 기능이

[00:48] 제대로 작동하지 않는 것을 발견했지만

[00:49] 이 영상이 올라갈 때쯤에는

[00:51] 수정될 것이라고 확신합니다.

[00:53] 사용법은 정말 간단합니다.

[00:55] 프로젝트 디렉토리로 cd하고

[00:58] claude 명령어를 입력하기만 하면 됩니다.

[01:00] 가격 측면에서는 구독할 수 있습니다.

[01:02] 예전에는 최대 플랜만 있었지만

[01:04] 이제 월 17달러 플랜에도 Claude Code가 추가되었습니다.

[01:06] 또한 API를 사용량에 따라

[01:08] 지불하는 방식으로도 사용할 수 있습니다.

[01:10] 어떤 방식이든 본인에게 맞는 것을 선택하시면 되지만

[01:12] 월 17달러는 쉽게 접근할 수 있는

[01:15] 훌륭한 가격대라고 생각합니다.

[01:16] 이제 프로젝트에 들어가서

[01:18] 제가 Claude Code를 어떻게 사용하는지 보여드리겠습니다.

[01:21] 새 터미널을 열고 claude를 입력하면

[01:23] 이 인터페이스가 나타납니다.

[01:26] Claude Code의 흥미로운 점은

[01:28] 현재 어떤 페이지에 있는지 컨텍스트를 가지고 있다는 것입니다.

[01:30] 지금 저는 page.tsx에 있고

[01:33] Claude Code도 제가 page.tsx에 있다는 것을 알고 있습니다.

[01:36] 그래서 '이 페이지가 무엇을 하는지 알려주세요'라고 물어보면

[01:41] 제가 어떤 페이지에 있는지 알고 있기 때문에

[01:43] 정보를 추출할 것입니다.

[01:44] 이 페이지의 코드를 살펴보고

[01:46] 정확히 무엇이 일어나고 있는지 알려줄 것입니다.

[01:48] 이것은 홈 랜딩 페이지 컴포넌트라고 답합니다.

[01:50] 제목이 Lock Screen AI인 중앙 정렬된 히어로 섹션을 표시하고

[01:51] 설명 텍스트와 커뮤니티를 위한 Apple Pass 생성

[01:54] 기능을 포함합니다.

[01:56] 대시보드와 대시보드/생성으로 연결되는 두 개의 액션 버튼

[01:58] 그리고 히어로 이미지가 있습니다.

[02:01] 이 페이지는 메인 진입점 역할을 합니다.

[02:03] 이제 이해가 되시죠.

[02:05] 흥미로운 점은 Cursor나 Windsurf 같은

[02:08] 다른 IDE와 마찬가지로 @를 입력하여

[02:10] 특정 파일을 지정할 수 있다는 것입니다.

[02:14] 예를 들어, @middleware를 입력하고

[02:16] 이 파일이 무엇을 하는지 설명해달라고 할 수 있습니다.

[02:19] 특정 파일로 이동해서 질문할 수 있고

[02:23] 특정 파일들을 태그하여 질문할 수도 있습니다.

[02:25] 그러면 인증 보호, 초대 플로우,

[02:27] 공개 경로, 그리고 경로 매칭에 대해 알려줍니다.

[02:28] 그럼 Claude Code는 어디서 빛을 발할까요?

[02:30] Claude Code는 큰 코드베이스나

[02:33] 이미 존재하는 코드베이스 중에서

[02:35] 익숙하지 않은 것들에서 빛을 발합니다.

[02:36] Claude Code로 새로운 코드베이스에

[02:39] 온보딩하는 속도가 얼마나 빨라졌는지

[02:41] 말로 표현할 수 없을 정도입니다.

[02:43] 그냥 질문하기만 하면 됩니다.

[02:45] 플로우를 설명해주세요. 이 페이지는 어떻게 작동하나요? 이 컴포넌트는 어떻게 작동하나요?

[02:47] 그럼, 이 앱이 어떻게 동작하는지 알아보죠.

[02:49] 코드베이스 온보딩을 정말 빠르게 도와줍니다.

[02:51] 회사나 팀에게 유용할 것 같은데요.

[02:52] 계약직이거나 프리랜서거나

[02:55] 새로운 회사에 입사할 때라면

[02:56] 반드시 Claude Code 구독을 요청하세요.

[02:58] 저는 실제로 작업 중인 애플리케이션에 버그가 있어서

[02:59] Claude Code로 어떻게 수정하는지 보여드리겠습니다.

[03:01] 이건 Apple Pass인데

[03:03] 삭제할 수 있어야 하는데

[03:05] 어떤 이유로 삭제가 안 되네요.

[03:06] Claude Code로 가서

[03:08] 페이지를 태그하겠습니다.

[03:09] 이 경로가 무엇인지 알고 있거든요.

[03:11] 이건 /dashboard 경로에 있습니다.

[03:12] dashboard.tsx 파일로 가겠습니다.

[03:15] dashboard/page.tsx 파일이죠.

[03:17] 그래서 이렇게 말하겠습니다.

[03:18] 이 페이지에서

[03:21] 저는 관리자로서

[03:22] 패스를 삭제할 수 있어야 하는데

[03:24] 어떤 이유로

[03:26] 음, 관리자로서 패스를 삭제할 수 있어야 하는데

[03:31] 어떤 이유로 삭제 버튼이 보이지 않네요.

[03:35] 일반 사용자는 삭제할 수 없어야 하지만

[03:38] 지금 삭제 버튼이 보이지 않아요.

[03:43] 관리자가 아닌 사용자는 삭제할 수 없어야 하지만

[03:47] 관리자로서는 삭제할 수 있어야 합니다.

[03:52] 간단하고 일반적인 프롬프트로

[03:55] 원하는 기능을 설명했습니다.

[03:57] 이제 Claude Code가 작동하는 모습을 보실 수 있습니다.

[04:00] 작업하는 동안 잠시만요.

[04:03] 찬양의 시간을 가져보겠습니다.

[04:05] 한밤중에도 그분을 부를 수 있어요.

[04:08] 한밤중에도

[04:09] 아침에도 그분을 부를 수 있어요.

[04:12] 한밤중에도

[04:14] 그분을 부를 수 있어요.

[04:15] 아침에도 그분을 부를 수 있어요.

[04:18] 한밤중에도 그분을 부를 수 있어요.

[04:21] 그분을 부르면 모든 것을

[04:24] 괜찮게 만들어 주십니다.

[04:25] 어떤 상황이든 상관없이

[04:30] 예수님이 저를 돌봐주시겠다고 약속하셨어요.

[04:34] 다시 보시면, 이것이 진정한 에이전트입니다.

[04:37] 작업을 계속해서 반복합니다.

[04:40] 이제 서버 사이드 삭제 패스 함수가

[04:42] 올바르게 패스 삭제 권한을 확인하고 있다고 합니다.

[04:44] 삭제 패스 컴포넌트를 수정해서

[04:46] 클라이언트 사이드 관리자 확인을 제거하겠습니다.

[04:48] 서버 함수가 이미 권한을

[04:50] 적절히 처리하고 있기 때문입니다.

[04:52] 이 편집을 원하는지 묻고 있습니다.

[04:55] 네라고 할 수 있고

[04:57] 네, 다시 묻지 마세요라고 할 수도 있어요.

[05:00] 계속 반복하라는 뜻이죠.

[05:02] 또는 잘못된 방향으로 가고 있다고 생각하면

[05:04] 아니오라고 하고 이유를 말할 수 있어요.

[05:06] 그래서 좋아하는 거예요.

[05:08] 네를 클릭하겠습니다. 이해가 됩니다.

[05:10] 코드를 편집하고 있습니다.

[05:12] 여기서 사용된 토큰 수도 보여줍니다.

[05:14] 이제 삭제 버튼이 항상 표시되고

[05:16] 권한 확인은 서버 사이드에서 처리된다고 합니다.

[05:18] 돌아가서 확인해보면

[05:20] 네, 삭제 버튼이 보이고

[05:23] 패스를 삭제할 수 있습니다.

[05:27] 버그를 수정해 줬습니다.

[05:30] 서버 사이드 확인이 작동하지만

[05:32] 관리자가 아닌 사용자에게는

[05:34] 삭제 버튼이 보이지 않았으면 한다고 했더니

[05:35] 맞습니다라고 했어요.

[05:39] UI가 스마트해야 하고

[05:40] 실제 권한에 따라

[05:42] 삭제 버튼을 보여주거나 숨겨야 한다고 했어요.

[05:44] 적절한 솔루션을 구현해보겠습니다.

[05:46] Claude의 조언을 따랐는데

[05:49] 깊은 사고, 더 깊은 사고를 장려하죠.

[05:51] 생각해보라고 했더니

[05:53] 작동하기 시작하는 걸 볼 수 있고

[05:54] 여기서 diff 뷰를 볼 수 있는데, 이는

[05:56] 작성한 코드를 보여주는 거예요

[05:58] 그리고 구현한 작업을 볼 수 있죠.

[06:01] 모든 pass 함수를 체크리스트에 나열해서

[06:03] 현재 데이터 구조를 이해하도록 했어요.

[06:04] 이제 정말로

[06:06] 예라고 하고 이 세션에서는 묻지 말라고 할게요.

[06:09] 그냥 실행시켜서

[06:12] 실제로 작동하는지, 실제로

[06:15] 이 기능을 제대로 구축하는지 보겠어요.

[06:20] 친구들을 만드세요.

[06:22] 폰을 내려놓으세요. 폰을 내려놓으세요.

[06:25]

[06:32] [음악]

[06:37] 완료되었다고 하네요. 빌드를 실행하고 싶다고 하니

[06:40] 네, 빌드를 실행하세요라고 하겠어요.

[06:44] 괜찮아요. 빌드하게 둡시다.

[06:45] 마지막 테스트가 테스트이고

[06:48] 변경사항을 커밋하는 것이고

[06:50] 실제로 변경사항을 커밋하려고 하네요.

[06:51] 그러니까 그렇게 하게 둡시다.

[06:53] git add, git commit이고 이게

[06:57] 커밋 메시지네요. 괜찮아 보입니다.

[07:00] 그리고 이 변경사항들을 푸시하고 싶다고 하네요.

[07:02] 네, 진행하세요. 여기서 볼 수 있듯이

[07:05] 적절한 설명과 함께

[07:06] PR이 만들어졌어요. 코드를 리뷰할 수 있고

[07:09] 이 풀 리퀘스트를 빠르게 생성하겠습니다.

[07:11] 정말 멋진 건 또 다시

[07:14] 이 코드를 리뷰할 수 있는 코드래빗이 있다는 거고

[07:17] 우리는 그냥

[07:19] 어떤 분야든 워크플로우에 에이전트를 사용하는 것이

[07:21] 의미가 있는 시대에 살고 있고

[07:24] 네, 클라우드 코드와 함께

[07:25] 즐거운 시간을 보내고 있어요.

[07:26] 이제 Anthropic에서 제안하는

[07:30] 다른 일반적인 작업들이 있는데

[07:31] 예를 들어 git 작업을 자동화했고 코드를 편집했지만

[07:34] 테스트 작성, 테스트를 작성하는 걸

[07:36] 아무도 좋아하지 않지만

[07:38] 테스트를 작성해야 하는데

[07:39] 아마 이게 클라우드 코드를 사용할

[07:42] 좋은 방법일 거예요. 그리고 복잡한 문제에 대해

[07:43] 더 깊은 사고를 장려한다고 하는데

[07:46] 클로드에게 더 깊이 생각해달라고

[07:48] 명시적으로 요청하라는 거죠. 이게

[07:50] 진정한 에이전틱 코딩을 본

[07:52] 첫 번째이고 이것이 클라우드 코드가

[07:54] 제가 가장 좋아하는 프로그래밍 에이전트인 이유예요.

[07:56] 실제로 윈드서프 커서나 구독들을 취소했어요.

[08:00] 저는 순전히 클로드 코드를 사용하고 있고

[08:02] 만약 채팅을 사용하고 싶다면

[08:04] Zed용으로, 지금 Zed를 사용하고 있어요.

[08:05] API 키가 있어서 API 키를 넣고

[08:07] 그걸 사용해요. 즐거운 시간이었고

[08:09] 이 영상은 여기까지입니다.

[08:10] 즐겁게 보셨길 바라고

[08:12] 클라우드 코드를 한번 써보시길 바랍니다.

[08:13] 아래 댓글에 어떻게 생각하는지 알려주세요. 다음 영상에서 만나요. 평화.