원래 제목: Karpathy's CLAUDE.md hit #1 에 GitHub 와 82,000 별.

Dep의 사진

편집기 프레스: 많은 사람들이 Claude 코드를 사용할 때, 가장 큰 문제는 모델이 충분하지 않다, 그러나 그들은 스크래치에서 시작합니다。

프로젝트 배경, 기술 vault, 코드 사양에 대해 반복적으로 알려야 할 필요가 있습니다. 이 정보로 인해 고정되지 않습니다. Claude는 현재 프로젝트에 적합하지 않은 재설계 및 권장 도구가 필요하지 않은 재설계 코드를 변경할 수 있습니다。

여기에 발표 된 CLUDE.md는 Claude Code의 설명서입니다. 당신이해야 할 모든 것은 루트 디렉토리에 넣어, Claude는 자동으로 시작합니다. 그것은 Claude에게 대답하는 방법을 미리 말할 수 있습니다, 코드를 작성하는 방법, 먼저 요청할 때, 어떤 작업은 허가없이 실행할 수 없습니다, 어떤 기술은 프로젝트에서 사용되며, 중요한 결정은 과거에 이루어집니다。

간단히 CLAUDE.md의 역할은 반복적인 해석, 경계를 가로지르는 한계 모델을 줄이고 AI 프로그래밍을 더욱 안정적이고 관리할 수 있습니다。

Claude Code를 사용하는 경우 Karpathy에 의해 요약 된 4 규칙과 함께 시작할 수 있습니다. 먼저, 가장 간단한 솔루션으로, 불확실한 코드를 터치하지 마십시오. 불확실성을 지정하십시오. CLAUDE.md에서 이러한 항목의 포함과 그들의 자신의 프로젝트에 대한 그들의 영광은 크게 그들의 사용 경험을 개선합니다。

다음은 원본 텍스트입니다:

CLAUDE.md라는 문서는 GitHub Trending의 상단에 있습니다。

8.2 백만 별, 7,800 포크。

Andrej Karpathy에서 시작되었습니다. 그는 Tesla AI의 이사였으며 OpenAI의 창립 멤버 중 하나입니다. 그는 Claude Code를 유효하지 않은 4 종류의 행동을 요약하고 문서에 넣어。

나중에 개발자는 4 가지 규칙을 확장하고 공개적으로 문서를 공개했습니다. 빨간 갔다。

이 이유는 직접: 코드 정확도 비율은 65%에서 94%에 상승했습니다。

그러나 매일 Claude Code를 사용하는 대부분의 개발자는 실제로이 작업을 수행하지 않았습니다. 각 세션은 스크래치에서 시작되었습니다. 동일한 컨텍스트가 다시 설명되었습니다. 불필요한 범위 변경이 정리되었고, 비활성 재구성의 재시작은 뒤로 압연되었습니다。

완전한 문서는 다음과 같습니다。

대부분의 개발자에 의해 놓인 설정

Claude Code를 열 때마다 기본값이 없습니다。

그것은 당신의 기술을 알고 있지 않습니다, 그것은 당신의 코드 코드를 모르는, 그것은 당신의 프로젝트 배경을 모른다, 그것은 당신이 시도한 것을 알고 있지 않습니다, 그리고 그것은 당신이 명확하게 3 세션의 앞에 할 것을 결정하지 않는 것을 모른다。

그래서 그것은 단지 추측 할 수 있습니다. 그리고 일단 추측하기 시작합니다, 그것은 당신이 이동할 것을 요구하지 않은 코드를 다시 만들 수 있습니다, 그리고 권고는 기존 아키텍처의 프레임 워크를 언젠가, 확인없이 문서를 제거, 또는 당신이 일찍 찍은 결정을 반전。

CLUDE.md는 루트 디렉토리에 배치 된 일반 텍스트 파일입니다. Claude Code는 각 세션의 시작 부분에 자동으로 읽습니다。

한 번 설정은 반복적으로 설명하고 비용이 많이 드는 세 가지 유형의 오류를 복구 할 필요가 없습니다。

기본 설정 : 일주일에 $ 375을 지출, 그냥 자신을 반복

Ordinary 개발자는 Claude에 대해 하루 30 분 걸립니다。

기술 vault, 코드 코드, 프로젝트 배경, 당신이 시도 한 방법 -- 일단이 정보를 작성하지 않고 Claude는 자동으로 읽고, 그들은 세션 사이에 유지하지 않습니다。

개발자 's hourly salary of $150에 계산하는 경우:

• 하루 30 분, 75 달러

• 주당 $375。

• 5의 팀이 있다면 주당 $ 875입니다。

다음 규칙 7은 CLAUDE.md 문서의 상단에 배치해야합니다。

오, 륙

대답은 "좋은 질문"또는 "문제"또는 매트리스의 종류로 시작되지 않습니다. 그냥 대답을 제공합니다. 식히지 말고 질문을 반복하지 마십시오。

→ 작업에 따라 응답의 길이

응답의 길이는 작업의 복잡성을 일치해야합니다. 간단한 질문은 직접 응답하고, 간략하게; 복잡한 위임은 가득 차있는 상세한 묘사를 줍니다. 질문이나 결론의 반복으로 공간을 채우지 마십시오。

• 작업 전

중요한 작업을 시작하기 전에 2-3 viable 경로를주고 선택할 때까지 계속하십시오。

~ 불확실한 원인 전, 불확실한 인정. ~

어떤 사실, 데이터, 날짜 또는 기술 정보에 대해 불확실한 경우, 견적하기 전에 지정하십시오. 겉으로 합리적인 정보를 가진 지식 격차를 채우지 마십시오. 당신이 할 수없는 경우, 그냥 당신이 확실하지 않습니다。

나는 누구인가? 나는 무엇을 알고 있습니까

나를 위해: [이름] / 역할: [당신의 역할] / 배경: [area]。

나는 이것에 좋습니다:。

나는 여전히 학습이다 : [knowledge gap]。

이 정보에 각 응답의 깊이를 조정하십시오. 이미 알고있는 것을 설명하지 마십시오. 배경을 건너뛰지 마십시오。

현재 프로젝트 Context

I am doing: [프로젝트 이름] / Objective: [Specific results] / Audience: [who will use] / 기술 창고 배경: [relevant constraints] / 피해야: [list]。

각 작업에 이러한 상황에 적용하십시오. 요구 사항이 컨텍스트에 일치하지 않으면, 구현하기 전에 나타냅니다。

♪ 당신의 표현을 잠금 ♪

내 쓰기 스타일은: [당신의 표현의 설명]。

문장 길이: [preference]。

단어를 사용한다: [예수]。

단어를 사용하지 않을 것: [예금]。

체재: [Spoken 또는 Structured]。

당신이 내 대신에 아무것도 쓸 때, 당신은 엄격하게 스타일과 기본으로 자신의 표현을 사용하지 않는。

반복 상황에 시간: 30 분

개발자 기반 ' s 시간당 급여 $150 : $75 / 일

주간: 개발자 당 $375

5인 팀: 주 당 $1875

CLUDE.md 설정: 총 45분

오류는 피할 필요가있다 : 스크래치에서 CLAUDE.md를 작성하지 마십시오. 이 프로그램을 먼저 사용, 다음 출력을 편집:

나 자신에 대해 이야기하는 것을 기반으로, 내 프로젝트, 그리고 내가 일하고 싶은 방법, 나에게 완전한 CLUDE.md를 작성하십시오. 이것은 내가, 내 기술 배경, 내 통신 환경, 그리고 각 세션이 따르는 기본 동작을 포함한다. 특정, 일반 텍스트, 500 단어가 필요합니다。

Behavior 구속 : 당신이 승인하지 않은 변경, $ 150 시간

Claude 함수를 수정할 수 있습니다。

결과적으로, 그것은 세 개의 문서를 재생, 변수를 변경, 재구성 된 보고서, 그리고 당신이 쓰기에 시간을 가지고 메모를 rewritten。

그리고 이것의 아무도는 당신에 의해 확인되었습니다。

그것은 시간, 또는 $ 150, 검토 및이 불필요한 변경 사항을 다시 롤 할 수 있습니다. 일주일에 3 번, 그 $ 450입니다. 5팀의 경우, 일주일에 2250 달러의 비용이 절감됩니다。

다음 규칙 7은 CLAUDE.md의 행동의 바인딩 부분에서 삽입됩니다。

엄격한 통제

현재 작업과 관련된 파일, 기능 및 코드 라인 만 변경합니다. 수정, 이름, 개편, 개편, 또는 "optimize" 내가 명시적으로 변경할 것을 요구하지 않습니다。

수리의 다른 장소를 찾을 경우, 마지막 메모를 사용하십시오. 결코 이동하지 마십시오。

자주 묻는 질문

내가 창조한 것에 중요한 변화를 만들기 전에, 장을, 삭제하는 단락, 구조, 변화 음색, 등을 포함하여, 그것은 당신이 변화하고 이유를 정확하게 멈출 것이 중요합니다. 나는 확신 할 때까지 계속됩니다。

~ 어떤 파괴적인 가동은 전에 확인되어야 합니다

모든 문서가 제거되기 전에 기존의 코드가 덮여, 데이터베이스 레코드가 제거되거나 재 신뢰가 제거되고, 특히 영향을받는 것을 나열하고 명확한 확인을 요청하는 것이 필요합니다. 현재 뉴스에서 예를 말하면 계속 할 수 있습니다。

"이전에 언급 된 것"은 확인되지 않습니다。

생산 환경 가동은 중단되어야 합니다

다음은 예외없이 현재 세션에서 명확하게 확인되어야합니다

:: 어떤 환경에 배포 또는 전송

데이터베이스 구조의 운영 마이그레이션 또는 변경

외부 API 호출을 보내십시오

다른 부작용을 가진 어떤 순서를 실행하십시오。

나는 현재 뉴스에서 "예"라고 말해야합니다。

♪ 항상 어떤 변경을 보여주는 ♪

코딩 작업을 완료하면 끝은 다음과 같습니다

문서 수정: 모든 문서를 이동

개정: 각 문서는 한 문장에서 설명됩니다

문서 의도적으로 unmodified

자주 묻는 질문。

바카라사이트 }Don't act 에 나의 대신 없이 명확한 확인

현재 메시지의 명시적 확인 없이, 공개, 공유 또는 배치할 수 없습니다. 메일, 캘린더 초대, 문서 공유, 또는 현재 대화 밖에 발생하는 모든 작업을 포함합니다. 나는 현재 뉴스에서 분명히 말해야。

글쎄, 코드를 작성하기 전에 생각

구조화 의사 결정, 복잡한 문제를 디버깅, 또는 비 간단한 기능 개발, 한 번에 한 단계, 다음 코드 쓰기. 당신의 소원을 표시하고, 불확실함을 지적하고, 그 후 그들을 구현합니다。

주간 롤백의 필수 범위 변경 : $ 150

수동 diff 주간 검사: $75

개발자 당 낭비적인 행동: 225 / 주

5인 팀: $1125/주

CLUDE.md 행동 부분 시간: 30 분

기억과 기술 창고: Claude 부호를 진짜로 믿을 수 있는 체제 만드십시오

Claude는 세션 사이에 모든 것을 잊을 것입니다。

당신이 만든 모든 결정, 당신이 실패한 모든 공식, 왜 당신은 드리즐 대신 Prisma 6 개월 전에 선택, 그리고 왜 특정 클라이언트의 필요에서 어떤 제약이 온다 — 그것은 잊어 버린。

그리고 그런 다음 이미 규칙을 재발행할 수 있습니다。

이 부분은 현재 "실제 기억"에 가장 가까운 메커니즘과 Claude를 제공하는 것과 동일하며 기술 볼트를 잠그면서 기존 구조에 걸친 도구를 권장하기 위해 계속 노력합니다。

→EMORY.md 결정 통

프로젝트에서 MEMORY.md라는 파일을 유지합니다. 중요한 결정이 이루어지는 때마다 새로운 기록이 추가됩니다

무엇을 결정

• 왜 이렇게

• 무엇을 제외, 왜。

각 세션의 시작 부분에 Memory.md를 읽으십시오. 기록 된 결정과 충돌이 경고없이 허용되지 않습니다。

세션 요약

"session end" "wrapping up"또는 "let's stop here"라고 말하면 다음과 같은 Memory.md에 세션 요약을 작성하십시오

• 이 시간에 거래 된 것은 무엇입니까

• 수행 된 것은 무엇입니까

아직도 갈거야

촬영

:: 다음 세션의 우선 순위。

→ERRORS.md 실패 로그

ERRORS.md라는 파일을 유지합니다. 프로그램이 실패하지 않도록 두 번 이상 시도 할 때, 그것은 기록된다:

• 작동하지 않는

• 무슨 마지막 일

• 다음 시간에주의해야 할 사항。

ERRORS.md 를 체크하여 유사한 작업을 위한 프로젝션 프로그램。

• 사실의 영구 목록

다음 사실은이 프로젝트에 유효하며 예외없이 각 세션에 적용해야합니다

[당신의 영원한 제약, 구조 결정 및 규칙]

이러한 사실과 특정 위임이 있다면, 구현하기 전에 알려주십시오。

♪ 기술 결함을 잠금 ♪

프로젝트 's 기술 창고는 다음과 같습니다. 도구는 지속적으로 사용됩니다. 명시적으로 요청하지 않고, 대안이 권장되지 않습니다 :

언어: [e.g. TypeScript]

프레임: [e.g. Next.js 14]

패키지 관리자 : [e.g. pnpm]

데이터베이스: [e.g. Prisma와 PostgreSQL]

테스트: [e.g. Vital]

스타일: [e.g. Taylor CSS]

도구가 적합하지 않다면, 그것은 밖으로 지적 할 수 있습니다. 그러나 나는 그것을 명확하게하지 않는 한, 정의 된 기술 창고 사용해야합니다。

~ Hard decision-making 방아쇠 확장 생각

시스템 아키텍처, 성능 거래 오프, 데이터베이스 디자인, 또는 장기 기술 결정과 관련된 문제에 대한 확장 된 사고 모델을 사용합니다。

문제의 단계별 분석, 내가 계정으로 찍을 수없는 거래 오프와 함께, 크기 증가의 이벤트에서 유효 할 수없는 가정과, 당신의 조언을 줄 것입니다。

음, 그 4 빨간 규칙입니다

Karpathy는 Claude Code가 실패 할 수있는 4 가지 행동을 요약했습니다. 한 개발자는 아래 규칙의 4 줄로 세련되었습니다. 인코딩된 정확도 비율은 65%에서 94%로 갔다。

첫째, 가정하지 마십시오。
불확실한 경우, 첫 번째 줄을 쓰기 전에 물어보십시오. 의도, 구조 또는 필요에 대한 침묵 가정을하지 마십시오。

첫째, 가장 간단합니다。
일하는 가장 간단한 방법은 항상 달성됩니다. 명시적으로 요구되지 않은 초기 층 또는 flexibilities를 추가하지 마십시오。

해당 코드를 터치하지 마십시오。
현재 작업과 관련된 문서 또는 기능을 수정하지 마십시오. 최적화 할 수 있다고 생각하면 이동하지 마십시오。

불확실함을 명확하게 식별합니다。
특정 프로그램 또는 기술 정보에 대해 확실하지 않은 경우, 진행하기 전에 알려주십시오. 특정의 부족하지만 자신감의 표현은 지식 격차의 인식보다 더 손상됩니다。

주당 복구 비용 forgotten decisions 및 erroneous 권고: $300 개발자 당

실수 기술 유도 및 호환 도구 : 주당 $ 75

개발자 당 기억의 낭비: $375 / 주

• 5인 팀: $1875/week

• MAMORY.md + ERRORS.md + 기술적인 겹쳐 쌓이는 시간: 20 분

결론

완전한 비용 계정은 다음과 같습니다:

:: 주간 상황 반복: $375

:: 권한 없는 주간 롤백: $225

:: 주당 잊혀진 결정에서 발생하는 문제 해결: $375

주 당 개발자 당 총 낭비: $975。

5명의 사람 발달 팀이 있는 경우에: 주 당 $4875. 연간 $ 253,500。

그리고 CLUDE.md 설정은 총 2 시간。

Karpathy의 4 가지 규칙은 65 %에서 94%까지 인코딩 된 정확도를 증가시킵니다。

일반 텍스트 문서, 21 규칙, 작업의 2 시간。

이 설정 작업을 완료하는 개발자는 실제로 더 신뢰할 수있는 클로드를 사용하여: 그것은 결정 만들기, 제어 임무 범위, 파괴 작업 전에 요청 확인을 기억할 수 있으며, 기존의 구조에 따라 프레임 워크를 권장하지 않습니다。

그리고 아직 설정하지 않은 사람들은 여전히 $975을 일주일에 보내고 자신을 설명합니다。

참고 : Karpathy의 규칙 4 시작. 이 네. CLADE.md라는 루트 디렉토리의 다음 새 파일에 붙여 넣기, 2 분 동안. 그런 다음 당신이 확인 한 격차에 따라 주간에 replenished 것입니다。

그것을 수집하기 전에 그것은 정보로 홍수. 당신이 유용하다고 느끼는 경우에, 당신은 진짜로 그것을 공유할 수 있습니다。

[ 척 ]원본 링크]