클로드 코드 공식문서부터 읽기
그냥저냥 쓰고 있던 AI 도구들이 점점 진화하면서
정확히 소화하지 않고 넘어갔던 개념들이 발목 잡는 것 같아서
클로드 코드 공식문서부터 읽어보는 포스트
밑줄 & 메모 요약
-
에이전트 루프
클로드 코드가 작동하는 방식, 컨텍스트 수집 → 작업 수행 → 결과 검증, 3단계를 반복. 결과 검증까지 루프 안에 들어가는지 몰랐음
Claude Code는 Claude 주변의 에이전트 하네스 역할 (도구, 컨텍스트 관리, 실행 환경 제공)
에이전트 루프는 모델과 도구로 구성되어 구동됨 -
모델
Sonnet = 코딩 작업, Opus = 아키텍처 결정 + 강력한 추론 -
도구 가 없으면 Claude는 텍스트로만 응답 → 도구가 있어야 에이전트
기능 확장 4가지: skills, MCP, hooks, subagents 써보고 싶다 !! -
CLAUDE.md = 매 세션마다 로드되는 컨텍스트 / 자동 메모리 = 학습 내용 자동 저장 (200줄 or 25KB 제한)
-
세션 재개:
--continue/--resume(권한은 복원 안 됨),--fork-session으로 원본 영향 없이 분기 -
Skills는 요청 시 로드, Subagents는 완전히 분리된 컨텍스트 → 긴 세션에서 유리
-
계획 모드
복잡한 문제는Shift+Tab두 번으로 연구와 코딩 분리 -
Claude Cowork
보안: prompt injection의 주요 벡터는 웹 콘텐츠. 민감 앱(banking 등) 차단 권장. Claude는 스크린샷을 찍어서 화면을 이해함
Cross-app: Excel↔PowerPoint 간 데이터가 자동 이동될 수 있음.
모바일에서 접속하면 폰이 데스크톱의 리모트 컨트롤이 됨
Scheduled tasks: 컴퓨터가 깨어있고 앱이 열려 있을 때만 실행. 건너뛴 작업은 다시 깨어나면 자동 실행
에이전트 루프


what is agent harness?
AI가 single session, single agent로 끝나지 않고 여러 세션이나 컨텍스트를 왔다갔다 하면서 태스크를 수행하는 형태
길고 큰 태스크를 수행하는 데에 더 적절함
모델

도구



컨텍스트

실행 환경

브랜치 간 작업

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

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

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

체크포인트로 변경 취소

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

대화입니다

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

여기서부터 Claude Cowork 문서
Cowork이 앱과 앱을 넘나드는 하네스 에이전트를 좀더 쉽게 만든 툴인 것 같아서
생산성에 잘 활용하고 싶은 마음에 들어갔는데
아직 실험적 프리뷰 단계라고 하면서 주의사항 읽어보라고 해서 난 개 쫄보니까 읽어보라는거 성실히 다 읽어봤음근데 번역된게 더 알아듣기 힘들어서 여기서부터 영어로 캡처
Understanding the risks

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

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

Be cautious with computer use

Limit browser and web access

Cross-app data sharing & Mobile access

What scheduled tasks can do

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


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