클로드 코드 PR 자동 고치기 — 충돌엔 안 움직임·답글은 내 계정 명의

끌어올림 요청(PR)을 올려 두고 자는 동안, 검사가 깨지거나 동료가 리뷰 댓글을 달면 알아서 원인을 찾아 고쳐서 밀어 올리는 기능이 붙었습니다. 「자동 고치기」라고 부릅니다. 켜 두면 그 요청 하나를 계속 지켜보다가 깃허브에서 사건이 올 때마다 반응합니다.

그런데 「지켜본다」의 범위가 생각보다 좁습니다. 가장 흔하게 부딪히는 문제 하나에는 아예 반응하지 못하고, 클로드가 남기는 답글은 제 깃허브 계정 이름으로 올라갑니다. 저장소에 댓글로 도는 자동화가 걸려 있다면 이게 그냥 넘길 얘기가 아닙니다. 켜는 방법부터 차례로 짚어 보겠습니다.

📌 30초 요약

• 켜는 문이 네 곳이고, 요청 하나마다 따로 켭니다.
• 사건마다 바로 고치기·물어보기·기록만 셋으로 갈립니다.
• 병합 충돌에는 반응하지 못합니다. 종이 안 울리기 때문입니다.
• 답글은 제 계정 명의로 올라갑니다.

1. 켜는 문이 넷입니다

먼저 전제 조건이 하나 있습니다. 클로드 깃허브 앱이 그 저장소에 깔려 있어야 합니다. 앱이 없으면 사건이 전달될 통로 자체가 없어 켤 수 없습니다. 앱을 어디에 깔면 어디까지 열리는지는 클라우드 세션과 깃허브 앱 설치 범위를 정리한 글에서 다룬 적이 있으니 아직 안 깔았다면 그쪽을 먼저 보시는 게 빠릅니다. 앱이 있다면 켜는 길은 네 갈래인데, 서로 다른 상황을 겨냥해 나뉘어 있습니다.

어디서	켜는 방법
클라우드 세션에서 만든 요청	세션 화면을 열고 검사 상태 막대를 펼쳐 「자동 고치기」를 고릅니다.
내 터미널	그 가지에 서서 자동 고치기 명령을 칩니다. 열린 요청을 찾아 클라우드 세션을 띄우고 켜는 것까지 한 번에 합니다.
폰 앱	말로 시킵니다. 「이 요청 지켜보다가 검사 깨지거나 리뷰 달리면 고쳐 줘」 정도면 됩니다.
아무 요청이나	세션 창에 요청 주소를 붙여넣고 자동 고치기를 시켜 달라고 합니다.

터미널에서 치는 명령이 특히 손이 적게 갑니다. 열린 요청을 깃허브 도구로 알아서 찾아내고, 클라우드 세션을 새로 띄우고, 거기에 자동 고치기를 켜는 것까지 한 번에 처리하기 때문입니다. 말하자면 「내 노트북에서 시작해 구름 위로 넘기는」 동작인데, 명령줄에서 클라우드로 넘어가는 다른 길이 대부분 막혀 있다는 점을 생각하면 눈에 띄는 예외입니다. 그 방향 제약은 터미널과 클라우드 사이 이동이 한 방향뿐이라는 글에서 따로 정리해 뒀습니다.

끄는 건 검사 상태 막대에서 토글을 내리거나 「그만 지켜봐」라고 말하면 됩니다. 중요한 건 계정이나 저장소 단위가 아니라 요청 하나짜리 스위치라는 점입니다.

2. 세 갈래 반응과, 종이 안 울리는 곳

켜 두면 클로드는 새로 달린 리뷰 댓글이나 깨진 검사 같은 깃허브 사건을 받습니다. 여기서 흔한 오해가 「사건이 오면 무조건 고친다」고 보는 건데, 실제로는 사건 하나하나에 대해 셋 중 하나를 고릅니다.

첫째, 고칠 방향이 분명하고 앞서 받은 지시와 부딪히지 않으면 바로 고쳐서 밀고, 무엇을 했는지 세션에 적어 둡니다. 여기서 「앞서 받은 지시와 부딪히지 않으면」이라는 단서가 중요합니다. 세션 초반에 「이 파일은 건드리지 마」라고 해 뒀다면, 리뷰어가 그 파일을 고치라고 댓글을 달아도 자동으로 밀지 않습니다. 둘째, 댓글이 여러 갈래로 읽히거나 구조를 건드리는 얘기면 먼저 물어봅니다. 셋째, 같은 사건이 중복해서 오거나 손댈 게 없으면 세션에 기록만 남기고 넘어갑니다.

여기서 파생되는 함정이 있습니다. 「분명한 것만 알아서 처리하고 애매한 건 물어본다」는 성질은 곧 리뷰 댓글을 애매하게 쓸수록 클로드가 멈춰 선다는 뜻이기도 합니다. 아침에 아무것도 안 고쳐져 있다고 기능이 죽은 게 아니라 답을 기다리는 중일 수 있습니다. 그런데 멈춰 서는 것과 달리, 아예 깨어나지도 못하는 자리가 따로 있습니다. 기준 가지가 앞서 나가면서 병합 충돌이 생기는 상황에는 자동 고치기가 반응하지 못합니다. 클로드가 게을러서가 아니라 깃허브가 그 상황에서는 알림을 쏘지 않기 때문입니다. 애초에 종이 안 울리면 깨어날 방법이 없습니다. 해결 자체는 쉽습니다. 세션을 열고 기준 가지 위로 다시 얹어 달라고 하면 됩니다. 다만 그 한 번은 사람이 눈치채고 시작해야 합니다.

이게 뼈아픈 건 여러 사람이 올리는 저장소에서 요청을 하루 넘게 열어 두면 충돌이 검사 실패보다 오히려 흔하기 때문입니다. 그러니 자동 고치기는 「검사와 리뷰만 대신 돌봐 주는 장치」로 기대하고, 충돌은 사람 점검 목록에 그대로 남겨 두는 편이 낫습니다. 취약점 스캔 도구가 문제를 찾아 주되 패치는 사람이 직접 해야 했던 구조와 비슷한 분업입니다.

3. 답글이 제 이름으로 올라갑니다

클로드는 리뷰 댓글 타래를 정리하는 과정에서 그 타래에 답글을 달기도 합니다. 문제는 이 답글이 올라가는 명의입니다. 제 깃허브 계정으로 올라가서 제 사용자 이름 밑에 붙습니다. 답글마다 「클로드 코드가 쓴 것」이라는 표시가 달리니 리뷰어가 착각할 일은 없습니다. 하지만 깃허브가 보기에 그 댓글을 단 주체는 저입니다.

⚠️ 댓글로 도는 자동화가 제 이름으로 발동될 수 있습니다

저장소에 댓글을 방아쇠로 쓰는 자동화가 걸려 있다면 조심해야 합니다. 기반 시설 배포 도구나, 댓글 사건에 반응하도록 직접 짠 작업 흐름이 여기 듭니다. 클로드가 제 계정으로 답글을 달면 그 자동화가 그대로 발동할 수 있습니다. 댓글 한 줄이 서버를 새로 올리거나 권한 있는 작업을 돌리는 저장소라면, 자동 고치기를 켜기 전에 저장소에 걸린 자동화부터 훑어보고, 그런 저장소에서는 아예 켜지 않는 쪽을 권합니다.

이 대목은 「무엇이 실행되는가」보다 「누구 이름으로 실행되는가」를 봐야 하는 경우입니다. 댓글을 받아 도는 쪽이 제 권한으로 움직이기 때문입니다. 국산 코드 리뷰 도구를 붙일 때도 어느 계정으로 저장소에 붙는지가 비슷하게 중요했습니다.

4. 멀리서 방향을 돌리는 법

자동 고치기가 물어보려고 멈춰 섰거나, 방향을 바꿔 주고 싶을 때 세션 화면을 꼭 열어야 하는 건 아닙니다. 로그인만 되어 있으면 아무 컴퓨터에서나 명령줄로 세션에 말을 걸 수 있습니다. 명령은 메시지 하나를 넣고 바로 끝납니다. 답을 기다리지 않고 빠져나오기 때문에, 긴 작업이 도는 중에 다음 할 일을 미리 넣어 두거나 자동 빌드 스크립트에서 쏘는 용도로 쓰기 좋습니다.

실패할 때 나오는 문구가 꽤 친절하게 갈라져 있습니다. 여기서 눈여겨볼 건 「모르면 일단 보낸다」가 아니라 「모르면 거절한다」는 설계입니다. 조직 정책을 확인하러 갔다가 통신이 안 되면, 허용된 걸로 치고 보내는 대신 아예 보내기를 거부합니다.

나오는 문구	무슨 뜻인가
다른 업체 설정에서는 못 쓴다	클라우드 세션은 앤트로픽 계정 전용입니다. 다른 업체 쪽으로 돌려 둔 설정을 풀고 로그인하세요.
조직 정책이 막고 있다	원격 세션 허용 설정이 꺼져 있습니다. 관리자만 켤 수 있습니다.
정책을 확인하지 못했다	확인이 안 되면 허용으로 치지 않고 거절합니다. 연결을 보고 다시 거세요.
붙는 건 안 열려 있다	메시지 옵션 없이 세션만 가리켰습니다. 보낼 말을 같이 주세요.
세션을 못 찾았다 · 보관된 세션이다	아이디가 틀렸거나 이미 보관해 둔 세션입니다. 보관된 세션은 새 메시지를 안 받습니다.

마지막 줄이 실수하기 쉬운 곳입니다. 세션 목록을 정리하겠다고 보관 버튼을 눌러 둔 세션에는 더 이상 말을 걸 수 없습니다. 자동 고치기를 켜 둔 세션을 보관해 버리면 지켜보기도 같이 끊기니, 요청이 살아 있는 동안에는 세션도 그냥 두는 편이 낫습니다.

자주 묻는 질문 (FAQ)

Q. 자동 고치기를 켰는데 밤새 아무것도 안 고쳐져 있습니다

세 가지를 순서대로 보세요. 먼저 병합 충돌이 났는지 — 이건 깃허브가 알림을 안 쏘기 때문에 자동 고치기가 아예 못 움직입니다. 다음으로 세션을 열어 물어보려고 멈춰 서 있는지 확인하세요. 애매한 리뷰 댓글이면 먼저 묻습니다. 마지막으로 앞서 준 지시와 부딪히는 요청이었는지 보세요.

Q. 동료가 올린 요청에도 걸 수 있나요

됩니다. 요청 주소를 세션에 붙여넣고 자동 고치기를 시켜 달라고 하면 됩니다. 다만 클로드가 남기는 답글이 제 계정 이름으로 올라간다는 점을 기억하세요. 남의 요청에 제 이름으로 답글이 줄줄이 달리는 그림이 되니, 미리 말을 맞춰 두는 게 좋습니다.

Q. 저장소 전체에 한 번만 켜 둘 수는 없나요

없습니다. 요청 하나마다 따로 켜는 스위치입니다. 저장소 단위나 계정 단위 설정이 아니라서, 여러 요청에 걸려면 각각 켜야 합니다. 대신 터미널에서 치는 명령이 요청 찾기·세션 띄우기·켜기를 한 번에 해 주니 손이 그렇게 많이 가지는 않습니다.

Q. 명령줄로 보낸 메시지가 안 갑니다

문구부터 읽으세요. 보관된 세션이면 새 메시지를 안 받습니다. 조직 정책을 확인하지 못했다는 문구라면 연결이 안 돼서 거절한 것이지 권한 문제가 아닙니다. 업체 설정이나 정책 문제는 기계가 읽는 형식으로 안 나오고 오류 출력으로만 찍히니, 스크립트에 넣었다면 그쪽도 같이 보셔야 합니다.

정리하면

• 깃허브 앱이 먼저 깔려 있어야 합니다.
• 스위치는 요청 하나짜리입니다.
• 사건마다 고치기·묻기·기록 셋으로 갈립니다.
• 병합 충돌은 사람이 먼저 눈치채야 합니다.
• 답글은 제 계정 명의로 올라갑니다.

※ 공개된 클라우드 세션 문서의 자동 고치기 항목을 읽고 정리했습니다. 명령과 옵션 이름은 우리말로 풀어 적었으니 실제 입력값은 원문에서 확인하세요.

※ 깃허브가 어떤 상황에서 알림을 보내는지는 깃허브 쪽 사정이라 나중에 달라질 수 있습니다. 병합 충돌에 반응하지 못한다는 제약도 그때 함께 바뀔 수 있으니 원문과 대조해 확인하세요.