GDIAX — 코딩 에이전트

VS Code 사이드바 에이전트 + MCP + 서브에이전트 + 인라인 편집 + SSO.

백엔드: https://api.gdiaxhub.com (LiteLLM → Qwen). 사내 API 키 필요.

주요 기능

에이전트 루프 — 파일 읽기/검색/수정, Git, Todo, 승인+diff, 감사 로그
서브에이전트 — spawn_subagent로 좁은 작업을 중첩 루프에 위임
MCP — gdiax.mcpServers로 stdio MCP 서버 연결 (mcp_<server>_<tool>)
웹 검색·조사 — 에이전트 도구 web_search/web_fetch, 채팅 /web <검색어> /fetch <URL>로 외부 문서·자료를 참고 (brave·bing·duckduckgo·searxng·brave-api·tavily·wikipedia, 자동 폴백)
컨텍스트 자동 관리 — 모델별 실측 컨텍스트(선택창에 NNK ctx 표시) 기반 자동 압축 + 한계 초과 시 요약 후 재시도, 압축 요약은 .gdiax/memory.md(시스템 관리 파일)에 보존되어 다음 대화에 재주입
외부 에이전트 위임 — /claude <작업>(Claude Code CLI)·/codex <작업>(Codex CLI gpt-5.5)로 고난도 작업을 headless 위임, 진행 상황 실시간 스트리밍 (로컬 우선 → 품질 중요 시 상용 에이전트)
인라인 — ghost text 자동완성 + 선택 영역 인라인 편집 (Ctrl/Cmd+Shift+G)
SSO — 포털 브라우저 로그인 / vscode:// 콜백 / 키 수동 입력

로그인 (SSO / 포털) → 브라우저에 https://api.gdiaxhub.com/ui/가 열리고, VS Code에는 키 입력창이 뜹니다.
포털(LiteLLM Dashboard)에 로그인 → Virtual Keys에서 키(sk-…) 발급/복사.
VS Code 입력창에 붙여넣기 → GET /v1/models로 검증 후 SecretStorage에 저장.
- 잘못된 키면 오류 원인을 보여주고 다시 입력받습니다.
- 키가 이미 있으면 명령 GDIAX: API 키로 로그인으로 바로 입력.
(선택) 포털이 vscode://gdiaxhub.gdiax-ai/auth-callback?api_key=sk-...로 되돌려 보내거나 gdiax.devicePollUrl이 설정돼 있으면 자동 수령.

영상 게이트웨이(flightbase.gdiaxhub.com) 키는 사용 불가.

MCP 설정 예

"gdiax.mcpServers": [
  {
    "name": "fs",
    "command": "npx",
    "args": ["-y", "@modelcontextprotocol/server-filesystem", "/home/gdi/dev3"]
  }
]

채팅에서 /mcp 또는 /mcp reload.

슬래시 커맨드

커맨드	설명
`/model` `/model <이름>`	모델 목록·전환
`/sel` `/file` `/tree [깊이]`	코드·구조 첨부
`/web <검색어>` `/fetch <URL>`	웹 검색 결과·페이지 본문을 컨텍스트로 첨부
`/webkey`	웹 검색 API 키 (brave-api·tavily)
`/agent [on\\|off]`	에이전트 모드
`/auto [on\\|off]`	오토모드 — 쓰기·명령 승인 생략 (승인창 `⚡ 오토모드` 버튼과 동일)
`/claude <작업>`	고난도 작업을 Claude Code CLI에 위임 (`-c`=직전 세션 이어서, `stop`=중단)
`/codex <작업>`	작업을 Codex CLI(gpt-5.5)에 위임 (`-c`=이어서, `stop`=중단)
`/mcp [reload]`	MCP 상태·재연결
`/audit`	감사 로그 채널
`/system` `/temp` `/clear` `/help`	기타

에이전트 도구

읽기: read_file list_dir search_text get_diagnostics git_status git_diff todo_write
쓰기(승인): replace_in_file write_file delete_file run_command — 승인창 버튼: 허용 · 이 대상 항상 허용 · ⚡ 오토모드(이후 전부 자동, /auto off 해제) · 거부
웹: web_search web_fetch (gdiax.web.enabled, 승인 없이 실행 · 내부/사설 주소 기본 차단)
위임: spawn_subagent
외부: mcp_* (연결된 MCP)

설정

항목	기본	설명
`gdiax.apiBase`	`https://api.gdiaxhub.com/v1`	API
`gdiax.model`	`gpt-oss-120b`	기본 모델 (OpenHASA 직결, `/hasakey` 필요)
`gdiax.authPortal`	`https://api.gdiaxhub.com`	SSO 포털
`gdiax.devicePollUrl`	(빈값)	디바이스 폴링 URL
`gdiax.inlineCompletion`	`true`	ghost text
`gdiax.mcpAutoApprove`	`true`	MCP 자동 승인
`gdiax.mcpServers`	`[]`	MCP stdio 목록
`gdiax.web.enabled`	`true`	웹 검색·페이지 읽기 사용
`gdiax.web.provider`	`brave`	검색 공급자 (brave·bing·duckduckgo·searxng·brave-api·tavily·wikipedia)
`gdiax.web.searxngUrl`	`""`	자체 SearXNG base URL
`gdiax.web.maxResults`	`5`	검색 결과 수
`gdiax.web.allowPrivateHosts`	`false`	localhost·사설망 접근 허용
`gdiax.compactThreshold`	`0`	압축 임계값 — 0=모델 컨텍스트 실측값 기반 자동

개발

npm install && npm run compile
npm run package
code --install-extension gdiax-ai-<version>.vsix

Developer: Reload Window 후 사용. 마켓플레이스 업데이트는 기존 gdiaxhub.gdiax-ai에 vsce publish(이름 변경 금지).

한계 (솔직히)

포털 device-auth API는 아직 백엔드에 없음 → SSO는 콜백/키 붙여넣기 중심
MCP는 stdio JSON-RPC 최소 구현 (tools/list·call)
서브에이전트는 단일 중첩, MCP/셸 미포함
키 없는 검색 엔진(brave·bing·duckduckgo)은 데이터센터 IP·과다 호출 시 429/봇 확인/무관한 결과가 잦음 → 안정적으로 쓰려면 /webkey로 Tavily·Brave API 키를 넣거나 자체 SearXNG(gdiax.web.searxngUrl)를 권장

라이선스

사내 전용. LICENSE 참고.

GDIAX

gdiaxhub