Originally published on butterneck.com.
"Agentic coding"은 단순히 다음 줄을 제안하는 AI가 아니라, 주어진 과제를 받아 코드베이스를 읽고 여러 파일을 편집하며, 명령어를 실행하고 자신의 작업을 검토하는 AI를 일컫는 말입니다. Claude Code, Cursor의 에이전트(agent), 그리고 Antigravity 모두 이러한 방식으로 작동합니다. 이는 개발자들의 업무 방식을 변화시킵니다. 나머지 제품 팀원들에게는 새로운 질문을 던집니다: 만약 에이전트가 편집할 수 있다면, PM이나 디자이너가 작은 변경 사항 때문에 백로그에서 기다릴 필요가 있을까요?
본 포스트에서는 에이전틱 코딩을 쉬운 용어로 설명하고, 무엇을 잘 수행하는지, 그리고 무엇을 못 하는지를 다루며, 비개발자들이 터미널 없이 이를 어떻게 활용할 수 있는지 안내합니다. 저희는 Butterneck을 만들었기 때문에, 마지막에 이것이 어떻게 적용되는지 말씀드리겠습니다.
요약하자면, 에이전틱 코딩이란: AI 코딩 에이전트가 한 줄씩 완성하는 대신, 일반적인 언어로 목표를 받아 계획을 세우고, 프로젝트 전반의 파일을 편집하며, 결과를 확인합니다. Butterneck에서는 PM이나 디자이너가 앱의 라이브 프리뷰(live preview)에서 그 목표를 제시하면, 개발자가 이미 사용하는 코딩 에이전트가 컴퓨터에서 해당 편집을 수행하고, 최종적으로는 개발자가 배포할 내용을 결정하게 됩니다.
에이전틱 코딩 vs AI 자동 완성 (AI autocomplete)
| AI 자동 완성 | 에이전틱 코딩 |
|---|
| 무엇을 입력하는가 | 타이핑하고 있는 코드 | 일반적인 언어로 된 과제(Task) |
| ... | | |
입력 자체가 일반 언어라는 점에서 이 변화는 중요합니다. 일반 언어는 PM, 디자이너 또는 지원 담당자가 이미 작성할 수 있는 내용입니다.
에이전틱 코딩의 강점과 사람이 필요한 영역
적합한 사용 사례는 이미 실행 중인 앱에서 발생한 작고 잘 설명된 변경 사항들입니다: 복사(copy) 수정, 레이아웃 조정, 더 명확한 오류 메시지, 빈 상태(empty state) 처리, 양식의 누락된 필드 등이 있습니다. 에이전트는 코드를 처음 접하는 사람보다 훨씬 빠르게 적절한 파일을 찾아낼 수 있습니다.
요청이 모호하거나, 변경 사항이 인증(auth), 결제(payments) 또는 데이터(data)에 영향을 미치거나, 에이전트가 볼 수 없는 컨텍스트에 따라 '정확함'의 여부가 결정될 때는 사람이 필요합니다. 이것이 바로 대부분의 팀들이 두 가지 확인 절차를 유지하는 이유입니다: 요청한 사람이 의도한 바가 맞는지 확인하고, 개발자가 diff(변경 사항)를 검토합니다. [human-in-the-loop AI coding]에서 더 읽어보세요.
비개발자가 오늘날 에이전틱 코딩을 사용하는 방법
일반적인 두 가지 방법이 있습니다:
- 직접 에이전트를 실행합니다. Claude Code 또는 Cursor의 좌석을 확보하고, 리포지토리(repo)에 접근하며, 앱을 실행할 방법을 갖춥니다. 이는 코드베이스를 학습하려는 PM(Product Manager)에게 적합합니다. [Claude Code for product managers]를 참조하세요.
- 실행 중인 앱에서 요청하고 개발자의 에이전트가 편집하도록 합니다. 요청자에게는 리포지토리(repo), 터미널 또는 AI 좌석이 필요하지 않습니다. 개발자가 여전히 검토하고 배포합니다(ships).
Butterneck이 에이전틱 코딩을 사용하는 방법
개발자가 이미 프로젝트가 있고 코딩용 CLI(Command Line Interface)에 로그인된 컴퓨터를 연결합니다: Claude Code (claude), Cursor의 CLI (agent) 또는 Antigravity (agy)입니다. 앱은 해당 컴퓨터의 개발 서버에서 실행되며, Butterneck이 공유 링크를 제공합니다.
- 팀원이 링크를 열고 원하는 화면 옆 채팅창에 요청을 입력하거나 Jira 티켓에
butterneck 레이블을 지정합니다.
- 에이전트가 연결된 프로젝트를 편집하고, 미리 보기(preview)는 동일한 링크에서 업데이트됩니다.
- 과정이 잘못되면 중단할 수 있으며, 파일 변경 사항은 보통 롤백(rolled back)됩니다 (아니라면 채팅창에 표시됨).
- 개발자가 대화를 읽고, 변경 사항을 확인하며, 팀의 일반적인 프로세스를 통해 배포하거나 폐기합니다.
Butterneck은 커밋(commit), 푸시(push) 또는 풀 리퀘스트(pull request)를 열지 않으며, 절대 병합(merge)하거나 배포하지 않습니다. 우리는 이러한 요청을 AI 변경 요청(AI change requests)이라고 부릅니다. [AI change requests for product teams]를 참조하세요.
설정하기 전에 미리 확인해 보세요: 컴퓨터에 연결하기 전에 샘플 상점에서 요청을 시도해 보세요. 로그아웃하면 무료 계정을 만들라는 메시지가 표시됩니다. 자체 프로젝트의 경우, 편집은 개발자가 연결한 컴퓨터에서 실행되며, 최종적으로 무엇이 배포될지는 여전히 개발자가 결정합니다.
시도하기 전에 알아야 할 사항
- AI 제공업체의 약관이 적용됩니다. 연결된 컴퓨터의 코딩 CLI는 해당 제공업체의 약관에 따라 코드 컨텍스트를 자체 제공업체로 전송합니다. 로그인한 플랜은 팀을 대신하여 사용하도록 허용해야 합니다.
- 모든 것이 컴퓨터에 남아 있는 것은 아닙니다. 파일은 연결된 컴퓨터에서 편집되지만, 채팅 메시지와 미리 보기 트래픽은 Butterneck을 통해 전송됩니다.
.env 파일은 하드 블록이 아닌 가드레일입니다. 비밀 설정 파일은 AI가 접근하지 않도록 지시받는 무시 목록(ignore list)에 있습니다. 이는 지침이므로, 운영 환경의 비밀 정보는 해당 컴퓨터에 두지 마십시오.- 미리 보기를 로드하고 작업을 시작하려면 컴퓨터 전원이 켜져 있어야 합니다.
FAQ
에이전틱 코딩이란 무엇인가요?
에이전틱 코딩(agentic coding)은 AI 코딩 에이전트가 한 번에 한 줄을 제안하는 대신, 일반적인 언어로 작업을 받아들이고 프로젝트를 읽으며 단계를 계획하고 여러 파일을 편집하며 결과를 확인하는 방식입니다. Claude Code, Cursor의 에이전트, 그리고 Antigravity가 그 예시입니다.
비개발자도 에이전틱 코딩을 사용할 수 있나요?
네. 리포지토리(repo) 접근 권한과 좌석(seat)만 있다면 직접 에이전트를 실행할 수 있으며, 또는 앱의 실행 중인 사본에 변경을 요청하여 개발자의 에이전트가 편집하도록 할 수도 있습니다. 어느 쪽이든, 개발자가 여전히 변경 사항을 검토하고 무엇을 배포할지 결정해야 합니다.
에이전틱 코딩이 코드 리뷰를 대체하나요?
아닙니다. 에이전트는 자체 작업을 확인할 수 있지만, 누군가가 요청된 변경 사항인지 확인해야 하며 개발자는 이것이 배포될지 여부를 결정해야 합니다.
Butterneck은 어떤 코딩 에이전트와 함께 작동하나요?
개발자가 연결한 컴퓨터에 로그인된 Claude Code, Cursor의 에이전트 CLI, 그리고 Antigravity입니다.
사용해 보기
30분 데모 예약하기를 하거나, 가격 정책(pricing)을 확인하고 무료 스타터 플랜으로 시작할 수 있습니다.