DeepLearning.ai 강의 노트
지난주에 정말 시의적절한 강의가 DeepLearning.ai에 올라왔습니다.
Anthropic에서 직접 Claude Code 활용에 대해서 강의한 내용인데요,
+예전에 공유했던 30분 영상에 비해서 보다 심화된 내용입니다. https://www.youtube.com/live/6eBSHbLKuN0?si=kw6XNHFfSjm4R83v
[ 우선, 이번 강의에서 인상적인 점. ]
- 사실상 Claude Code의 아키텍처는
"메모리"와 "툴"을 쥐어주고
컨텍스트를 모아서 > 계획을 세우고 > 실행한다-
라는 심플한 구조라고 공개하였습니다.
개인적으로 이렇게 Claude Code의 아키텍처를 편하게 공개하는 가장 큰 이유는, "Claude 모델에 대한 자신감"으로 보입니다. 즉, Claude 모델 자체가 뛰어나기 때문에, 아키텍처를 공개해도 경쟁사들의 코딩 에이전트 대비 충분히 경쟁력이 있다는 자신감을 읽었습니다.
- 강의 내용에서 Cursor를 전혀 언급하지 않고 VSCode만을 사용하는 것이 개인적으로 흥미로웠습니다. 확대 해석일 수 있지만, 코딩 에이전트에서 전선이 어떻게 변화하고 있나를 간접적으로 느낄 수 있다고 생각했습니다.
- 제가 앞선 claude-o-clock 글에서 언급했던 claude 의 pipe 상에서의 활용이 이번 강의에서는 언급되지 않았습니다. 저는 이러한 pipe 활용도 꽤 유용하다고 생각했는데, Anthropic 입장에서는 종량제 과금인 api호출을 cli의 고정 과금으로 일부 대체할 수 있기 때문에 이런 강의에서 적극적으로 알리지 않는 것일까?라는 '상상/억측(?)'을 해봅니다.
https://github.com/beingcognitive/claude-o-clock/blob/main/claude-o-clock.sh
[ 강의 노트 초간단 요약입니다. ]
1. 기본 syntax
- / 슬래시를 눌러서 사전정의된 여러가지 프롬프트를 사용할 수 있습니다.
. /init : 코드베이스를 읽어서 Claude.md에 정리합니다.
. /compact : Context Window 길이를 고려해서 한번씩 요약을 해줍니다.
. /exit : REPL 종료
. /resume : 종료되었던 대화를 다시 이어서 진행 (claude --resume 과 동일합니다.)
. /model : ($100요금제 이상에서) sonnet을 사용할지, opus를 사용할지 정할 수 있습니다.
- ! 느낌표를 누르면 shell command를 Claude Code 내에서 활용할 수 있습니다. (!pwd, !ls -al 등)
- # 샵을 누르면, Claude에게 자주 요청하는 내용에 대해서 "메모리"로 관리할 수 있습니다. 메모리에는 여러 층위가 있습니다.
. ./CLAUDE.md : 프로젝트 단위로 적용 (같이 작업하는 다른 사용자들에게도 영향)
. ./CLAUDE.local.md : 프로젝트에서 해당 사용자에게만 적용 (.gitignore에 포함되어, 같이 작업하는 다른 사용자들에게는 영향 없음.)
. ~/.claude/CLAUDE.md : 사용자의 모든 프로젝트에 적용
* 참고로, 저의 메모리에는 다음과 같은 내용들을 기록해놓고 있습니다.
# Never use mock data. (종종 Mock 데이터로 앱을 만들어놓는 경우가 있어서...)
# It is 2025, not 2024... (왜인지 모르겠는데, 2024년 기준으로 웹서치를 합니다.)
# Feel free to use web search when you feel stuck (웹 검색만 하라고 해도 같은 문제에서 빙글빙글 도는 경우를 해결할 수 있습니다.)
- @ at을 눌러서 작업 대상 파일을 구체적으로 명시할 수 있습니다. 아무래도 vague한 지시보다는 보다 명확한 작업 지시를 할 수 있어서 권장하는 방식입니다.
- 캡처한 이미지 인풋은 ctrl-v로 가능합니다.
- Claude Code는 훌륭한 개발자이면서도, 훌륭한 설명가이기도 합니다. 아래와 같은 프롬프트에 다이어그램을 멋지게 그려냅니다.
프롬프트 : "draw a diagram that illustrates this flow"
- 자율주행이라고 생각하고, Claude Code가 길을 잘못 들어서고 있다고 생각되면, 기다리지 말고 "언제든지 esc"를 눌러서 작업 중단 및 제대로 된 방향으로 안내하면 됩니다. 이런 맥락에서, 영어 표현에 불과할 수 있지만 강의에서 "navigate Claude Code"라고 설명하는 것이 재미있었습니다.
2. 일을 잘 시키려면, 컨텍스트를 잘 전달해야 함.
- 프롬프트 예시 : "The chat interface displays query responses with source citations. I need to modify it so each source becomes a clickable link that opens the corresponding lesson video in a new tab:
When courses are processed into chunks in @backend/document_processor.py, the link of each lesson is stored in the course_catalog collection
Modify_format_results in @backend/search_tools.py so that the lesson links are also returned
The links should be embedded invisibly (no visible URL text)!"
- Shift-Tab을 눌러서 Plan Mode와 Auto Accept를 변경할 수 있습니다.
무조건 코딩으로 바로 들어가지 말고, 위와 같은 프롬프트를 항상 Plan Mode 상에서 동작시켜서, Claude Code와 계획을 얼라인한 다음에, Auto Accept로 넘어가는 것을 권장합니다.
- 새로운 Feature를 개발시키려면 /clear 로 컨텍스트를 비워주는 것이 좋습니다.
3. 고급 활용 팁들
- Claude가 Sub-Agent들을 또 호출할 수 있습니다. 즉, 제가 Plan Mode로 여러 cli를 띄워서 작업을 할 수도 있겠지만, 아래와 같은 프롬프트도 정말 기발합니다.
"Use two parallel subagents to brainstorm possible plans. Do not implement any code."
그 다음에 마음에 드는 안에 대해서 다시한번 Plan Mode로 요청합니다.
"Implement Approach A"
- 나만의 /커맨드를 만들 수 있습니다. .claude 폴더 > commands 폴더> 구현할기능.md 파일을 만들어서 적용합니다.
- MCP 툴을 설치할 수 있습니다. 이는 프로젝트 단위로 설치됩니다.
$ claude mcp add playwright npx @playwright/mcp@latest
- git worktrees 기능을 활용하면 (ui 수정, 테스트 기능 추가와 같은) 독립적인 기능들을 "동시에" 개발시키고 merge 시킬 수 있습니다.
$ mkdir .trees
$ git worktree add .trees/ui_feature
git worktree add .trees/testing_feature
git worktree add .trees/quality_feature
merge도 당연히 자연어로 합니다. 프롬프트 예시 : "use the git merge command to merge in all of the worktress in the trees folder and fix any conflicts if there are any"
- /install-github-app : Claude Code가 내 노트북을 벗어나서 github상에서 일을 할 수 있습니다...! 코드 리뷰를 항상 같이 할 수 있습니다!
- /hooks : 매칭되는 툴을 사용할 때에, 특정 커맨드를 실행하게 만들 수 있습니다. (Read가 되면 say 'Done' 이라고 TTS로 말하기 등)
[ 맺음말 ]
(AI 활용에 대해서 거부감이 있는 개발자들도 여전히 있지만,)
엑셀이라는 동일한 툴에 대해서도 그 활용 스킬에 따라서, 생산성의 차이가 극명하게 나는 것처럼,
Claude Code와 같은 코딩 에이전트을 어떻게 활용하느냐에 따라서 개발자들의 생산성이 크게 차이날 수 밖에 없다고 생각합니다.
굳이 요약 노트를 적었으나, 당연히 Claude Code활용의 Best Practice가 넘쳐나는 이번 강의 직접 수강하는 것을 더더욱 추천합니다. :)
이 글 보시는 모두들 보다 높은 생산성을 달성하기를 응원합니다.
https://www.deeplearning.ai/short-courses/claude-code-a-highly-agentic-coding-assistant/