BroadRouter
시작하기

AI 코딩 에이전트(AI coding agent)

업데이트

AI 코딩 에이전트는 언어 모델이 코드베이스를 대상으로 루프를 돌며 일하는 소프트웨어 도구입니다. 파일을 읽고, 수정하고, 테스트 같은 명령을 실행하고, 출력을 읽은 뒤 다음 단계를 정하는 과정을 작업이 끝나거나 한도에 이를 때까지 반복합니다.

다른 이름: 코딩 에이전트, 에이전틱 코딩, AI 코딩 어시스턴트, AI 코딩 도구, coding agent, agentic coding, AI coding assistant

코딩 에이전트는 에디터, 파일 시스템, 터미널을 도구로 쓰는 AI 에이전트입니다.

작동 방식

에이전트는 평범한 문장으로 된 작업을 받아 루프를 돌며 일합니다. 턴마다 모델은 답하거나, “이 파일 읽기”, “이 수정 적용하기”, “테스트 실행하기” 같은 도구 호출을 돌려줍니다. 도구 호스트가 이를 실행하고 출력을 덧붙인 뒤 다시 모델을 호출합니다.

Claude Code 문서는 이를 “an agentic coding tool that reads your codebase, edits files, runs commands, and integrates with your development tools.”(번역: 코드베이스를 읽고, 파일을 수정하고, 명령을 실행하고, 개발 도구와 연동되는 에이전틱 코딩 도구)라고 설명합니다. Aider, Cline 같은 도구도 인터페이스와 권한 모델만 다를 뿐 같은 루프를 따릅니다.

SWE-agent 논문(Yang 외, 2024)은 에이전트가 사람에게 IDE가 필요하듯 자기만의 인터페이스, 즉 “agent-computer interface”(번역: 에이전트-컴퓨터 인터페이스)가 필요한 새로운 종류의 사용자라고 주장합니다. 저자들은 자신들의 인터페이스로 SWE-bench 벤치마크에서 pass@1 12.5%를 기록했다고 보고하며, 이를 당시 최고 수준이라고 설명합니다.

모델에 보내는 요청으로 본 전형적인 실행 과정은 다음과 같습니다.

단계 모델 출력 입력으로 보내는 토큰
1 run_tests() 시스템 프롬프트 + 도구 + 작업
2 read_file("src/parse.py") 1단계 + 테스트 출력
3 edit_file(...) 2단계 + 파일 내용
4 run_tests() 3단계 + diff
5 “수정했습니다. 테스트 통과.” 4단계 + 테스트 출력

기록 전체를 다시 보내기 때문에 입력은 단계마다 늘어납니다.

왜 중요한가

BroadNet Inference에서는

OpenAI 호환 base URL을 받는 코딩 에이전트는 https://inference.broadnet.ai/v1로 BroadNet을 호출할 수 있습니다. Aider, Cline 등의 설정 가이드가 있습니다. BroadNet 문서는 GLM 5.3과 Qwen3.8 27B의 도구 호출 지원을 명시합니다.

종량제 키는 분당 요청 30개, 동시 요청 4개까지 허용합니다. 정액 플랜(Full Moon, Orbit, Meteor)은 DeepSeek V4.1 Flash를 토큰 미터 없이 제공합니다. 세션 하나는 한 번에 요청 하나를 실행하므로 에이전트 하나에 맞습니다. 에이전트를 병렬로 돌리거나 서브에이전트를 띄우는 에이전트를 쓴다면, 동시에 실행되는 요청마다 세션을 하나씩 구매하세요. 계산 방법은 세션 가이드에 있습니다.

자주 묻는 질문

코딩 에이전트와 코드 자동 완성은 무엇이 다른가요?

자동 완성은 입력하는 동안 다음 몇 줄을 제안합니다. 코딩 에이전트는 실패하는 테스트 고치기 같은 작업 전체를 맡아, 끝날 때까지 파일을 읽고 수정하고 명령을 실행하는 여러 단계를 스스로 진행합니다.

코딩 에이전트는 왜 토큰을 그렇게 많이 쓰나요?

단계마다 시스템 프롬프트, 도구 정의, 파일 내용, 점점 길어지는 기록을 다시 보내는 새 요청이 나가기 때문입니다. 40단계짜리 작업이면 그 앞부분을 40번 보내므로, 에이전트에는 캐시된 입력과 정액 플랜이 중요합니다.

Claude Code, Aider, Cline에서 오픈 모델을 쓸 수 있나요?

OpenAI 호환 base URL을 받는 도구라면 오픈 모델을 호출할 수 있습니다. 예를 들어 Aider 문서는 OPENAI_API_BASE와 OPENAI_API_KEY를 설정하고 모델 이름 앞에 openai/를 붙이는 방법을 안내합니다.

Markdown으로 읽기ChatGPT에 질문하기Claude에 질문하기Perplexity에 질문하기