Skip to content

Claude Code

Anthropic에서 만든 에이전트 코딩 도구.

Claude Code는 터미널에서 작동하고, 코드베이스를 이해하며, 자연어 명령을 통해 더 빠르게 코딩할 수 있도록 도와주는 에이전트 코딩 도구입니다. 개발 환경에 직접 통합되어 추가 서버나 복잡한 설정 없이 워크플로우를 간소화합니다.

Categories

Claude Code Guide Agent

@"claude-code-guide (agent)" 를 사용하면 클로드 코드에 대한 공식 가이드가 좀더 잘 적용된다.

Install 

npm install -g @anthropic-ai/claude-code

Features

Claude Code의 주요 기능은 다음과 같습니다:

  • 코드베이스 전체에서 파일 편집 및 버그 수정
  • 코드 아키텍처 및 로직에 대한 질문에 답변
  • 테스트, 린팅 및 기타 명령 실행 및 수정
  • git 히스토리 검색, 병합 충돌 해결, 커밋 및 PR 생성
  • 웹 검색을 사용하여 인터넷에서 문서 및 리소스 탐색
  • 기업 배포를 위한 Amazon Bedrock 및 Google Vertex AI와 함께 작동

왜 Claude Code인가?

Claude Code는 터미널에서 직접 작동하여 프로젝트 컨텍스트를 이해하고 실제 작업을 수행합니다. 컨텍스트에 파일을 수동으로 추가할 필요 없이 Claude가 필요에 따라 코드베이스를 탐색합니다.

CLAUDE.md

좋은 Claude.md 작성법

LLM은 상태를 저장하지 않는 함수이므로, CLAUDE.md는 매 세션마다 Claude에게 코드베이스를 소개하는 핵심 문서로 작동함

  • 파일에는 프로젝트의 WHAT(구조) , WHY(목적) , HOW(작동 방식) 을 간결히 담아야 하며, 불필요한 명령어 과잉은 성능 저하로 이어짐
  • Claude는 시스템 메시지의 지시에 따라 CLAUDE.md의 내용을 관련성이 낮다고 판단하면 무시할 수 있음
  • 효과적인 파일은 짧고 보편적으로 적용 가능한 정보만 포함하고, 세부 지침은 별도 문서로 분리해 Progressive Disclosure 방식으로 관리해야 함
  • CLAUDE.md는 에이전트 하니스의 가장 높은 영향 지점이므로 자동 생성 대신 신중하게 수작업으로 작성해야 함

Hooks

  • Claude Code가 이제 훅(hooks)을 지원함 | GeekNews
  • Hooks - Anthropic
  • Claude Code에 사용자 정의 훅 기능이 도입. LLM의 선택에 의존하지 않고, 앱의 행동을 더욱 정확하고 반복적으로 제어할 수 있음
  • 알림 커스터마이징, 코드 자동 포맷팅, 명령 로그 추적과 같은 다양한 자동화가 가능
  • 명령어 실행 전/후, 알림 발생, 응답 완료 시점 등에서 동작하며, 설정 파일을 통해 프로젝트·사용자·엔터프라이즈 레벨로 관리할 수 있음
  • 설정 파일 구조와 매처(matcher) 방식을 통해, 특정 도구 호출 시점에 특정 훅만 실행할 수 있음
  • 입력은 JSON 포맷으로 전달되고, 출력은 exit code 또는 JSON으로 결과·피드백을 제어함
  • 훅은 셸 명령어를 사용자의 전체 권한으로 자동 실행하므로, 보안 및 안전에 대한 주의 필요함

훅 이벤트 개요

Claude Code는 워크플로우의 다양한 지점에서 실행되는 여러 훅 이벤트를 제공합니다:

  • PreToolUse - 도구 호출 전에 실행됩니다 (차단 가능).
  • PostToolUse - 도구 호출 완료 후 실행됩니다.
  • UserPromptSubmit - 사용자가 프롬프트를 제출할 때, Claude가 처리하기 전에 실행됩니다.
  • Notification - Claude Code가 알림을 보낼 때 실행됩니다.
  • Stop - Claude Code가 응답을 마칠 때 실행됩니다.
  • SubagentStop - 서브에이전트 작업이 완료될 때 실행됩니다.
  • PreCompact - Claude Code가 컴팩트 작업을 실행하려고 할 때 실행됩니다.
  • SessionStart - Claude Code가 새 세션을 시작하거나 기존 세션을 재개할 때 실행됩니다.
  • SessionEnd - Claude Code 세션이 종료될 때 실행됩니다.

서브에이전트

Claude Code에서 특화된 AI 서브에이전트를 생성하고 사용하여 작업별 워크플로우 및 개선된 컨텍스트 관리를 수행합니다.

Claude Code의 커스텀 서브에이전트는 특정 유형의 작업을 처리하기 위해 호출할 수 있는 특화된 AI 어시스턴트입니다. 이들은 커스터마이즈된 시스템 프롬프트, 도구 및 별도의 컨텍스트 윈도우를 제공하는 작업별 구성을 통해 더 효율적인 문제 해결을 가능하게 합니다. ​ 서브에이전트는 Claude Code가 작업을 위임할 수 있는 사전 구성된 AI 성격입니다. 각 서브에이전트는:

  • 특정 목적과 전문 분야를 가지고 있습니다
  • 주 대화와 분리된 자체 컨텍스트 윈도우를 사용합니다
  • 사용할 수 있는 특정 도구로 구성할 수 있습니다
  • 동작을 안내하는 커스텀 시스템 프롬프트를 포함합니다

Claude Code가 서브에이전트의 전문 분야와 일치하는 작업을 만나면, 그 작업을 특화된 서브에이전트에 위임할 수 있으며, 서브에이전트는 독립적으로 작동하고 결과를 반환합니다.

Skills

자세한 내용은 ClaudeCode:Skills 항목 참조.

헤드리스 모드

대화형 UI 없이 프로그래밍 방식으로 Claude Code 실행

Environment Variables

claude-code-router 또는 LiteLLM 같은 Proxy 를 사용한 후 환경변수 수정: 

export ANTHROPIC_BASE_URL="http://localhost:8080/v1" # 프록시 주소
export ANTHROPIC_AUTH_TOKEN="dummy-key" # 로컬이므로 아무 값이나 입력

작업공간 취소 방법

만약 /home/myname/Project 위치에 잘못해서 작업공간을 신뢰한다고 Yes 눌렀을 때 취소하고 싶다면 rm -rf ~/.claude/projects/-home-myname-Project/ 으로 제거하면 된다.

사용자 설정 파일 제거

다음 두 개의 파일 제거:

  • ~/.claude/
  • ~/.claude.json

Marketplace

Claude Code : 모범 사례

요약하면:

  • 자신의 실제 작업 환경과 워크플로우를 공개, 터미널에서 5개의 Claude를 병렬 실행하고 웹에서 5~10개를 추가로 운영하는 방식 소개
  • 모든 작업에 Opus 4.5 with thinking을 사용하며, 크고 느리지만 조정이 적게 필요하고 도구 활용 능력이 뛰어나 결과적으로 더 빠름
  • 팀 전체가 하나의 CLAUDE.md 파일을 공유하며, Claude가 잘못된 행동을 할 때마다 해당 내용을 추가해 학습 효과 축적
  • 대부분의 세션을 Plan 모드로 시작해 계획을 충분히 다듬은 후, auto-accept 모드로 전환해 한 번에 완성하는 패턴 활용
  • Claude가 스스로 작업을 검증할 수 있는 피드백 루프를 제공하는 것이 최종 결과물 품질을 2~3배 높이는 가장 중요한 요소

Claude Code에 Ultrathink 를 사용하면 더 똑똑해짐

Anthropic은 Claude 기반 CLI 에이전트 도구인 Claude Code의 고급 사용법을 문서로 공개함. 그리고 특정 키워드("think", "ultrathink" 등)를 사용하면 Claude가 더 많은 연산 자원(토큰) 을 사용해 더 깊은 사고를 진행함

  • "think" → 4,000 토큰, "megathink" → 10,000 토큰, "ultrathink" → 최대 31,999 토큰까지 할당됨
  • 이는 Claude Code 내부 코드에서 직접 확인되었으며, Claude 자체보다는 Claude Code의 기능으로 보임
  • 개발자는 이 기능을 이용해 복잡한 문제를 더 효과적으로 처리하도록 Claude를 에이전트형 코딩 도구로 활용 가능함

Claude Code의 모든 기능 활용법

  • Claude Code의 모든 기능 활용법 | GeekNews
  • Claude Code를 개인 프로젝트와 기업용 모노레포 환경에서 광범위하게 활용하며, 핵심 구성요소와 고급 기능의 실제 사용 방식을 정리
  • 효과적인 에이전트 운용의 핵심은 출력 스타일이나 UI가 아닌 최종 PR의 품질에 있으며, "설정 후 방치(shoot and forget)" 방식의 위임이 목표
  • 코드베이스의 중심은 CLAUDE.md 파일로, 에이전트의 행동 규칙과 도구 사용법을 정의하는 “헌법” 역할 수행
  • 컨텍스트 관리, 슬래시 명령어, 서브에이전트, Hooks, GitHub Action(GHA) 등 다양한 기능을 통해 협업과 자동화 수준 향상
  • Skills와 MCP(Model Context Protocol) 의 관계를 구분해, 스크립팅 중심의 유연한 에이전트 구조를 강조
  • Claude Code를 단순한 CLI 도구가 아닌 엔터프라이즈급 AI 개발 인프라로 확장할 수 있는 실질적 가이드 제공

Claude Code 창시자 Boris Cherny가 Claude Code를 사용하는 방법

병렬 실행 환경 구성

  • 터미널에서 5개의 Claude를 병렬 실행, 탭에 1~5 번호를 붙이고 시스템 알림 으로 입력이 필요한 시점 파악

웹과 로컬의 병렬 운영

  • claude.ai/code 웹에서도 5~10개의 Claude를 추가로 병렬 실행, 로컬 Claude와 함께 운영
  • 로컬 세션을 웹으로 핸드오프(& 사용)하거나, Chrome에서 직접 세션 시작, --teleport로 양방향 전환
  • iOS 앱에서 매일 아침과 하루 중 여러 세션을 시작하고 나중에 확인하는 방식도 활용

모델 선택: Opus 4.5 with thinking

  • 모든 작업에 Opus 4.5 with thinking 사용
  • 지금까지 사용한 최고의 코딩 모델
  • Sonnet보다 크고 느리지만, 조정(steering)이 적게 필요하고 도구 활용 능력이 뛰어남
  • 결과적으로 작은 모델보다 거의 항상 더 빠른 최종 결과 도출

CLAUDE.md를 통한 팀 단위 지식 축적

  • Claude Code 저장소에 팀 전체가 공유하는 단일 CLAUDE.md 파일 유지
  • git에 체크인하며, 팀 전체가 주 단위로 여러 번 기여
  • Claude가 잘못된 행동을 할 때마다 CLAUDE.md에 추가해 다음에 같은 실수 방지
  • 다른 팀들도 각자의 CLAUDE.md를 유지하며, 각 팀이 최신 상태 유지 책임

코드 리뷰 시 CLAUDE.md 업데이트

  • 코드 리뷰 시 동료 PR에 @.claude를 태그해 PR의 일부로 CLAUDE.md에 내용 추가
  • Claude Code GitHub Action(/install-github-action) 활용
  • Dan Shipper의 Compounding Engineering 개념과 유사한 방식

Plan 모드와 자동 수락 워크플로우

  • 대부분의 세션을 Plan 모드(shift+tab 두 번)로 시작
  • PR 작성이 목표일 경우 Plan 모드에서 Claude와 계획이 만족스러워질 때까지 반복 협의
  • 계획 확정 후 auto-accept edits 모드로 전환하면 Claude가 보통 한 번에(1-shot) 완성
  • 좋은 계획이 정말 중요함

슬래시 커맨드를 통한 반복 작업 자동화

  • 하루에 여러 번 수행하는 "inner loop" 워크플로우마다 슬래시 커맨드 사용
  • 반복 프롬프팅 절약, Claude도 이 워크플로우 활용 가능
  • 커맨드는 git에 체크인되며 .claude/commands디렉토리에 저장
  • 예: /commit-push-pr 슬래시 커맨드를 매일 수십 번 사용
    • 인라인 bash로 git status 등 정보를 미리 계산해 빠른 실행과 모델과의 불필요한 왕복 방지

서브에이전트 활용

  • 여러 서브에이전트 를 정기적으로 사용
    • code-simplifier: Claude 작업 완료 후 코드 단순화
    • verify-app: Claude Code 엔드투엔드 테스트를 위한 상세 지침 포함
  • 슬래시 커맨드와 유사하게, 대부분의 PR에서 수행하는 가장 일반적인 워크플로우 자동화 개념

PostToolUse 훅을 통한 코드 포매팅

  • PostToolUse 훅을 사용해 Claude의 코드 포매팅 처리
  • Claude는 기본적으로 잘 포매팅된 코드를 생성하며, 훅이 나머지 10%를 처리해 나중에 CI에서 포매팅 오류 방지

권한 관리 방식

  • --dangerously-skip-permissions 사용하지 않음
  • 대신 /permissions를 사용해 환경에서 안전하다고 알려진 일반적인 bash 명령을 사전 허용
  • 불필요한 권한 프롬프트 회피
  • 대부분 .claude/settings.json에 체크인되어 팀과 공유

Claude Code의 도구 통합 활용

  • Claude Code가 모든 도구를 대신 사용
    • Slack 검색 및 게시 (MCP 서버 활용)
    • BigQuery 쿼리 실행 (bq CLI)으로 분석 질문 답변
    • Sentry에서 에러 로그 가져오기
  • Slack MCP 설정은 .mcp.json에 체크인되어 팀과 공유

장시간 작업 처리 방식

  • 매우 긴 작업의 경우 세 가지 방법 중 선택:
    • (a) 완료 시 백그라운드 에이전트로 작업 검증하도록 프롬프트
    • (b) 에이전트 Stop 훅 을 사용해 더 결정론적으로 검증
    • (c) Geoffrey Huntley가 고안한 ralph-wiggum 플러그인 사용
  • 샌드박스에서 --permission-mode=dontAsk 또는 --dangerously-skip-permissions 사용해 권한 프롬프트 없이 Claude가 작업에 집중하도록 설정

가장 중요한 팁: 검증 피드백 루프 제공

  • Claude Code에서 훌륭한 결과를 얻기 위한 가장 중요한 요소: Claude에게 작업을 검증할 방법 제공
  • 이 피드백 루프가 있으면 최종 결과물 품질이 2~3배 향상
  • Claude가 claude.ai/code에 랜딩하는 모든 변경 사항을 Claude Chrome 확장 프로그램 으로 테스트
    • 브라우저를 열고 UI를 테스트하며, 코드가 작동하고 UX가 좋을 때까지 반복
  • 검증 방식은 도메인마다 다름
    • bash 명령 실행처럼 단순할 수도 있고
    • 테스트 스위트 실행
    • 브라우저나 폰 시뮬레이터에서 앱 테스트
  • 이 검증 과정을 견고하게 구축하는 데 투자가 필요함

Claude Code 창시자가 공개한 실전 사용 팁

병렬 작업을 최대한 활용

  • 3~5개의 git worktree를 동시에 실행하고 각각 별도의 Claude 세션을 병렬로 운영하는 것이 클로드 코드 팀 내부에서 최고의 생산성 향상 팁
  • 일부는 git checkout 방식을 선호하지만, 대부분의 Claude Code 팀원은 worktree 선호
    • 이로 인해 Claude Desktop 앱에 네이티브 worktree 지원 기능이 추가됨
  • worktree에 이름을 붙이고 shell alias(za, zb, zc)를 설정해 한 번의 키 입력으로 전환하는 방식도 활용
  • 로그 확인과 BigQuery 실행 전용 "analysis" worktree를 별도로 운영하는 팀원도 있음

복잡한 작업은 항상 Plan Mode로 시작

  • 복잡한 작업은 plan 모드로 시작하고, 계획 수립에 에너지를 쏟아 Claude가 한 번에 구현을 완료하도록 유도
  • 하나의 Claude가 계획을 작성하면, 두 번째 Claude를 띄워 스태프 엔지니어 역할로 검토시키는 방식도 사용
  • 작업이 잘못되는 순간 즉시 plan 모드로 돌아가 재계획하는 것이 중요하며, 무리하게 밀어붙이지 말 것
  • 검증 단계에서도 명시적으로 plan 모드 진입을 지시하는 것이 효과적

CLAUDE.md에 지속적으로 투자

  • 매번 수정할 때마다 "CLAUDE.md를 업데이트해서 같은 실수를 반복하지 않도록 해라"라고 지시
  • Claude는 스스로 지켜야 할 규칙을 매우 잘 문서화하는 특성이 있음
  • 시간이 지나며 CLAUDE.md를 지속적으로 수정하고, Claude의 실수율이 측정 가능하게 줄어들 때까지 반복
  • 한 엔지니어는 모든 작업/프로젝트에 대해 notes 디렉토리를 유지하고 PR마다 업데이트하도록 Claude에 지시, CLAUDE.md가 이를 참조하도록 설정

자체 Skill을 만들고 git에 커밋

클로드 코드 팀의 팁:

  • 하루에 한 번 이상 반복하는 작업은 Skill 또는 Slash Command로 만들기
  • /techdebt 슬래시 커맨드를 만들어 세션 종료 시 중복 코드를 찾아 제거
  • 7일치 Slack, GDrive, Asana, GitHub를 하나의 컨텍스트 덤프로 동기화하는 슬래시 커맨드 셋업
  • analytics-engineer 스타일 에이전트를 만들어 dbt 모델 작성, 코드 리뷰, dev 환경 테스트 수행
  • 더 알아보기 Extend Claude with skills

버그 수정은 Claude에게 맡김

  • Slack MCP를 활성화하고 Slack 버그 스레드를 Claude에 붙여넣은 뒤 "fix"라고만 입력하면 컨텍스트 전환 없이 수정 가능
  • 또는 "Go fix the failing CI tests"라고만 지시하고 방법은 Claude에게 맡길 것
  • docker logs를 Claude에 전달해 분산 시스템 트러블슈팅에 활용 — 놀라울 정도로 유능함

프롬프트 수준 끌어올리기

  • "이 변경사항을 엄격히 검토하고, 내가 테스트를 통과할 때까지 PR 만들지 마"라고 지시해 Claude를 리뷰어로 활용
  • "이게 작동한다는 걸 증명해봐"라고 하며 main 브랜치와 feature 브랜치 간 동작 차이를 diff하도록 요청
  • 평균적인 수정 결과가 나오면 "지금까지 알게 된 모든 것을 바탕으로 이걸 버리고 우아한 솔루션을 구현해"라고 지시
  • 작업 전달 전 상세한 스펙 작성과 모호함 제거가 출력 품질 향상의 핵심

터미널과 환경 설정

  • 클로드 코드 팀에서는 Ghostty 터미널 선호
    • 동기화 렌더링, 24비트 컬러, 적절한 유니코드 지원이 장점
  • /statusline으로 상태바를 커스터마이징해 컨텍스트 사용량과 현재 git 브랜치 항상 표시
  • 터미널 탭에 색상 코드와 이름을 붙이고 tmux 사용 — 작업/worktree당 하나의 탭
  • 음성 받아쓰기 활용 권장
    • 타이핑보다 3배 빠르게 말할 수 있고, 프롬프트가 훨씬 상세해짐
    • macOS에서 fn 키 두 번 누르기로 활성화
  • 추가 팁 : Optimize your terminal setup

서브에이전트 활용

  • Claude가 더 많은 연산을 투입하길 원하면 요청에 "use subagents"를 추가
  • 개별 작업을 서브에이전트에 위임해 메인 에이전트의 컨텍스트 윈도우를 깔끔하고 집중된 상태로 유지
  • 권한 요청을 Opus 4.5로 라우팅하는 hook 설정 — 공격 스캔 후 안전한 요청은 자동 승인

데이터·분석 작업에 Claude 활용

  • Claude Code에 "bq" CLI를 사용해 즉석에서 메트릭을 가져오고 분석하도록 요청
  • 코드베이스에 BigQuery skill을 체크인해두고 팀 전체가 Claude Code에서 직접 분석 쿼리 실행
  • 6개월 이상 SQL을 직접 작성하지 않았음
  • CLI, MCP, API가 있는 모든 데이터베이스에 동일하게 적용 가능

Claude를 활용한 학습

  • /config에서 "Explanatory" 또는 "Learning" 출력 스타일을 활성화하면 Claude가 변경 사항의 이유(why) 를 설명
  • 익숙하지 않은 코드를 설명하는 시각적 HTML 프레젠테이션 생성 요청 — 놀라울 정도로 좋은 슬라이드를 제작함
  • 새로운 프로토콜과 코드베이스 이해를 위해 ASCII 다이어그램으로 그리도록 요청
  • 간격 반복 학습(spaced-repetition) skill 구축
    • 사용자가 이해한 내용을 설명하면 Claude가 빈틈을 채우는 추가 질문을 하고 그 결과를 저장

Claude Code를 최고의 설계 파트너로 만들기

Prompt engineering#Claude Code를 최고의 설계 파트너로 만들기

Claude Code 완전 가이드: 해커톤 우승자의 70가지 파워 팁

각 팁마다 실제로 사용할 수 있는 명령어, 스크립트, 설정 파일을 제공

  1. 에이전틱 개발자의 사고방식
    1. 큰 문제 정복의 첫걸음: 분해하고 정복하라 (ykdojo #3)
    2. 계획 모드 vs. 욜로 모드 (Ado #18, #19)
    3. 컨텍스트: AI의 기억력을 지배하는 기술 (ykdojo #5, #8, Ado #15)
    4. 올바른 추상화 수준 선택 (ykdojo #32)
    5. 미지의 영역에서 더 용감하게 (ykdojo #35)
  2. 기초부터 탄탄하게 - 환경 설정과 필수 명령어
    1. 커스텀 상태 라인으로 모든 것을 한눈에 (ykdojo #0)
    2. 필수 슬래시 명령어 마스터 (ykdojo #1, Ado #4, #16, #17)
    3. CLAUDE.md: AI를 위한 프로젝트 설명서 (Ado #1, #2, ykdojo #30)
    4. 터미널 별칭으로 빠른 접근 (ykdojo #7)
    5. 세션 관리: 대화를 잃지 않는 법 (Ado #9, #10, #11, #12)
  3. 생산성을 극대화하는 핵심 기술
    1. 음성으로 코딩하기 (ykdojo #2)
    2. 터미널 출력 추출의 기술 (ykdojo #6)
    3. Cmd+A/Ctrl+A: 전체 선택의 힘 (ykdojo #10)
    4. 마크다운과 Notion 활용 (ykdojo #19, #20)
    5. 키보드 단축키 완전 정복 (Ado #5, #6, #7, #8, ykdojo #38)
    6. Vim 모드로 프롬프트 편집 (Ado #13)
    7. 입력 박스 탐색 및 편집 (ykdojo #38)
  4. 컨텍스트 관리의 예술
    1. 선제적 컨텍스트 압축 (ykdojo #8)
    2. 터미널 탭으로 멀티태스킹 (ykdojo #14)
    3. 대화 복제 및 반복제 (ykdojo #23)
    4. /context로 X-Ray 비전 (Ado #15)
    5. realpath로 절대 경로 얻기 (ykdojo #24)
  5. Git과 GitHub 워크플로우 완전 정복
    1. Git과 GitHub CLI 프로 활용 (ykdojo #4)
    2. Git worktrees로 병렬 브랜치 작업 (ykdojo #16)
    3. 대화형 PR 리뷰 (ykdojo #26)
    4. 승인된 명령어 감사 (ykdojo #33)
  6. 고급 기능 - MCP, Hooks, Agents
    1. MCP: 외부 세계와의 연결 (Ado #22, #23, #24, #25)
    2. Hooks: 규칙의 강제 (Ado #26)
    3. Skills: 재사용 가능한 지식 (Ado #27)
    4. Agents: 전문화된 서브에이전트 (Ado #28)
    5. Plugins: 기능 번들 (Ado #29)
    6. CLAUDE.md vs Skills vs Slash Commands vs Plugins (ykdojo #25)
  7. 시스템 최적화와 자동화
    1. 시스템 프롬프트 슬림화 (ykdojo #15)
    2. 장시간 작업을 위한 수동 지수 백오프 (ykdojo #17)
    3. 백그라운드에서 bash 명령 및 에이전트 실행 (ykdojo #36)
    4. 자동화의 자동화 (ykdojo #41)
    5. Headless 모드로 CI/CD 통합 (Ado #30)
  8. 컨테이너와 샌드박스
    1. 컨테이너로 위험한 작업 격리 (ykdojo #21)
    2. Sandbox 모드와 권한 관리 (Ado #20)
    3. YOLO 모드: 위험을 감수할 때 (Ado #20)
  9. 브라우저 통합과 웹 자동화
    1. 네이티브 브라우저 통합 (Ado #21)
    2. Playwright MCP (Ado #22)
    3. Gemini CLI를 대체 수단으로 (ykdojo #11)
  10. 실전 활용 사례
    1. 작성-테스트 사이클 완성 (ykdojo #9)
    2. 자신만의 워크플로우에 투자 (ykdojo #12)
    3. 대화 기록 검색 (ykdojo #13)
    4. 글쓰기 도우미로 활용 (ykdojo #18)
    5. 연구 도구로 활용 (ykdojo #27)
    6. 출력 검증 방법 마스터 (ykdojo #28)
    7. DevOps 엔지니어로 활용 (ykdojo #29)
    8. 범용 인터페이스로 활용 (ykdojo #31)
    9. 테스트 많이 작성 (TDD) (ykdojo #34)
    10. 복잡한 코드 단순화 (ykdojo #40)
  11. 고급 패턴과 철학
    1. 계획과 빠른 프로토타이핑의 균형 (ykdojo #39)
    2. 개인화된 소프트웨어 시대 (ykdojo #37)
    3. 사용이 최고의 학습 (ykdojo #22)
    4. 지식 공유 및 기여 (ykdojo #42)
    5. 계속 학습하기 (ykdojo #43)
  12. 고급 기능과 SDK
    1. Extended Thinking (Ado #19)
    2. LSP 통합 (Ado #31)
    3. Claude Agent SDK (Ado #31)
    4. 팀 설정과 공유 워크플로우 (Ado #30)
  13. 학습 로드맵과 다음 단계
    1. 초급자를 위한 로드맵 (1-3개월)
    2. 중급자를 위한 로드맵 (3-12개월)
    3. 고급자를 위한 로드맵 (1년 이상)
    4. 필독 참고 자료

Andrej Karpathy가 지적한 LLM 코딩 문제점을 해결하려는 단 65줄짜리 Markdown 파일

Andrej Karpathy가 지적한 LLM 코딩 문제점을 해결하려는 단 65줄짜리 Markdown 파일(CLAUDE.md) 이 GitHub에서 폭발적 인기를 끌며, Claude Code 사용자들 사이에서 “이 파일 하나만 넣으면 AI가 훨씬 똑똑해진다”는 센세이션을 일으킴.

파일 내용: 4가지 핵심 원칙 (Karpathy의 LLM 코딩 비판에서 영감)

  • Think Before Coding (코드 타이핑 전에 생각부터): 가정 명시, 불확실하면 질문, 혼란 시 멈춤
  • Simplicity First (단순하게 먼저): 요청 안 한 기능·추상화·에러 처리 추가 금지
  • Surgical Changes (수술처럼 정밀하게): 요청된 부분만 바꾸고 나머지 건드리지 않기
  • Goal-Driven Execution (목표 중심 실행): “기능 추가” 대신 “테스트 통과시키기”처럼 구체적 목표로 변환

이 원칙들을 프롬프트로 주입하면 Claude가 과도한 창의성·엉뚱한 가정·불필요한 리팩토링을 덜 하고, 더 안정적·예측 가능한 코드를 작성한다는 사용자 경험담이 쏟아짐. 

# CLAUDE.md

Behavioral guidelines to reduce common LLM coding mistakes. Merge with project-specific instructions as needed.

**Tradeoff:** These guidelines bias toward caution over speed. For trivial tasks, use judgment.

## 1. Think Before Coding

**Don't assume. Don't hide confusion. Surface tradeoffs.**

Before implementing:
- State your assumptions explicitly. If uncertain, ask.
- If multiple interpretations exist, present them - don't pick silently.
- If a simpler approach exists, say so. Push back when warranted.
- If something is unclear, stop. Name what's confusing. Ask.

## 2. Simplicity First

**Minimum code that solves the problem. Nothing speculative.**

- No features beyond what was asked.
- No abstractions for single-use code.
- No "flexibility" or "configurability" that wasn't requested.
- No error handling for impossible scenarios.
- If you write 200 lines and it could be 50, rewrite it.

Ask yourself: "Would a senior engineer say this is overcomplicated?" If yes, simplify.

## 3. Surgical Changes

**Touch only what you must. Clean up only your own mess.**

When editing existing code:
- Don't "improve" adjacent code, comments, or formatting.
- Don't refactor things that aren't broken.
- Match existing style, even if you'd do it differently.
- If you notice unrelated dead code, mention it - don't delete it.

When your changes create orphans:
- Remove imports/variables/functions that YOUR changes made unused.
- Don't remove pre-existing dead code unless asked.

The test: Every changed line should trace directly to the user's request.

## 4. Goal-Driven Execution

**Define success criteria. Loop until verified.**

Transform tasks into verifiable goals:
- "Add validation" → "Write tests for invalid inputs, then make them pass"
- "Fix the bug" → "Write a test that reproduces it, then make it pass"
- "Refactor X" → "Ensure tests pass before and after"

For multi-step tasks, state a brief plan:
1. [Step] → verify: [check] 2. [Step] → verify: [check] 3. [Step] → verify: [check] 
Strong success criteria let you loop independently. Weak criteria ("make it work") require constant clarification.

---

**These guidelines are working if:** fewer unnecessary changes in diffs, fewer rewrites due to overcomplication, and clarifying questions come before implementation rather than after mistakes.

Troubleshooting

Neovim 플러그인에서 jobstart 호출시 실행이 안되는 문제

'pty': v:true 옵션을 추가해야 한다.

See also

  • Claude
  • Vibe Coding
  • Claude Squad - 멀티 AI 코드 에이전트 터미널 워크스페이스 관리 툴
  • Claude Code Router - Claude Code 요청을 다양한 모델로 라우팅하는 오픈소스
  • Omnara - 어디서든 Claude Code 실행하기
  • Claudia - Claude Code를 위한 데스크탑 동반자
  • opcode - Claude Code를 위한 강력한 GUI 앱 & 툴킷
  • GitHub Copilot CLI
  • Claude Code Action - GitHub PR과 이슈에서 코드 질의응답과 수정 자동화를 지원하는 범용 액션
  • Continuous Claude - 클로드 코드를 반복 실행해 PR 생성·체크·머지까지 자동화하는 워크플로 도구
  • claude-code-router
  • LiteLLM - Python SDK, Proxy Server (AI Gateway) to call 100+ LLM APIs
  • Open Code - 터미널을 위한 AI 코딩 에이전트
  • claude-mem - Claude Code 세션 간 컨텍스트 유지용 메모리 압축 시스템
  • Claudable - 로컬 CLI 에이전트를 활용한 오픈소스 웹 빌더
  • Claude Chill - 터미널에서 Claude Code의 깜빡임 현상 수정하기
  • OpenWork - OpenCode 기반의 Claude Cowork 대체제
  • Clopus-watcher - Claude Code 형태의 자율 24/7 온콜 엔지니어 - Kubernetes 환경의 장애 대응 자동화를 목표로 한 AI 기반 감시 도구
  • Fluid - 인프라를 위한 Claude Code
  • ccusage - Claude Code/Codex 사용량 분석용 CLI 도구
  • Cloudrouter - Claude Code/Codex가 클라우드 VM·GPU를 띄우게 만드는 스킬

Favorite site

Articles

References

  1. Claude_Code_Complete_Guide_-_70_Power_Tips_from_a_Hackathon_Worker.pdf ↩