go home
Claude /

클로드 코드 공식문서부터 읽기

'클로드 잘 쓰고싶다' 라고 그만 말하고싶다
2026/04/09

시작하는 글

그냥저냥 쓰고 있던 AI 도구들이 점점 진화하면서
정확히 소화하지 않고 넘어갔던 개념들이 발목 잡는 것 같아서
클로드 코드 공식문서부터 읽어보는 포스트


밑줄 & 메모 요약




에이전트 루프

에이전트 루프 - 컨텍스트 수집, 작업 수행, 결과 검증

에이전트 하네스 - 모델과 도구로 구동

what is agent harness?

wtf is Harness Engineer & why is it important AI가 single session, single agent로 끝나지 않고 여러 세션이나 컨텍스트를 왔다갔다 하면서 태스크를 수행하는 형태

길고 큰 태스크를 수행하는 데에 더 적절함



모델

모델 - Sonnet은 코딩, Opus는 아키텍처 추론


도구

도구 - 도구가 없으면 텍스트로만 응답

subagents와 오케스트레이션 도구

기능 확장 - skills, MCP, hooks, subagents


컨텍스트

컨텍스트 접근 범위 - CLAUDE.md, 자동 메모리


실행 환경

실행 환경 - 로컬, 클라우드, 원격적


브랜치 간 작업

브랜치 간 작업 - git worktrees

세션은 디렉토리에 연결 됐으니까 브랜치 바꾸면 현재 브랜치에 담겨있는 파일을 읽음.
까지는 그냥 그렇겠거니 하는 마음이었는데 git worktrees를 활용해서 병렬로 활용할 생각은 못해봄 ㄷㄷ


세션 재개 또는 포크

세션 재개 - continue, resume, fork-session

이건 나중에 다시 찾아봐야할 것 같음
지금까지는 vscode 안에서 진행해서 그냥 그 세션, 그 채팅방에 이어서 질문하거나 요청하면 당연히 동일한 아이디로 세션 재개하는 줄 알았는데 ... 아닌가 맞나?
근데 새 채팅방에서 resume 하면서 id 안주면 무슨 세션을 재개하는건지 어떻게 아는데? 그냥 그 세션, 채팅방에서 계속 질문을 이어나간다는 것 자체로 재개한다는 것 아닌가 ..........


컨텍스트 윈도우

컨텍스트 윈도우 관리

채팅방 = 컨텍스트 윈도우?
내가 늙크크 단어를 쓰는것인지?


skills 및 subagents로 컨텍스트 관리

skills vs subagents 컨텍스트 차이


체크포인트로 변경 취소

체크포인트 - Esc 두 번으로 취소

근데 이건 클로드 살짞 못 믿어서 눈으로 확인하려고 수작업으로 하는 이유도 있음


Claude Code에 도움을 요청

/init, /agents, /doctor 명령어


대화입니다

대화형 - 완벽한 프롬프트 불필요

컴퓨터 언어 아니고 그냥 인간 언어로, 구어체로 request 해도 알아서 해석해서 태스크 수행하는걸 대화형이라고 하는건가?


구현 전에 탐색

계획 모드 - Shift+Tab 두 번




여기서부터 Claude Cowork 문서

Cowork이 앱과 앱을 넘나드는 하네스 에이전트를 좀더 쉽게 만든 툴인 것 같아서
생산성에 잘 활용하고 싶은 마음에 들어갔는데
아직 실험적 프리뷰 단계라고 하면서 주의사항 읽어보라고 해서 난 개 쫄보니까 읽어보라는거 성실히 다 읽어봤음

근데 번역된게 더 알아듣기 힘들어서 여기서부터 영어로 캡처


Understanding the risks

리스크 이해 - 민감 파일, 신뢰 사이트, MCP 주의

특정 사이트, 혹은 다른 애플리케이션에 대한 Access를 허용해놓으면 클로드가 자의적으로 결정해서 그 안에서 움직일 수 있다는게 가장 큰 장점이면서 보안적으로 가장 조심해야할 요소인 것 같음.


Our safety measures

안전 장치 - malicious instructions 거부, 권한 요청

보안적으로 악의적인? 명령은 refuse 하게끔 학습시켰다는 것도 재밌었다
직원이 소스맵 실수로 npm에 올렸을 때도 그냥 mistakes happen, 이라고 (대외적으로나마) 대응한 것도 좋았고 ...
authoritative하고 급해보여도 해주지 않게끔 했다고 한게 진짜 웃겼다 ㅋㅋ 인간을 잘 아는군 ...


Monitor tasks, not just commands

작업 모니터링


Be cautious with computer use

컴퓨터 사용 주의 - 스크린샷, 민감 앱 차단


Limit browser and web access

웹 접근 제한 - prompt injection 주요 벡터


Cross-app data sharing & Mobile access

Cross-app 데이터 이동, 모바일 리모트 컨트롤


What scheduled tasks can do

스케줄 작업 용도 - 브리핑, 리포트, 리서치, 파일 정리

스케줄 작업 뭔가 유용해보여서 캡처해봤다

How scheduled tasks work

스케줄 작업 - 컴퓨터 깨어있을 때만 실행