Code Gear - AI 개발 유튜브 강의

지난 글에서 책이 나오기까지의 이야기를 풀어놓았는데, 정작 중요한 질문에는 답을 안 했더라고요.

"그래서, 그 책에는 뭐가 들어 있나요?"

오늘은 그 답을 드리려고 합니다. 『밑바닥부터 따라하면서 배우는 클로드 코드 완전 정복』이 어떤 책이고 누구에게 필요한지, 목차를 따라가며 소개하겠습니다.

→ 책이 나오기까지의 이야기가 궁금하다면: https://codegear.tistory.com/162

한 줄로 말하면

AI에게 말로 설명해서 프로그램을 만드는 개발 방식, 요즘 말로 '바이브 코딩'을 클로드 코드(Claude Code)로 처음부터 끝까지 따라 해보는 입문서입니다.

개념 설명으로 끝나지 않습니다. 설치도 하기 전에 브라우저에서 무료로 첫 웹페이지를 만들어보는 것으로 시작해서, 마지막에는 직접 만든 웹 서비스를 클라우드에 배포하고 GitHub에 자동 코드 리뷰까지 붙입니다. 360쪽 내내 손을 움직이게 되실 거예요.

이런 분께 필요합니다

• 코딩은 처음이지만, AI로 뭔가 만들어보고 싶은 분
• 지금 쓰는 도구에서 AI 코딩 도구로 갈아타려는 현업 개발자
• 바이브 코딩, 에이전틱 코딩이라는 말은 들었는데 실체가 궁금한 분
• 클로드 코드를 깔아는 봤는데, 어디서부터 시작할지 막막했던 분

반대로 특정 언어의 문법을 깊이 배우고 싶은 분께는 맞지 않습니다. 이 책의 관심사는 "AI와 함께 만드는 법"이지 문법 강의가 아니거든요.

장별로 살펴보면

1장 「AI와 개발 패러다임의 변화」에서는 도구 사용법으로 바로 뛰어들지 않고 큰 그림부터 그립니다. 바이브 코딩과 에이전틱 코딩이 무엇이고 왜 등장했는지, 그리고 AI 코딩 도구를 대화형, 웹앱 빌더, IDE 통합형, 에이전트형 네 가지로 나눠 비교합니다. "내게 맞는 도구가 뭘까, 왜 클로드 코드일까"를 스스로 판단할 수 있게 하는 장입니다.

2장 「클로드 코드 기초」는 맛보기 실습으로 시작합니다. 설치 없이, 무료로, 브라우저에서 1분 만에 자기소개 웹페이지를 만들어봅니다. 입문서를 읽다 보면 실습이 너무 늦게 나와서 지치는 경우가 많은데, 그 순서를 뒤집었습니다. 첫 성공을 맛본 다음에 요금제와 회원 가입, 터미널 기초, 설치와 로그인, VS Code·IntelliJ 연동을 차례로 짚고, 브라우저에서 바로 쓰는 Claude Code on the Web까지 다룹니다.

3장 「바이브 코딩 기초」는 제가 이 책에서 가장 공들인 장입니다. 머릿속의 막연한 '느낌'을 구체적인 코드로 바꾸는 법, 결과가 어긋났을 때 오류를 수정하는 법, 효과적인 프롬프트 작성법, 그리고 AI에게 얼마나 깊이 고민하게 할지 조절하는 사고 강도 제어까지. 실습으로는 개발자 포트폴리오 사이트와 토큰 계산기를 직접 만듭니다.

4장 「클로드 코드 고급 활용법」에는 한 단계 위로 올라가는 기능을 모았습니다. 슬래시 명령어, 에이전트 스킬, 서브에이전트, 훅, MCP를 다루고, 공식 마켓플레이스가 열린 플러그인도 여기서 소개합니다. 이름만 들으면 어렵게 느껴지는 것들인데, 하나씩 직접 써보며 익히는 구성입니다.

5장 「AI 에이전트 기반의 풀스택 개발 워크플로」에서는 앞에서 배운 걸 모두 모아 앱 하나를 처음부터 끝까지 만듭니다. 프로젝트 설계, 소스 구현, 서버 실행과 디버깅, 구글 로그인 연동, 기능 테스트, 깃허브 소스 관리를 거쳐 마지막에는 무료 클라우드에 배포합니다. 이 장을 마치면 내가 만든 서비스를 남에게 링크로 보여줄 수 있게 됩니다.

6장 「클로드 코드를 활용한 코드 품질 개선」은 새로 만들기보다 이미 있는 코드를 다루는 장입니다. 레거시 코드 분석, 디버깅, 리팩터링, 보안 취약점 점검, 테스트 케이스 생성, 문서화, 데이터베이스 관리. 마지막에는 실전 예시로 GitHub PR에 자동 코드 리뷰가 달리도록 만들어봅니다.

마지막 7장 「마치며」에서는 AI 시대에 개발의 주도권을 어떻게 지킬지, 개발자는 어떻게 성장해야 할지를 짚습니다. 부록에는 책을 덮은 뒤 이어서 볼 만한 추천 학습 자료를 정리했습니다.

이 책으로 만들게 되는 것들

말로 설명하는 것보다 결과물 목록이 빠르겠네요. 책을 따라가면 이런 것들이 손에 남습니다.

1. 자기소개 웹페이지 — 설치 없이 브라우저에서, 1분
2. 개발자 포트폴리오 사이트 — 프롬프트 작성과 오류 수정을 여기서 연습합니다
3. 토큰 계산기 — PRD로 요구사항을 전달하는 법을 익힙니다
4. 구글 로그인이 되는 풀스택 웹 서비스 — 설계부터 배포까지
5. GitHub PR 자동 코드 리뷰 — 회사 프로젝트에도 바로 써먹을 수 있는 자동화

AI 책은 금방 낡지 않나요?

책을 쓰는 내내 저를 괴롭힌 질문이고, 독자분들이 가장 걱정하실 부분이라고 생각합니다. 그래서 두 가지를 준비했습니다.

하나, 책 자체를 특정 버전의 화면과 기능에 묶이지 않게 썼습니다. 유행하는 기능 나열이 아니라, 시간이 지나도 유효한 원리와 워크플로 중심으로요.

둘, 출간 이후의 변화는 깃허브 저장소에 계속 정리하고 있습니다. 저장소에는 장별 예제 코드 전체와 클로드 코드 치트시트, 그리고 출간 뒤 새로 나온 모델과 기능을 담은 업데이트 문서가 들어 있습니다. 전부 무료입니다.

💻 https://github.com/wikibook/mastering-claude-code

궁금한 점이나 오탈자 제보는 저장소 이슈로 남겨주시면 제가 직접 확인합니다.

책 정보

『밑바닥부터 따라하면서 배우는 클로드 코드 완전 정복』
바이브 코딩 입문자부터 풀스택 개발자까지, 모두를 위한 클로드 코드 완전 활용법
엄태효 지음 | 위키북스 | 2026년 6월 24일 출간 | 360쪽 | 28,000원

구매하실 수 있는 곳

• 교보문고: https://product.kyobobook.co.kr/detail/S000220273082
• 예스24: https://www.yes24.com/product/goods/192047818
• 알라딘: https://www.aladin.co.kr/shop/wproduct.aspx?ItemId=395837303

사기 전에 훑어보고 싶다면 교보문고 미리보기로 앞부분을 읽어보실 수 있습니다.

• 미리보기: https://product.kyobobook.co.kr/book/preview/S000220273082

🎬 이 책이 나오기까지의 이야기는 영상으로도 담았습니다.

• https://youtu.be/87_rgehG5PY

읽어주셔서 감사합니다. 궁금한 게 있으면 댓글로 편하게 물어봐 주세요. 🙌

7월 24일, Anthropic이 Claude Opus 5를 공개했습니다.

이 글은 Anthropic 공식 발표를 바탕으로 정리했습니다.

가장 먼저 확인한 건 가격이었습니다. 새 모델이 나오면 보통 값도 같이 오르니까요. 그런데 이번엔 아니었습니다. 입력 100만 토큰당 $5, 출력 $25. 이전 버전인 Opus 4.8과 똑같습니다.

그럼 성능은 어떻게 달라졌을까요. 발표 자료에 나온 벤치마크 숫자를 하나씩 살펴봤습니다.

기본 정보부터

Anthropic의 최상위 모델인 Fable 5는 입력 $10, 출력 $50입니다. Opus 5가 정확히 절반값이죠.

재밌는 건 Fast 모드 가격입니다. Fable 5와 똑같습니다. 빠르게 쓰려면 결국 최상위 모델과 같은 값을 내야 하는 셈입니다.

1. 벤치마크에서 실제로 무슨 일이 있었나

Frontier-Bench: 43.3%

이 숫자가 이번 업데이트의 핵심입니다. Opus 4.8이 18.7%였으니 2배가 넘게 올랐습니다.

Frontier-Bench가 뭘 재는 시험인지 알면 이 숫자가 더 크게 보입니다. 객관식 정답률이 아닙니다. AI에게 실제 업무를 던져주고 끝까지 해냈는지를 봅니다.

• 74개 과제가 들어 있습니다
• 코딩만이 아니라 과학, 보안, 하드웨어 설계, 금융, 음악까지 다룹니다
• 과제마다 별도 검증 장치가 합격 여부를 기계적으로 판정합니다

그러니까 43.3%는 74개 중 32개쯤 끝냈다는 뜻입니다. 벤치마크가 공개됐을 때 최고 점수가 34% 정도였으니, 기존 1위를 넘어섰습니다.

물론 뒤집어 보면 절반 이상은 여전히 실패합니다. 애초에 그런 난이도로 만든 시험입니다.

CursorBench: 70.0%, 1위와 0.5%p 차이

CursorBench는 Cursor라는 회사가 만든 벤치마크입니다. 문제를 만드는 방식이 독특합니다.

Cursor 사내 개발자들이 업무 중에 AI에게 던진 요청을 그대로 모아 시험 문제로 씁니다. 문제집이 아니라 실무 기록이 원본인 거죠. 심지어 과제 설명을 일부러 짧고 모호하게 둡니다. 개발자가 AI에게 말하는 방식이 원래 그러니까요.

채점도 정답 여부만 보지 않습니다.

1. 그 코드가 실제 환경에서 돌아가는가
2. 읽기 좋고 기존 코드 스타일에 맞는가
3. 답을 찾는 데 토큰을 얼마나 썼는가
4. 작업 과정에서 적절하게 행동했는가

결과가 이렇습니다.

6위였던 Opus가 2위로 올라갔습니다. 그 사이에 있던 GPT-5.6 Sol과 Grok 4.5를 뛰어넘었죠.

1위와 차이는 0.5%p입니다. 가격은 절반인데요.

그 외

• ARC-AGI 3 (처음 보는 문제 풀기): 2위 모델의 3배 점수
• OSWorld 2.0 (컴퓨터 직접 조작): Fable 5 최고 기록을 넘었고, 비용은 3분의 1입니다
• Zapier AutomationBench (업무 자동화): 같은 비용으로 1.5배 성공률

2. 체감되는 변화

숫자보다 실제로 쓸 때 달라지는 부분을 정리했습니다.

스스로 확인하고 고칩니다

가장 반가운 변화입니다.

AI에게 작업을 맡길 때 제일 답답한 순간이 있죠. 틀린 걸 모르고 계속 가는 겁니다. 한참 뒤에 확인해 보면 처음부터 잘못된 방향이었던 경우요.

Opus 5는 자기 작업을 확인하고, 틀리면 되돌아가 고치는 능력이 강해졌습니다. 여러 단계로 이어지는 긴 작업도 옆에서 계속 지켜보지 않아도 됩니다.

Effort로 비용을 조절합니다

"오래 생각하게 하기"와 "토큰 아끼고 빠르게" 사이를 설정으로 조절할 수 있습니다. 비용을 다이얼처럼 돌리는 셈이죠.

앞에서 본 CursorBench 70.0%도 최대 설정(max effort) 기준입니다. 가벼운 작업이라면 낮춰서 토큰을 아끼면 됩니다.

눈에 보이는 결과물이 좋아졌습니다

아티팩트나 인터랙티브 데모처럼 화면으로 확인하는 산출물의 품질이 올라갔습니다.

그 외 (베타)

• 대화 중간에 도구를 바꿔도 프롬프트 캐시가 유지됩니다
• 차단된 요청은 다른 모델로 자동 연결됩니다

3. 안전성은 어떤가

• 자동 정렬 평가에서 최근 Claude 모델 중 가장 낮은 2.3점을 받았습니다. 이 점수는 낮을수록 좋습니다.
• 보안 관련 분류기가 덜 까다로워져서, 불필요하게 막히는 경우가 약 85% 줄었습니다.
• 다만 사이버보안이나 생물학 연구 쪽은 여전히 다른 모델에 뒤집니다.

그래서 어떻게 쓰면 좋을까

Claude Code를 쓰고 계시다면 특별히 할 일은 없습니다. 모델을 Opus 5로 선택하면 됩니다.

급할 때는 /fast 명령을 써보세요. 속도가 2.5배 빨라집니다. 대신 요금도 2배니 꼭 필요할 때만 쓰는 게 좋겠습니다.

이번 업데이트를 한 줄로 줄이면 이렇습니다.

내 지갑에서 나가는 돈은 그대로인데, 결과물이 좋아졌습니다.

새 모델이 나오면 값도 오르는 게 당연하다고 여겼는데 이번엔 반대였네요. 이런 업데이트라면 반가운 마음으로 써보게 됩니다.

참고

• Anthropic 공식 발표
• Frontier-Bench 공식 페이지
• Cursor의 모델 평가 방식

벤치마크 숫자를 볼 때 한 가지 참고하실 점이 있습니다. CursorBench는 Cursor가 자사 데이터로 만든 벤치마크입니다. 만드는 방식이 실무에 가까워 참고할 만하지만, 특정 회사가 만든 기준이라는 점은 알고 보는 게 좋습니다.

클로드 코드를 실무 프로젝트에 깊숙이 도입해 보면 이내 장벽에 부딪히게 된다. 초기에는 뛰어난 성능을 보여주던 에이전트가 대화 세션이 길어질수록 엉뚱한 코드를 짜거나, 바로 직전에 지시한 규칙을 잊어버리는 현상을 자주 겪기 때문이다.

이러한 한계는 모델 자체의 결함이라기보다, 에이전트의 핵심 작동 메커니즘을 오해하고 잘못 다루었을 때 발생하는 경우가 많다. 클로드 코드를 프로덕션 환경에서 견고한 도구로 통제하기 위해 반드시 이해해야 할 3가지 핵심 설계 원칙을 정리한다.

1. 컨텍스트 윈도우를 철저하게 제어하라

클로드 코드를 다룰 때 개발자가 관리해야 할 가장 귀중한 자원은 바로 컨텍스트(Context) 다.

사용자가 입력한 대화 기록, 에이전트가 읽어 들인 소스 코드 파일, 실행한 명령어의 터미널 출력값, 첨부한 이미지 등은 모두 '컨텍스트 윈도우(Context Window)'라는 하나의 작업 공간에 차곡차곡 누적된다. 이 공간이 가득 차면 모델은 이전 맥락을 유실하기 시작하며, 지시를 잊거나 추론 실수가 눈에 띄게 증가한다. 뒤에서 언급할 /clear 명령어, 서브에이전트 활용, 짧은 CLAUDE.md 설정 등은 모두 이 컨텍스트 자원을 아끼기 위한 구체적인 처방들이다.

특히 이미지를 가볍게 다루어서는 안 된다. 모델은 이미지를 시각 자료 그대로 받아들이는 것이 아니라, 잘게 쪼개어 수많은 토큰(Token)으로 변환한 뒤 컨텍스트 윈도우에 밀어 넣는다. 고해상도 스크린샷 한 장이 수백에서 수천 단어 분량의 텍스트와 맞먹는 공간을 차지하므로, 이미지 오용은 컨텍스트를 고갈시키는 주범이 된다.

"1M 토큰 시대에 굳이 컨텍스트를 아껴야 하는가?"

2026년 3월 13일부로 Opus 4.6 및 Sonnet 4.6 모델에서 100만(1M) 토큰 컨텍스트 윈도우가 정식 제공되기 시작했다. 대규모 코드베이스를 통째로 밀어 넣어도 남을 만큼 여유로운 용량이다. 그러나 용량이 커졌다고 해서 자원 관리가 무의미해진 것은 아니다. 오히려 대용량 컨텍스트 환경이기 때문에 관리의 필요성은 더욱 커졌다. 그 기술적 근거는 다음과 같다.

① 수용 용량과 추론 성능은 비례하지 않는다

100만 토큰은 모델이 한 번에 '입력받을 수 있는 최대 한계치'일 뿐, 그 안에 담긴 모든 정보가 균일하게 활용되고 분석된다는 보장이 아니다. 정보의 절대량이 늘어날수록 모델이 처리해야 할 노이즈도 함께 증가한다. 넓은 책상을 쓴다고 해서 구석에 밀어둔 서류의 메모 내용까지 사람이 또렷하게 기억할 수 없는 것과 같은 이치다.

② 컨텍스트 로트(Context Rot) 현상

컨텍스트 로트란 대화 세션이 길어지고 정보가 누적될수록 모델의 정확도와 회상률(Recall)이 서서히 감퇴하는 현상이다.

우유가 상하는 과정을 생각하면 이해하기 쉽다. 냉장고에 넣어둔 우유가 유통기한 마지막 날에 한순간에 상하는 것이 아니다. 냉장고 문을 열고 닫는 순간부터 눈에 보이지 않게 조금씩 변질되어 가며, 어느 날 마셔보고 나서야 상태가 이상함을 인지할 뿐이다. 컨텍스트 역시 특정 한계에 도달해 한 번에 무너지는 것이 아니라, 정보가 채워지는 과정에서 처음부터 서서히 성능이 열화된다. "아직 1M 용량이 남았으니 안전하다"고 맹신할 수 없는 이유다.

③ 'Lost in the Middle' 현상의 실제와 한계

거대 언어 모델은 입력된 컨텍스트의 맨 앞과 맨 뒤에 위치한 정보에 집중하며, 중간에 파묻힌 정보는 쉽게 유실하는 경향이 있다.

이 현상은 스탠퍼드 연구진(Percy Liang 등)이 동료 심사 학술지 TACL에 게재한 논문 「Lost in the Middle: How Language Models Use Long Contexts」에서 학술적으로 명확히 규명되었다.

*"We observe that performance is often highest when relevant information occurs at the beginning or end of the input context, and significantly degrades when models must access relevant information in the middle of long contexts, even for explicitly long-context models."*

[번역] "우리는 관련 정보가 입력 문맥의 시작이나 끝에 배치될 때 성능이 가장 높았으며, 긴 문맥의 중간에 있는 관련 정보에 액세스해야 할 때 성능이 크게 떨어진다는 것을 관찰했습니다. 이는 장문맥 처리를 위해 특별히 개발된 모델에서도 동일하게 나타났습니다."

단, 이 연구 결과를 오늘날의 클로드 코드에 그대로 기계적으로 대입하는 것은 경계해야 한다.

• 시점의 차이: 해당 연구는 2023년에 수행되어 당시 세대의 모델(Claude-1.3, GPT-3.5-Turbo 등)을 대상으로 했다.
• 규모의 차이: 실험에 사용된 컨텍스트 크기는 2K~16K 토큰 수준으로, 오늘날의 1M 크기와는 수십 배 이상의 차이가 존재한다.
• 태스크의 차이: 논문은 다문서 QA와 키-값 검색을 다루었으므로, 유기적인 소스 코드 분석 및 함수 호출 추적 작업과는 결이 다르다.
• 성능의 지속적 향상: 앤트로픽의 최신 Opus 모델은 세대를 거듭하며 장문맥 추론 점수가 크게 향상되고 있다.

그럼에도 불구하고 이 논문이 시사하는 바는 명확하다. 정보의 절대적인 배치 위치가 모델 추론에 영향을 미친다는 현상 자체는 실재하며, 컨텍스트 윈도우가 극적으로 확장된 지금은 오히려 잃어버릴 수 있는 '중간 지대'가 훨씬 더 광활해졌음을 뜻한다.

④ 멀티홉(Multi-hop) 추론 성능의 저하

코딩은 여러 파일과 함수, 설정을 유기적으로 추적해야 하는 대표적인 멀티홉 작업이다. 최종 답안을 도출하기 위해 정보의 고리를 여러 단계에 걸쳐 타고 넘어가야 하기 때문이다.

지하철 환승에 비유할 수 있다. 한 번에 가는 직행 노선은 길을 잃을 염려가 없지만, 여러 번 환승해야 하는 노선은 중간에 사슬 하나만 끊어져도 목적지와 전혀 다른 곳에 도달하게 된다.

앤트로픽이 공개한 Opus 4.8 시스템 카드에 따르면, 거대한 그래프 구조를 순회하게 만드는 멀티홉 추론 테스트인 GraphWalks BFS(F1) 실험에서 아주 명확한 상관관계가 나타난다.

• 256K 서브셋 (윈도우를 일부만 채웠을 때): 85.9%
• 1M 서브셋 (윈도우를 가득 채웠을 때): 68.1%

동일한 최신 모델을 사용했음에도 컨텍스트 윈도우를 꽉 채워 쓰자 멀티홉 추론 성능이 17.8%p나 급감했다. 코딩 과정에서 가장 필수적인 다단계 참조 능력이, 역설적으로 컨텍스트가 차오를 때 가장 먼저 취약해짐을 증명한다.

💡 실천적 컨텍스트 관리 전략

• 주제가 바뀌면 즉시 /clear를 실행하라
  버그 수정을 끝내고 신규 기능 구현이나 리팩토링으로 넘어갈 때는 이전 세션의 잔재를 완전히 비워내야 한다. 한 세션에 여러 작업을 뒤섞어 수행하는 '잡탕 세션'이 컨텍스트 오염의 주원인이다.
• 탐색성 작업은 서브에이전트에게 위임하라
  "로그인 흐름이 어디서 시작되는지 찾아달라"와 같은 코드 탐색 작업은 메인 창이 아닌 @explore 서브에이전트를 호출하여 처리해야 한다.

📌 @explore 서브에이전트 작동 방식

❯ @explore "로그인 흐름이 시작되는 진입점 파일을 찾아줘"

서브에이전트는 완전히 격리된 별도의 컨텍스트 윈도우에서 작동한다. 수십 개의 소스 파일을 열어보며 발생한 수만 토큰의 찌꺼기는 서브에이전트 세션의 종료와 함께 소멸하며, 메인 대화창에는 정돈된 요약 정보만 전달되므로 메인 컨텍스트를 깨끗하게 유지할 수 있다.

• /compact 명령어는 목적성을 갖고 사용하라
  대화 흐름을 유지하되 컨텍스트를 비우는 /compact 명령어는 기본적으로 대화를 요약하는 '손실 압축' 방식이다. 중요 규칙이나 세부 제약 조건이 누락될 위험이 있으므로, /compact "인증 관련 결정사항은 반드시 유지해줘"와 같이 보존해야 할 핵심 맥락을 직접 지정하여 실행하는 것이 안전하다.

2. 지시 사항은 대화가 아닌 파일에 명문화하라

클로드 코드를 사용하며 세션마다 "진행 상황은 한국어로 설명해라", "테스트 코드는 특정 라이브러리를 써라"와 같은 지시를 반복하는 경우가 많다. 이는 에이전트의 작동 원리를 오해한 비효율적인 접근이다.

"대화창을 통한 지시는 세션이 종료되는 즉시 소멸한다."

새로운 세션이 시작되면 에이전트는 이전 대화의 약속을 기억하지 못하며, 모델 고유의 기본 경향성(예: 영문 출력, 기본 구조 선호)으로 회귀한다.

해결책: CLAUDE.md 파일 활용

매번 반복해야 하는 프로젝트 고유의 규칙, 코딩 컨벤션, 언어 설정 등은 전역 설정 파일(~/.claude/CLAUDE.md) 또는 프로젝트 루트의 CLAUDE.md 파일에 기록해야 한다.

# 프로젝트 규칙
- 모든 대화와 작업 요약은 한국어로 진행합니다.
- 예외적으로 변수명, 주석, 커밋 메시지 등 코드와 관련된 자산은 영문 컨벤션을 따릅니다.
- 외부 라이브러리 도입 전 반드시 사용자에게 승인을 요청합니다.

CLAUDE.md는 클로드 코드가 세션을 시작할 때 가장 먼저 자동으로 읽어 들이는 파일이다. 여기에 기록된 규칙은 컨텍스트의 가장 앞부분에 상시 배치되므로, 대화 도중 소실되거나 'Lost in the Middle' 현상에 의해 망각될 우려가 없다.

• 판단 기준: 동일한 요구사항을 두 번 이상 말하고 있다면, 그것은 대화의 영역이 아니라 CLAUDE.md 파일로 승격시켜야 할 대상이다.

3. 결과물이 아닌 검증 프로세스를 통제하라

앤트로픽의 공식 가이드라인은 다음과 같은 핵심 권장 사항을 제시한다.

*"If you only adopt one practice, make it verification."*
(단 하나의 습관만 들여야 한다면, 그것은 반드시 검증이어야 한다.)

클로드 코드는 자율적으로 판단하고 실행하는 에이전트다. 그러나 명확한 채점 기준(검증 수단)이 주어지지 않으면, 코드가 실제로 동작하는지 확인하지 않은 채 외관상 그럴싸한 수준에서 작업을 종료하고 성공을 선언한다.

검증 수단을 제공하지 않으면 개발자 본인이 매번 테스트 환경을 구축하고 직접 구동하여 에러를 피드백해 주는 '인간 검증 루프'에 갇히게 된다.

"Pass / Fail" 피드백 루프 구축

가장 견고한 개발 워크플로우는 에이전트 스스로 코드를 작성하고, 테스트를 수행하며, 실패 시 코드를 자가 수정하는 닫힌 루프(Closed Loop)를 만들어 주는 것이다.

• 실패하는 테스트 코드를 선행 작성하라
  특정 버그를 수정하기 전, 해당 버그가 재현되어 반드시 실패하는 단위 테스트를 먼저 작성하도록 지시해야 한다. 이후 "이 테스트 케이스가 통과할 때까지 코드를 수정하라"고 명령하는 방식이 가장 확실하다.
• 정적 분석 및 빌드 명령어를 연계하라
  단순히 코드를 작성하는 것에 그치지 않고, npm run lint나 빌드 명령어를 에이전트가 직접 수행하여 에러가 없음을 최종 결과물로 증명하도록 요구해야 한다.

에이전트에게 일을 시킬 때는 "어떻게 구현할지"를 일일이 지시하는 것보다, "구현이 완료되었음을 어떻게 검증할지"를 먼저 설계하여 쥐여주는 것이 고성능 에이전트를 다루는 가장 성숙한 개발 방식이다.

드디어 클로드 코드가 v2.0으로 업데이트 되었습니다. 

이번 업데이트에서 변경된 핵심적인 사항들에 대해 알아보겠습니다.

이 글은 영상으로 제작되어 유튜브에서 시청하실 수 있습니다.

https://youtu.be/NY2nzRBU32M

이번 업데이트는 모델 성능을 획기적으로 향상시키는 데 초점을 맞추고 있으며, 특히 개발자들이 가장 크게 체감할 수 있는 변화는 바로 새로운 모델의 적용입니다.

모델 업그레이드: 소네트(Sonnet) 4.5

클로드 코드에서 기존에는 오퍼스(Opus) 4.1과 소네트(Sonnet) 4.1 모델을 선택적으로 사용할 수 있었습니다. 이번 업데이트로 이제 소네트 4.5가 기본 모델로 탑재되었습니다. 물론, 필요에 따라 여전히 오퍼스 모델을 선택해 사용할 수 있습니다. 소네트 4.5는 코드에 대한 이해력과 생성 능력이 대폭 향상되어, 더욱 정확하고 효율적인 개발 작업을 지원할 것으로 기대됩니다.

벤치마크로 확인하는 성능 향상

실제 성능 향상은 벤치마크 테스트 결과에서도 잘 드러납니다. 특히 코딩 에이전트의 성능을 측정하는 대표적인 지표인 SWE-Bench에서 클로드는 여전히 탁월한 성능을 보여주고 있습니다.

몇몇 사용자의 경험에 따르면, 기존 모델과 비교했을 때 확연한 성능 차이를 느낄 수 있었다고 합니다. 단순히 코드를 생성하는 것을 넘어, 복잡한 문제 해결 과정에서도 더 나은 추론 능력을 보여주는 것이 주요 특징입니다.

실제 몇일간 사용해보면서 Sonnet4.5가 Opus 4.1과 비슷하면서, 성능이 많이 개선되었고 느꼈습니다. 요청한 대부분의 요청에서 의도한 바를 정확히 인식하였고, 약간의 개발자 의견을 더해서 구현도 제대로 할 수 있었습니다.

UI 개선: 더 친숙해진 사용자 경험

이번 업그레이드에서 사용자들이 크게 체감할 수 있는 변화 중 하나는 바로 사용자 인터페이스(UI)의 개선입니다. CLI(Command Line Interface) 기반 도구의 UI는 태생적으로 한계가 있지만, 클로드 코드는 그 안에서도 다양한 사용자 친화적 요소를 적용하여 사용 편의성을 높였습니다.

새로운 UI는 정보를 더욱 직관적으로 표시하고, 사용자가 필요한 정보를 쉽게 찾을 수 있도록 개선되었습니다. 예를 들어, 진행 중인 작업의 상태를 시각적으로 명확하게 보여주고, 주요 정보를 한눈에 파악할 수 있도록 구성했습니다. 이러한 변화는 복잡한 CLI 환경에 익숙하지 않은 사용자에게도 훨씬 더 친숙하게 느껴질 것 같습니다.

사용량 확인 기능: `/usage` 명령어

이번 업데이트에서 사용자 편의성을 크게 향상시킨 또 다른 기능은 바로 사용량 확인 명령어 `/usage`의 추가입니다. 기존에는 `ccusage`와 같은 외부 도구를 사용해야만 했고, 이로 인해 여러 기기에서 작업할 경우 정확한 사용량을 파악하기 어려운 문제가 있었습니다. 이제 클로드 코드에 내장된 이 명령어를 사용하면 기기에 상관없이 정확한 사용량 정보를 손쉽게 확인할 수 있습니다.

또한, 컨텍스트 윈도우의 크기를 확인하는 명령어 `/context` 역시 사용자 가독성을 높이는 방향으로 개선되어, 작업 환경을 더욱 효율적으로 관리할 수 있게 되었습니다.

Undo 기능 `/rewind` 

코딩 작업을 하다 보면, 의도치 않은 실수가 발생하거나 복잡한 작업으로 인해 코드가 꼬이는 경우가 잦습니다. 이럴 때를 대비해 개발자의 코드 수정 상태를 자동으로 저장해 주는 **'되감기(rewind)'** 기능이 추가되었습니다. 이 기능 덕분에 새로운 시도를 하다가 문제가 생겨도 **`/rewind`** 명령어를 사용해 이전의 안정적인 상태로 손쉽게 되돌아갈 수 있습니다.

VSCode 확장 프로그램: IDE 연동을 통한 편리한 개발 환경

개인적으로 Claude Code를 활용할 때는 터미널보다는 VS Code 확장 프로그램을 선호합니다. IDE(통합 개발 환경)가 주는 익숙함과 편의성, 그리고 확장 프로그램이 IDE와 긴밀하게 연동될 때 얻을 수 있는 시너지 효과 때문입니다.

터미널 환경에 익숙하지 않은 사용자들을 위해 VS Code 마켓플레이스에 네이티브 확장 프로그램이 공식적으로 출시되었습니다.

이 확장 프로그램은 VS Code 내에 전용 사이드바를 제공하며, 코드를 수정할 때 인라인 차이점(inline diff) 기능을 통해 변경 사항을 실시간으로 직관적으로 확인할 수 있고, 마우스로 원하는 부분을 선택하는 등 그래픽 기반의 사용자 인터페이스를 활용해 효율적으로 코딩 작업을 할 수 있습니다. 복잡한 터미널 명령어를 일일이 입력할 필요가 없어진 것이죠.

VSCode의 Status Bar에 Context 사용 상태를 표시하는 파이차트와 수치가 표시됩니다.

VSCode에서 클로드 코드의 질문에 마우스로 답변할 수 있는 UI가 추가되었습니다.

최신 업그레이드 확인을 위한 `/release-notes`

새로운 기능과 개선 사항을 확인하려면 /release-notes 명령어를 사용해 보세요. 이 명령어를 통해 최신 업데이트 내용을 자세히 살펴볼 수 있습니다. 아래는 현재 날짜인 2025년 10월 9일 기준으로 v2.0 릴리스 노트의 주요 변경 사항입니다.

Version 2.0.0:
     • New native VS Code extension
     • Fresh coat of paint throughout the whole app
     • /rewind a conversation to undo code changes
     • /usage command to see plan limits
     • Tab to toggle thinking (sticky across sessions)
     • Ctrl-R to search history
     • Unshipped claude config command
     • Hooks: Reduced PostToolUse 'tool_use' ids were found without 'tool_result' blocks errors
     • SDK: The Claude Code SDK is now the Claude Agent SDK
     • Add subagents dynamically with `--agents` flag

     Version 2.0.1:
     • Skip Sonnet 4.5 default model setting change for Bedrock and Vertex
     • Various bug fixes and presentation improvements

     Version 2.0.5:
     • IDE: Fix IME unintended message submission with Enter and Tab
     • IDE: Add "Open in Terminal" link in login screen
     • Fix unhandled OAuth expiration 401 API errors
     • SDK: Added SDKUserMessageReplay.isReplay to prevent duplicate messages

     Version 2.0.8:
     • Update Bedrock default Sonnet model to `global.anthropic.claude-sonnet-4-5-20250929-v1:0`
     • IDE: Add drag-and-drop support for files and folders in chat
     • /context: Fix counting for thinking blocks
     • Improve message rendering for users with light themes on dark terminals
     • Remove deprecated .claude.json allowedTools, ignorePatterns, env, and todoFeatureEnabled config options (instead, configure these in your settings.json)

     Version 2.0.9:
     • Fix regression where bash backgrounding stopped working

     Version 2.0.10:
     • Rewrote terminal renderer for buttery smooth UI
     • Enable/disable MCP servers by @mentioning, or in /mcp
     • Added tab completion for shell commands in bash mode
     • PreToolUse hooks can now modify tool inputs
     • Press Ctrl-G to edit your prompt in your system's configured text editor
     • Fixes for bash permission checks with environment variables in the command

     Version 2.0.11:
     • Reduced system prompt size by 1.4k tokens
     • IDE: Fixed keyboard shortcuts and focus issues for smoother interaction
     • Fixed Opus fallback rate limit errors appearing incorrectly
     • Fixed /add-dir command selecting wrong default tab

최근 하루 이틀만에 마이너 버전 릴리즈가 지속적으로 이루어 지고 있습니다. 이를 통해 다양한 기능들이 추가되고, 편의성이 더해질 것으로 기대됩니다.