코딩 에이전트는 에디터, 파일 시스템, 터미널을 도구로 쓰는 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를 토큰 미터 없이 제공합니다. 세션 하나는 한 번에 요청 하나를 실행하므로 에이전트 하나에 맞습니다. 에이전트를 병렬로 돌리거나 서브에이전트를 띄우는 에이전트를 쓴다면, 동시에 실행되는 요청마다 세션을 하나씩 구매하세요. 계산 방법은 세션 가이드에 있습니다.