Edgee: 코딩 에이전트를 관리하는 AI 게이트웨이

Edgee는 코딩 에이전트와 LLM 제공사 사이에서 모델 호출을 관리하는 AI 게이트웨이입니다. 공식 명칭은 Agent Gateway이며, 모델 라우팅과 토큰 압축, 사용량 및 비용 관측을 묶어 제공합니다. Claude Code나 Codex를 이미 쓰고 있는 개발자가 실제 AI 지출을 확인하거나, 팀 전체의 사용 현황을 정리할 때 검토할 수 있습니다.

쉽게 말해 Edgee는 어떤 일을 하는 사이트인가요?

AI 코딩 도구에서 요청을 보내면 그 요청이 모델에 도착하기 전에 Edgee를 통과하도록 연결합니다. 이 과정에서 설정한 규칙에 따라 모델을 선택하고, 일부 도구 내용의 불필요한 토큰을 줄이며, 어떤 모델을 얼마나 사용했는지 기록합니다. 웹사이트의 콘솔은 이 기록을 확인하고 설정을 관리하는 곳이고, CLI는 로컬 개발 환경을 연결하는 도구입니다.

예를 들어 코드 수정 작업 하나가 여러 번의 모델 호출로 이어질 때, 개발자는 결과만 보고 전체 비용을 짐작하기 쉽습니다. Edgee에서는 세션에 실제로 발생한 호출과 비용을 살펴볼 수 있습니다. 도입 목적은 이러한 개발 작업을 측정하고 조정하는 데 있습니다. 먼저 자신의 코딩 도구와 계정 구성이 공식 문서의 지원 범위에 맞는지 확인하는 것이 좋습니다.

개발자와 저장소별로 AI 비용을 살펴보기

개인에게는 세션별 모델 사용량과 비용이 기본 확인 대상입니다. Team에서는 개발자, 저장소, Pull Request 단위의 비용을 살펴보는 기능과 GitHub 연동을 제공합니다. 팀 전체 사용량이 늘었을 때 어떤 작업이나 개발 환경에서 지출이 발생하는지 찾아보는 데 도움이 됩니다.

숫자를 비교할 때에는 작업 결과도 함께 보아야 합니다. 저렴한 모델로 바꾼 뒤 재작업이 늘었다면 토큰 단가만으로 효율을 판단하기 어렵습니다. 동일한 유형의 작업을 골라 변경 전후의 결과와 세션 비용을 함께 확인하는 방식이 유용합니다. Team에는 skills, hooks, MCP 서버 같은 플러그인을 관리하는 기능도 있어 공통 개발 환경을 운영할 때 검토할 수 있습니다.

Claude Code·Codex 연결부터 사용 기록 확인까지

Edgee 계정과 조직 접근 권한, 설치된 지원 코딩 에이전트가 필요합니다. 공식 시작 안내는 macOS와 Linux, Homebrew, Windows PowerShell에 맞는 설치 방법을 제공합니다.

1. 운영체제에 맞게 CLI를 설치하고 edgee --version으로 설치 여부를 확인합니다.
2. 프로젝트에서 edgee launch claude 또는 edgee launch codex를 실행합니다.
3. 브라우저에서 로그인하고 사용할 조직을 선택합니다.
4. 작은 작업을 요청해 실제 모델 호출을 발생시킵니다.
5. 같은 조직의 Sessions에서 에이전트, 요청, 모델 사용량과 비용을 확인합니다. edgee stats로 통계도 볼 수 있습니다.

프로그램만 실행하고 모델을 호출하지 않았다면 세션 기록이 보이지 않을 수 있습니다. 기록이 없을 때는 실제 요청 발생 여부와 현재 선택한 조직부터 확인하세요. 완료 기준을 “CLI 실행 성공”보다 “실제 요청과 비용이 확인됨”으로 잡으면 연결 상태를 판단하기 쉽습니다.

공식 가이드는 OpenCode, Cursor, GitHub Copilot도 다룹니다. 애플리케이션에는 OpenAI·Anthropic 호환 API를 제공하며, 문서에 맞는 게이트웨이 주소와 키 설정이 필요합니다. BYOK를 이용하면 보유한 제공사 키를 등록할 수 있습니다. OpenAI, Anthropic, Gemini／Vertex AI, AWS Bedrock, Azure OpenAI와 사용자 지정 OpenAI 호환 엔드포인트 등이 문서에 포함됩니다.

라우팅과 압축 설정을 검증하는 방법

라우팅 전략은 요청 모델을 바꾸거나, 사용 가능한 대체 경로를 선택하거나, 예산 사용에 따라 규칙을 바꾸는 데 쓰입니다. Smart routing은 현재 Beta이며 작업 복잡도를 분류해 설정된 모델을 선택합니다. 장애 시 전환은 모델, 인증 정보, 제공사 상태와 지출 제한에 따라 달라집니다. 예산에 도달한 뒤 계속 처리할지 차단할지도 설정해야 합니다.

토큰 압축 문서에는 도구 결과 정리, 모델에 전달할 도구 정의 축소, 출력 간결화라는 세 가지 제어가 설명되어 있습니다. CLI의 기본값은 도구 결과 정리만 활성화하며 나머지는 선택해서 켭니다. 설정을 바꾼 후에는 새 세션에서 대표 작업을 실행하고 Sessions 또는 Logs의 절감 지표와 작업 품질을 확인하세요.

압축 대상이 되는 도구 내용이 없으면 입력 토큰이 줄지 않을 수도 있습니다. 공식 페이지의 운영 통계와 벤치마크, 최대 절감 수치는 조건이 다르므로 자신의 청구액에 그대로 적용할 수 없습니다. 작은 실험으로 필요한 설정을 찾는 편이 실제 효과를 확인하는 데 유용합니다.

무료 요금제와 실제 모델 사용료 구분하기

2026년 10월 13일 확인한 미국 달러 기준으로 Free는 개발자 한 명에게 월 US$0이며 압축과 개인용 사용량·비용·세션 대시보드를 포함합니다. Team은 개발자 한 명당 월 US$30, Enterprise는 별도 견적입니다. Enterprise에는 프라이빗 게이트웨이와 SSO／SAML 같은 기업용 선택 사항이 있습니다.

모델 사용료는 따로 계산해야 합니다. Edgee 크레딧을 충전하면 Free에는 5% 충전 수수료가 붙고 Team／Enterprise에는 **0%**로 표시됩니다. BYOK 수수료는 모든 요금제에서 **0%**이지만 제공사 청구액과 적용되는 플랫폼 구독료는 남습니다. 원화 금액이나 국내 세금계산서 발행 조건은 여기서 확인되지 않았으므로 공식 요금표와 계약 조건을 기준으로 판단해야 합니다.

라우팅 전략의 사용 가능 요금제는 공식 요금표와 소개 페이지의 설명이 서로 다릅니다. 이 기능이 도입의 필수 조건이라면 구매 전에 실제 계정에서의 제공 범위를 확인해야 합니다.

코드와 API 키는 어떻게 처리되나요?

개인정보 처리방침에 따르면 프롬프트와 응답 내용은 기본적으로 메모리에서 처리하고 저장하지 않습니다. 사용자가 Debug를 켜면 내용이 최대 30일 보관될 수 있으며, 사용량과 운영 메타데이터는 최대 25개월 보관될 수 있습니다. Edgee는 고객 프롬프트, 응답, 사용량 메타데이터를 모델 학습이나 미세 조정에 사용하지 않는다고 명시합니다.

Debug에는 소스 코드, 도구 결과와 개인정보가 포함될 수 있으므로 회사 코드를 연결하기 전 설정을 확인하세요. 연결된 모델 제공사의 정책도 별도로 적용됩니다. BYOK 키는 저장 시 암호화되지만 제공사에 요청할 때 게이트웨이가 복호화해 사용합니다. 자체 호스팅은 라이선스가 필요한 전용 게이트웨이 배포이며 Docker Compose와 Kubernetes／Helm 안내가 있습니다.

자주 묻는 질문

기존 API 구조를 전부 바꿔야 하나요?

Edgee는 OpenAI·Anthropic 호환 API와 여러 코딩 에이전트용 가이드를 제공합니다. 기존 클라이언트에서 문서가 요구하는 주소와 키를 설정하고, 사용 중인 모델 기능이 맞게 작동하는지 작은 요청으로 확인하는 과정이 필요합니다.

API 키의 보관 방식은 무엇인가요?

BYOK로 등록한 제공사 키는 저장 상태에서 암호화되고 생성 후에는 마스킹됩니다. 호출 시에는 게이트웨이가 키를 복호화하므로, 이를 종단간 암호화나 제공사 접근이 불가능한 구조로 해석하면 안 됩니다.

사용량과 비용은 어디서 확인하나요?

콘솔의 Sessions에서 실제 요청과 모델, 비용을 확인하거나 edgee stats를 실행할 수 있습니다. 개발자·저장소·PR 단위의 팀 분석은 Team 기능 범위를 확인하세요.

무료로 시작해도 모델 비용이 발생하나요?

그렇습니다. Free는 플랫폼 요금제이며 모델 토큰을 무제한 무료로 제공한다는 뜻은 아닙니다. Edgee 크레딧 방식과 BYOK 방식의 청구 주체와 수수료를 각각 확인해야 합니다.

공식 문서와 개발자 커뮤니티

• Edgee 공식 문서: 에이전트 연결과 API 설정 확인.
• GitHub CLI 저장소: CLI 관련 개발 정보 확인.
• 공식 Discord 입구: 개발자 커뮤니티 참여.
• 서비스 상태 페이지: 장애와 연결 문제 점검.
• 기업용 문의: 계약, 라이선스와 프라이빗 배포 상담.