GitHub 코딩 에이전트 팀에 썼더니 Actions 요금이 두 배 됐다, 쓰기 전에 알아야 할 것

Copilot을 코드 자동완성 도구로만 쓰다가, 지난달에 처음으로 cloud agent를 써봤다. 이슈에 Copilot을 할당했더니 30분 뒤에 PR이 올라와 있었다. 그 순간 "어, 이게 그냥 자동완성이 아니구나" 하는 생각이 들었다. 그리고 청구서를 보고 다시 한번 놀랐다. GitHub Actions 요금이 두 배가 됐다는 걸 그때서야 알았다.

Copilot이 세 개로 나뉜 줄 몰랐다

요즘 Copilot은 사실 3계층으로 나뉜다. 아직 "자동완성 = Copilot"이라고 생각하는 사람이 많은데, 이제는 그게 한 축에 불과하다.

• Inline suggestions — 코드 짜다가 회색 글씨로 제안 뜨는 그것. 반복 코드, 변수명, 테스트 스캐폴딩에 강하다.
• Copilot Chat (ask·plan·agent mode) — IDE 안에서 채팅창 열고 쓰는 것. ask는 질문, plan은 구현 계획 생성, agent는 자율적으로 파일 찾아서 수정까지.
• Cloud agent (코딩 에이전트) — IDE 밖에서 GitHub 서버가 백그라운드로 작업. 이슈를 받아 저장소 분석 → 코드 작성 → PR 생성까지 혼자 한다.

IDE 안의 agent mode와 cloud agent는 이름이 비슷해서 헷갈리는데, 전혀 다른 것이다. IDE agent mode는 내 컴퓨터에서 내가 승인하면서 진행하고, cloud agent는 GitHub 서버에서 독립적으로 돌아간다. 내가 자고 있는 사이에도 PR을 올린다는 얘기다.

예전에 Copilot Workspace를 써봤을 때 IDE agent mode 이야기를 정리했는데, cloud agent는 그것과 또 다른 개념이다. 공식 문서에서도 "Copilot cloud agent"라는 별도 이름을 쓰기 시작했다.

cloud agent 이렇게 쓴다 — 이슈 하나로 PR까지

사용법 자체는 단순하다. GitHub에서 이슈를 만들고 Assignee에 Copilot을 할당하면 끝이다. 이후 흐름은 이렇다.

• 저장소 코드 분석 → 구현 계획 수립
• 브랜치 생성 → 코드 작성
• PR 자동 오픈 + 변경 요약 코멘트
• 사람이 diff 검토 → 머지

여기서 custom instructions를 제대로 설정해두면 품질이 확 달라진다. 저장소 루트에 .github/copilot-instructions.md 파일을 만들면 "이 프로젝트에서 TypeScript strict mode 사용", "함수 하나에 30줄 초과 금지" 같은 규칙을 에이전트가 자동으로 따른다. 폴더별로 다른 규칙을 주려면 .github/instructions/ 안에 *.instructions.md 파일을 두면 된다.

처음에 이 파일 없이 쓰다 보면 제안 코드가 우리 팀 컨벤션이랑 제각각이라 리뷰가 오히려 더 걸린다. custom instructions부터 만드는 게 첫 번째 할 일이다.

아, 이건 몰랐다 — 비용이 두 곳에서 나간다

솔직히 여기서 한번 데였다. cloud agent가 작업할 때 GitHub Actions minutes를 쓴다. 그리고 Copilot premium requests도 함께 소비된다. 즉, 요금이 두 군데서 나간다는 뜻이다.

팀에서 처음 도입했을 때 Actions 사용량을 체크하지 않았다가 월말에 청구서 보고 당황했다. 이슈 여러 개에 연달아 할당하면 Actions minutes가 생각보다 빠르게 줄어든다. 도입 전에 팀 Actions 예산을 확인하고, 한 달치 테스트 기간 동안 사용량을 먼저 측정하는 걸 강하게 권한다.

기능 제한도 알아두면 좋다. cloud agent는 한 번에 저장소 하나, 브랜치 하나, PR 하나만 다룰 수 있다. 저장소 두 개를 동시에 건드리는 작업은 불가능하다. 또 Business·Enterprise 플랜에서는 관리자가 정책을 먼저 켜줘야 팀원이 쓸 수 있다.

한 달 써보니 — 잘 되는 것 따로, 아직 애매한 것 따로

기대보다 잘 되는 케이스가 있고, 아직 사람이 필요한 케이스가 있다. 섞어 쓰면 효율이 높고, 전부 맡기려 하면 리뷰가 더 걸린다.

잘 맞는 케이스: 반복성 높은 작업이다. "이 엔드포인트에 단위 테스트 추가해줘", "README 업데이트해줘", "이 컴포넌트 스타일 변수로 분리해줘" 같은 이슈는 PR 품질이 꽤 깔끔하게 나온다. 기술 부채 줄이기, 문서 갱신, 리팩터링 중 반복적인 것은 사람 시간을 꽤 아껴준다.

아직 불안한 케이스: 비즈니스 로직이 복잡한 곳, 보안 민감한 코드, 레거시 코드에 얽힌 작업은 솔직히 아직 조심스럽다. 올해 초에 built-in security scanning 기능이 들어오긴 했다. 그래도 민감한 코드는 내가 직접 봐야 한다는 입장이 바뀌진 않았다.

지금 우리 팀은 "단순 반복 작업은 cloud agent, 판단이 필요한 것은 IDE Chat" 식으로 역할을 나눠 쓴다. 요금 폭탄 맞은 뒤에 Actions 예산을 따로 잡아뒀고, 그 이후로는 꽤 잘 돌아가고 있다.

---

📎 참고 자료

• GitHub Copilot custom instructions 지원 현황 — GitHub 공식 문서
• Copilot IDE에서 질문하기 (agent mode) — GitHub 공식 문서
• GitHub Copilot 코딩 에이전트 실전 가이드 — Chaos and Order

---

📌 함께 보면 좋은 글

• GitHub Copilot Workspace 써봤는데, 57% 빠르다는 말은 맞고 나머지는 달랐다
• RAG 파이프라인 만들다 3번 갈아엎었다, 실패 패턴이 있었다
• AI 에이전트가 프로덕션에서 망하는 이유, 모델 문제가 아니었다