[태그:] 에이전트
-
![[에이전트] 12. 회고 : 8일 45커밋이 남긴 것 — 제약이 설계를 만든다](https://cozlab.app/wp-content/uploads/2026/08/agent-12.png)
[에이전트] 12. 회고 : 8일 45커밋이 남긴 것 — 제약이 설계를 만든다
폐쇄망 로컬 LLM 에이전트 8일 개발기의 마무리 — 커밋 리듬, 실기 검증·실패 보존·안전 표면 동결이라는 작업 관행, 클로드 코드에게 배운 것과 실측 수치 총정리.
-
![[에이전트] 11. UX : 기다림을 설계하다 — notice·타이핑·복원되는 타임라인](https://cozlab.app/wp-content/uploads/2026/08/agent-11.png)
[에이전트] 11. UX : 기다림을 설계하다 — notice·타이핑·복원되는 타임라인
느린 로컬 LLM의 UX 설계 — 컨텍스트 압축을 사용자에게 알리는 notice 통로, 사고는 스피너로 대체한 CLI 타이핑, 한글 바이트 경계까지 잡은 SSE, 새로고침에도 온전한 타임라인.
-
![[에이전트] 10. 배포 : 단일 바이너리와 폐쇄망 반입 — 구형 CPU에서 안 뜨던 날](https://cozlab.app/wp-content/uploads/2026/08/agent-10.png)
[에이전트] 10. 배포 : 단일 바이너리와 폐쇄망 반입 — 구형 CPU에서 안 뜨던 날
폐쇄망 배포 실전 — AVX2 전제 런타임 때문에 구형 PC에서 실행조차 안 되던 사고(VEX 명령 72만 개 실측)와 반입 수집기의 구멍을 막은 기록. 폐쇄망 배포 체크리스트 포함.
-
![[에이전트] 9. 컨텍스트 : KV 캐시와 압축의 사투 — 하루 만의 revert까지](https://cozlab.app/wp-content/uploads/2026/08/agent-09.png)
[에이전트] 9. 컨텍스트 : KV 캐시와 압축의 사투 — 하루 만의 revert까지
로컬 LLM 에이전트 컨텍스트 관리 실전 — 맥락이 죽는 옵션 버그, KV 캐시를 깨던 상시 축소의 revert, 요약이 쌓이는 역전 버그, 추정 대신 KV 실토큰 판정까지. 실패 기록이 자산이 되는 과정.
-
![[에이전트] 8. 소형모델 : 4B로 버티는 설계 — 지연 로딩·발견성·루프 차단](https://cozlab.app/wp-content/uploads/2026/08/agent-08.png)
[에이전트] 8. 소형모델 : 4B로 버티는 설계 — 지연 로딩·발견성·루프 차단
4B 로컬 LLM 에이전트의 실전 대응 3종 — 도구 정의 지연 로딩(대화 여유 28%→73%), xlsx→excel을 못 잇는 발견성 문제, 성공만 반복하는 무한 루프를 결과 지문으로 끊기.
-
![[에이전트] 7. 규칙 : “다시 묻지 않기”를 감사 가능하게 영속화한다](https://cozlab.app/wp-content/uploads/2026/08/agent-07.png)
[에이전트] 7. 규칙 : “다시 묻지 않기”를 감사 가능하게 영속화한다
승인 창의 y/N을 y/N/a로 — AI 에이전트에 ‘항상 허용’ 규칙을 넣되 정책·파괴적 동작은 못 뚫게, 통과는 RULE_APPROVED로 남게 설계한 기록. 편의 기능이 안전을 갉지 않게 하는 공식.
-
![[에이전트] 6. 승인 : 실행 전에 막고, 전부 기록한다 — 감사 가능한 권한 모드](https://cozlab.app/wp-content/uploads/2026/08/agent-06.png)
[에이전트] 6. 승인 : 실행 전에 막고, 전부 기록한다 — 감사 가능한 권한 모드
AI 에이전트의 승인·감사 설계 — 승인 상태 6종으로 ‘누가 허락했는가’를 남기고, 클로드 코드식 권한 모드 4종을 얹되 정책 DENY와 파괴적 동작은 무엇으로도 못 뚫게 한다.
-
![[에이전트] 5. 도구 : Tool 35종과 화이트리스트 셸 — 다섯 겹의 방어](https://cozlab.app/wp-content/uploads/2026/08/agent-05.png)
[에이전트] 5. 도구 : Tool 35종과 화이트리스트 셸 — 다섯 겹의 방어
AI 에이전트에 셸을 쥐여주는 법 — 셸 없이 실행, 화이트리스트, 승인 전 precheck, 승인, 감사의 다섯 겹. 파일 158개를 승인 1회로 옮기게 한 실측 개선까지.
-
![[에이전트] 4. 추론 : 별도 서버 없이 프로세스 안에서 LLM 돌리기](https://cozlab.app/wp-content/uploads/2026/08/agent-04.png)
[에이전트] 4. 추론 : 별도 서버 없이 프로세스 안에서 LLM 돌리기
llama-server를 걷어내고 node-llama-cpp 인프로세스 추론으로 전환한 기록. 콜드 23초→웜 1.9초(36배) 실측, 세션당 388MiB 메모리 실측으로 기본값을 다시 잡았다.
-
![[에이전트] 3. 피벗 : Java로 시작해 이틀 만에 TypeScript+Bun으로 갈아엎다](https://cozlab.app/wp-content/uploads/2026/08/agent-03.png)
[에이전트] 3. 피벗 : Java로 시작해 이틀 만에 TypeScript+Bun으로 갈아엎다
하루 반 만든 Java 에이전트를 810파일 커밋 하나로 TypeScript+Bun에 이식한 기록. 폐쇄망 단일 바이너리 배포가 언어를 결정했고, 패리티 규율이 재작성 리스크를 눌렀다.