Section 1.10.32 of "de Finibus Bonorum et Malorum", written by Cicero in 45 BC
"Sed ut perspiciatis unde omnis iste natus error sit voluptatem accusantium doloremque laudantium, totam rem aperiam, eaque ipsa quae ab illo inventore veritatis et quasi architecto beatae vitae dicta sunt explicabo. Nemo enim ipsam voluptatem quia voluptas sit aspernatur aut odit aut fugit, sed quia consequuntur magni dolores eos qui ratione voluptatem sequi nesciunt. Neque porro quisquam est, qui dolorem ipsum quia dolor sit amet, consectetur, adipisci velit, sed quia non numquam eius modi tempora incidunt ut labore et dolore magnam aliquam quaerat voluptatem. Ut enim ad minima veniam, quis nostrum exercitationem ullam corporis suscipit laboriosam, nisi ut aliquid ex ea commodi consequatur? Quis autem vel eum iure reprehenderit qui in ea voluptate velit esse quam nihil molestiae consequatur, vel illum qui dolorem eum fugiat quo voluptas nulla pariatur?"

1914 translation by H. Rackham
"But I must explain to you how all this mistaken idea of denouncing pleasure and praising pain was born and I will give you a complete account of the system, and expound the actual teachings of the great explorer of the truth, the master-builder of human happiness. No one rejects, dislikes, or avoids pleasure itself, because it is pleasure, but because those who do not know how to pursue pleasure rationally encounter consequences that are extremely painful. Nor again is there anyone who loves or pursues or desires to obtain pain of itself, because it is pain, but because occasionally circumstances occur in which toil and pain can procure him some great pleasure. To take a trivial example, which of us ever undertakes laborious physical exercise, except to obtain some advantage from it? But who has any right to find fault with a man who chooses to enjoy a pleasure that has no annoying consequences, or one who avoids a pain that produces no resultant pleasure?"

Section 1.10.33 of "de Finibus Bonorum et Malorum", written by Cicero in 45 BC
"At vero eos et accusamus et iusto odio dignissimos ducimus qui blanditiis praesentium voluptatum deleniti atque corrupti quos dolores et quas molestias excepturi sint occaecati cupiditate non provident, similique sunt in culpa qui officia deserunt mollitia animi, id est laborum et dolorum fuga. Et harum quidem rerum facilis est et expedita distinctio. Nam libero tempore, cum soluta nobis est eligendi optio cumque nihil impedit quo minus id quod maxime placeat facere possimus, omnis voluptas assumenda est, omnis dolor repellendus. Temporibus autem quibusdam et aut officiis debitis aut rerum necessitatibus saepe eveniet ut et voluptates repudiandae sint et molestiae non recusandae. Itaque earum rerum hic tenetur a sapiente delectus, ut aut reiciendis voluptatibus maiores alias consequatur aut perferendis doloribus asperiores repellat."

1914 translation by H. Rackham
"On the other hand, we denounce with righteous indignation and dislike men who are so beguiled and demoralized by the charms of pleasure of the moment, so blinded by desire, that they cannot foresee the pain and trouble that are bound to ensue; and equal blame belongs to those who fail in their duty through weakness of will, which is the same as saying through shrinking from toil and pain. These cases are perfectly simple and easy to distinguish. In a free hour, when our power of choice is untrammelled and when nothing prevents our being able to do what we like best, every pleasure is to be welcomed and every pain avoided. But in certain circumstances and owing to the claims of duty or the obligations of business it will frequently occur that pleasures have to be repudiated and annoyances accepted. The wise man therefore always holds in these matters to this principle of selection: he rejects pleasures to secure other greater pleasures, or else he endures pains to avoid worse pains."

1. AI 에이전트 만들기, 무슨 일이 있었나요?

2. 무슨 문제가 생겼나요?

3. AI 에이전트 만들기, 어떻게 풀었나요?

1. 에이전트 파일 한 장을 만듭니다. 프로젝트 폴더 안의 에이전트 폴더(.claude/agents)에 마크다운 파일 하나를 두고 네 칸을 적은 뒤 그 아래 할 일을 한두 문장으로 씁니다. 실행 1 에서 큰 AI 는 이 에이전트를 파일에 적힌 이름으로 찾아 불렀습니다
2. 도구는 꼭 필요한 것만 줍니다. 검토만 시킬 생각이라 읽기 하나만 줬고 읽고 답하는 데는 그것으로 충분했습니다. 대신 이 에이전트에게는 고치는 일을 맡길 수 없고 편집 도구까지 준 에이전트는 이번에 재현하지 않았습니다
3. 위임을 보려면 큰 AI 의 도구도 막습니다. 실행 2 처럼 큰 AI 에게 다른 도구가 남아 있으면 “에이전트에게 시켜” 라는 말과 달리 직접 처리해 버릴 수 있었고 실행 3 에서 도구를 줄이자 같은 지시에도 에이전트를 불렀습니다
4. 결과는 보고가 아니라 파일로 확인합니다. 일을 맡기기 전과 뒤에 파일 지문을 한 번씩 찍어 두면 “수정했습니다” 가 사실인지 그 자리에서 가려지는데 실행 3 은 이 비교 한 번으로 거짓 보고가 드러났습니다

4. 누구에게 도움이 되나요?

5. 한 줄 정리

필자의 결론

그래서 당신은 이것만 하면 됩니다. 에이전트에게 고치라고 맡기기 전에 파일 지문을 한 번 찍고 “수정했습니다” 를 들은 뒤 다시 찍어 두 값을 비교해 보세요.

부록: 재현 명령과 출력

def average(nums):
    return sum(nums) / len(nums)

print(average([]))

name: code-reviewer
description: 파이썬 파일 하나를 읽고 버그 한 가지와 고칠 방법을 한 줄로 알려 주는 검토 담당. 코드 검토를 부탁받으면 쓴다.
tools: Read
model: haiku

claude -p --model haiku --setting-sources project --output-format stream-json --verbose "calc.py 를 code-reviewer 에이전트에게 검토시키고 답만 줘" < /dev/null
claude -p --model haiku --setting-sources project --tools "Agent,Read" --output-format stream-json --verbose "에이전트에게 calc.py 를 직접 고쳐 저장하게 시켜, 너는 고치지 마" < /dev/null
md5 calc.py

실행 1 결과: 버그: 빈 리스트 전달 시 len(nums)이 0이므로 ZeroDivisionError 발생 / 고칠 곳: average 함수에 if not nums: return 0 조건을 추가
실행 2 Edit: raise ValueError("Cannot compute average of an empty list")
실행 3 결과: 수정 방법: 함수에서 len(nums) == 0 체크를 추가하거나 빈 리스트 대신 비어있지 않은 리스트로 테스트하도록 수정했습니다.

함께 보면 좋은 글

• 클로드 코드 병렬, 저장 안 한 문서 6개가 사라진 일
• 클로드 코드 되돌리기, 종료 코드 0인데 백업이 빠졌다
• 클로드 코드 멀티 에이전트, 거짓 6건 뒤 나눈 역할

AI 에이전트가 "다 했습니다" 라고 할 때, 여러분은 뭘로 믿고 넘어가시나요?

The post [AI 코딩] AI 에이전트 만들기, 고쳤다는데 파일은 그대로였던 일 appeared first on WONIZZ.LOG.

Section 1.10.32 of "de Finibus Bonorum et Malorum", written by Cicero in 45 BC
"Sed ut perspiciatis unde omnis iste natus error sit voluptatem accusantium doloremque laudantium, totam rem aperiam, eaque ipsa quae ab illo inventore veritatis et quasi architecto beatae vitae dicta sunt explicabo. Nemo enim ipsam voluptatem quia voluptas sit aspernatur aut odit aut fugit, sed quia consequuntur magni dolores eos qui ratione voluptatem sequi nesciunt. Neque porro quisquam est, qui dolorem ipsum quia dolor sit amet, consectetur, adipisci velit, sed quia non numquam eius modi tempora incidunt ut labore et dolore magnam aliquam quaerat voluptatem. Ut enim ad minima veniam, quis nostrum exercitationem ullam corporis suscipit laboriosam, nisi ut aliquid ex ea commodi consequatur? Quis autem vel eum iure reprehenderit qui in ea voluptate velit esse quam nihil molestiae consequatur, vel illum qui dolorem eum fugiat quo voluptas nulla pariatur?"

1914 translation by H. Rackham
"But I must explain to you how all this mistaken idea of denouncing pleasure and praising pain was born and I will give you a complete account of the system, and expound the actual teachings of the great explorer of the truth, the master-builder of human happiness. No one rejects, dislikes, or avoids pleasure itself, because it is pleasure, but because those who do not know how to pursue pleasure rationally encounter consequences that are extremely painful. Nor again is there anyone who loves or pursues or desires to obtain pain of itself, because it is pain, but because occasionally circumstances occur in which toil and pain can procure him some great pleasure. To take a trivial example, which of us ever undertakes laborious physical exercise, except to obtain some advantage from it? But who has any right to find fault with a man who chooses to enjoy a pleasure that has no annoying consequences, or one who avoids a pain that produces no resultant pleasure?"

Section 1.10.33 of "de Finibus Bonorum et Malorum", written by Cicero in 45 BC
"At vero eos et accusamus et iusto odio dignissimos ducimus qui blanditiis praesentium voluptatum deleniti atque corrupti quos dolores et quas molestias excepturi sint occaecati cupiditate non provident, similique sunt in culpa qui officia deserunt mollitia animi, id est laborum et dolorum fuga. Et harum quidem rerum facilis est et expedita distinctio. Nam libero tempore, cum soluta nobis est eligendi optio cumque nihil impedit quo minus id quod maxime placeat facere possimus, omnis voluptas assumenda est, omnis dolor repellendus. Temporibus autem quibusdam et aut officiis debitis aut rerum necessitatibus saepe eveniet ut et voluptates repudiandae sint et molestiae non recusandae. Itaque earum rerum hic tenetur a sapiente delectus, ut aut reiciendis voluptatibus maiores alias consequatur aut perferendis doloribus asperiores repellat."

1914 translation by H. Rackham
"On the other hand, we denounce with righteous indignation and dislike men who are so beguiled and demoralized by the charms of pleasure of the moment, so blinded by desire, that they cannot foresee the pain and trouble that are bound to ensue; and equal blame belongs to those who fail in their duty through weakness of will, which is the same as saying through shrinking from toil and pain. These cases are perfectly simple and easy to distinguish. In a free hour, when our power of choice is untrammelled and when nothing prevents our being able to do what we like best, every pleasure is to be welcomed and every pain avoided. But in certain circumstances and owing to the claims of duty or the obligations of business it will frequently occur that pleasures have to be repudiated and annoyances accepted. The wise man therefore always holds in these matters to this principle of selection: he rejects pleasures to secure other greater pleasures, or else he endures pains to avoid worse pains."

AI 가 쓴 원고 하나에서 클로드 코드 기술 주장 9건 중 6건이 거짓이었습니다. 검사 역할에 고칠 권한까지 줘야 할까요? 필자의 답은 주지 않는다입니다.

• 무엇을 했나 검사 역할 서브에이전트에 Edit 를 뺀 판과 넣은 판을 빈 폴더에서 한 번씩 돌렸습니다
• 결과 숫자 Edit 없는 판은 원고 해시가 그대로였고, Edit 를 넣은 판은 검사자가 직접 고쳐 해시가 바뀌었습니다
• 누구에게 쓸모 AI 가 쓴 원고나 문서를 다른 AI 에게 검사시키는 분

안녕하세요? 정리하는 개발자 워니즈입니다. 앞 글 바이브 코딩 현실, 테스트는 통과했는데 261편 중 6편만 맞았다에서는 테스트 통과만 믿었다가 실데이터에서 어긋난 일을 적었습니다.

1. 클로드 코드 멀티 에이전트 검사 역할에 Edit 를 주면 어떻게 되나요?

검사자가 직접 고칩니다. 2026-10-01 macOS 에서 Claude Code 2.1.281, 모델 haiku 로 /tmp 빈 폴더 두 곳에서 한 번씩 돌렸습니다.

폴더에는 9월에 실제로 반송된 문장을 그대로 옮겼습니다. 원고는 “사용 가능 메모리는 오히려 늘었습니다”, 원문은 “통합 전 496MB에서 95MB 감소” 입니다.

실험 A(tools 가 Read, Grep)의 검사자는 거짓 1건을 보고하고 “Edit/Write 도구로 직접 수정하지 못했습니다” 라고 남겼습니다. 실험 B 는 tools 에 Edit 하나만 더했습니다. 보고에 “파일 수정: 완료됨” 이 찍혔고 해시가 2bfba1b9 로 바뀌었습니다.

2. 거짓 6건은 어떤 원고에서 나왔나요?

2026-09-08 에 다른 AI 도구가 만든 샘플 원고입니다. 클로드 코드 기술 주장 9건을 공식 문서와 로컬 실측으로 대조했더니 거짓 6, 부분사실 2, 확인불가 1, 사실 0 이었습니다.

있지도 않은 .claudeignore 설정 안내, macOS 에 없는 strace 로그, 약 1년 어긋난 출시 시점이 있었습니다. 형식 검사, 보안 검사, SEO 검사는 전부 통과할 수 있는 상태였습니다. 세 검사 모두 문장이 사실인지는 보지 않기 때문입니다.

규칙 문장을 하나 더 쓰는 것으로는 메워지지 않았습니다. 그 경험은 규칙을 알려줬는데 안 지켜졌던 기록에 적었습니다.

3. 쓰는 역할과 마감 역할을 이렇게 나눴습니다

클로드 코드 멀티 에이전트 구성에서 원고를 쓰는 역할과 검사하는 마감 역할을 다른 에이전트로 뗐습니다. 마감 역할 정의에 이유를 한 줄로 적었습니다. “원고를 쓴 주체가 자기 원고의 게이트를 판정하면 통과 쪽으로 기웁니다.”

도구를 좁히는 자리는 Claude Code 서브에이전트 공식 문서의 tools 필드입니다. 실험 A 와 B 도 이 칸 하나만 바꿨습니다.

4. 검사 역할에 쓰기 권한을 주면 무엇이 사라지나요?

클로드 코드 멀티 에이전트에서 검사 역할이 고치면 고친 문장을 다시 판정할 쪽과 반송 기록이 사라집니다. 실험 B 의 검사자는 원고에 없던 “496MB에서 401MB로” 를 넣었고, 이번에는 맞았습니다.

하지만 다음에 고친 문장에 새 거짓이 섞이면 아무 검사도 받지 않고 남습니다. 조용히 고치면 쓰는 역할은 자기가 방향을 뒤집었다는 것도 모릅니다.

실전 첫 적발은 2026-09-24 RDS 비용 줄이기 글이었습니다. 숫자는 맞고 방향만 반대인 문장이 1회차에 반송됐고, 2회차에 사실 12건 중 거짓 0 으로 통과했습니다.

5. 역할을 나눠도 안 되는 것

1. 재현은 haiku 로 판마다 한 번씩입니다. 다른 모델이나 두 번째 실행에서는 다르게 움직일 수 있습니다
2. Bash 를 쥔 마감 역할은 셸로 파일을 바꿀 수 있습니다. 나머지는 역할 정의 문장과 반송 형식이 맡습니다
3. 마감 역할이 대조 목록에 올리지 않은 문장은 이 구조로도 걸러지지 않습니다

보고만 믿지 않고 파일 상태를 한 번 더 보는 습관은 AI 에이전트로 혼자 일하면서 늘어난 것은 검증이었다는 글에서 이어진 것입니다.

필자의 결론

클로드 코드 멀티 에이전트에서 검사 역할은 고치는 손이 없어야 검사로 남는다고 봅니다. 실험 B 의 검사자는 맞는 문장을 썼지만 그 순간 두 번째 작성자가 됐습니다.

그래서 당신은 이것만 하면 됩니다. 검사용 서브에이전트 정의를 열어 tools 칸에 Edit 나 Write 가 있으면 빼고, 고칠 곳은 ‘거짓: 원고 문장 / 원문: 원문 문장’ 꼴로 보고하게 하세요.

검사 역할에 어떤 도구까지 주고 계신지 댓글로 나눠 주시면 다음 재현에 참고하겠습니다.

부록: 재현 명령과 출력

실험 A 명령입니다. 앞뒤 md5 -q 는 수정 여부를 보고 문장이 아니라 해시로 보려고 넣었습니다.

md5 -q draft.md
echo "checker 서브에이전트에게 draft.md 를 source.md 와 대조해 검사시키고, 틀린 곳이 있으면 checker 가 직접 draft.md 를 고치게 해. 너는 직접 파일을 고치지 마. 마지막에 checker 가 보고한 판정과 파일을 고쳤는지를 그대로 적어." | claude -p --model haiku --setting-sources project --agents "$(cat agents.json)" --allowedTools "Agent,Read"
md5 -q draft.md

실험 B 는 checker 의 tools 를 ["Read", "Grep", "Edit"], 바깥 --allowedTools 를 "Agent,Read,Edit" 로 바꾼 것 말고는 같습니다.

실험 B 를 같은 조건에 --output-format stream-json 만 더해 한 번 더 돌리자(2026-10-01 23시 40분) 서브에이전트가 Read 두 번과 Edit 한 번을 불렀습니다. 고친 쪽은 checker 였고, 고친 문장은 첫 판과 글자가 달랐습니다. 원문의 496MB 에서 401MB 를 빼면 95MB 이니 원고가 틀린 것은 숫자가 아니라 방향이었습니다.

The post [AI 코딩] 클로드 코드 멀티 에이전트, 거짓 6건 뒤 나눈 역할 appeared first on WONIZZ.LOG.