코딩 에이전트 설정 및 개발자 리소스

AI 코딩 에이전트는 특정 날짜에 종료되는 학습 데이터를 사용합니다. 이로 인해 상담사는 지원 중단된 모델 (gemini-1.5), 이전 SDK(google-generativeai), 오래된 코드 패턴을 제안하는 경우가 많습니다.

공식 Gemini 개발자 리소스에 에이전트를 연결하면 현재 모델, google-genai SDK, 상호작용 API를 사용하여 정확한 코드를 작성할 수 있습니다.

다음 네 가지 방법으로 코딩 에이전트에게 Gemini 문서 및 규칙에 대한 액세스 권한을 부여할 수 있습니다.

상담사 리소스 요약

Gemini 에이전트 스킬 설치

에이전트 기술은 코딩 에이전트에게 절차적 규칙, 현재 모델 이름, SDK 코드 패턴을 제공합니다. 프롬프트에 긴 요청 사항을 추가하는 대신 에이전트는 필요할 때만 각 스킬을 로드합니다. 이렇게 하면 에이전트가 지원 중단된 SDK를 피하고 최신 Gemini 패턴을 사용할 수 있습니다.

스킬은 Gemini Docs MCP 서버와 함께 작동합니다. 에이전트에 MCP 서버가 설치되어 있지 않으면 스킬이 llms.txt으로 대체됩니다. 스킬의 작동 방식에 대해 자세히 알아보려면 Gemini API 스킬 가이드를 참고하세요.

CLI (skills.sh 또는 Context7)를 사용하여 설치

skills.sh (권장) 또는 Context7을 사용하여 스킬을 설치합니다.

# List all available skills in the repository
npx skills add google-gemini/gemini-skills --list

# Install a specific skill globally with skills.sh
npx skills add google-gemini/gemini-skills --skill <skill-name> --global

# Or install with Context7
npx ctx7 skills install /google-gemini/gemini-skills <skill-name>

사용 가능한 스킬

gemini-api-dev

Interactions API 및 공식 Gemini API SDK(Python용 google-genai, TypeScript용 @google/genai)로 애플리케이션을 빌드하는 스킬입니다. 이 기술에서는 다음을 다룹니다.

• 텍스트 생성, 멀티턴 채팅, 스트리밍, 구조화된 출력, 함수 호출
• 이미지 생성, 텍스트 음성 변환 (TTS), 멀티모달 입력
• 서버 측 대화 상태 관리, 백그라운드 실행, 심층 연구, 관리형 에이전트
• 현재 모델 이름 및 기존 generateContent 또는 google-generativeai 코드 이전

npx skills add google-gemini/gemini-skills --skill gemini-api-dev --global

gemini-live-api-dev

Gemini Live API를 사용하여 실시간 오디오 및 동영상 스트리밍 애플리케이션을 빌드하는 스킬 이 스킬에서는 다음을 다룹니다.

• WebSocket 세션 관리, 일회성 클라이언트 토큰, 세션 재개
• 음성 활동 감지 (VAD) 및 끼어들기 지원을 사용하여 오디오, 동영상, 텍스트 스트리밍
• 백그라운드 추론 (확장된 사고), 차단되지 않는 비동기 도구 호출, 스크립트 작성, 실시간 음성 번역

npx skills add google-gemini/gemini-skills --skill gemini-live-api-dev --global

gemini-omni-flash-api

Interactions API를 사용하여 Gemini Omni Flash로 동영상을 생성하고 편집하는 스킬입니다. 도우미 스크립트 (upload_file.py, generate_video.py, prep_video.py, inspect_video.py)를 포함하며 다음을 다룹니다.

• 텍스트 동영상 변환 생성 및 프롬프트 작성
• 첫 번째 및 마지막 프레임 전환과 참조 기반 동영상 생성
• 동영상 확장 프로그램 및 미디어 사전 처리 워크플로

npx skills add google-gemini/gemini-skills --skill gemini-omni-flash-api --global

관리형 에이전트에서 스킬 마운트

Interactions API로 원격 관리 에이전트를 실행하면 google-gemini/gemini-skills 저장소를 에이전트의 워크스페이스에 마운트할 수 있습니다. 자세한 내용은 Gemini API 스킬 가이드를 참고하세요.

from google import genai

client = genai.Client()

interaction = client.interactions.create(
    agent="antigravity-preview-09-2026",
    input="Build a script that generates a 5-second video of a neon cityscape.",
    environment={
        "type": "remote",
        "sources": [
            {
                "type": "repository",
                "source": "https://github.com/google-gemini/gemini-skills",
                "target": ".agents",
            }
        ],
    },
)

Gemini Docs MCP 서버 연결

공개 Gemini Docs MCP 서버 (https://gemini-api-docs-mcp.dev)를 사용하면 에이전트가 전체 문서 사이트에 실시간으로 액세스할 수 있습니다. 에이전트는 문서 페이지를 검색하고 읽어 요청 스키마, 모델 한도, 새로운 기능을 확인할 수 있습니다.

• gemini_search_docs: 주제 또는 쿼리로 Gemini API 참고 리소스를 검색합니다.
• gemini_get_doc: 특정 문서 페이지의 전체 마크다운 콘텐츠를 읽습니다.

빠른 설정

터미널 또는 프로젝트 루트에서 다음 명령어를 실행하여 감지된 코딩 에이전트를 자동으로 구성합니다.

npx add-mcp "https://gemini-api-docs-mcp.dev"

환경별 구성

$ claude mcp add --transport http geminiDocs https://gemini-api-docs-mcp.dev

{
  "mcpServers": {
    "geminiDocs": {
      "url": "https://gemini-api-docs-mcp.dev"
    }
  }
}

$ codex mcp add geminiDocs --url https://gemini-api-docs-mcp.dev

[mcp_servers.geminiDocs]
url = "https://gemini-api-docs-mcp.dev"

{
  "servers": {
    "geminiDocs": {
      "type": "http",
      "url": "https://gemini-api-docs-mcp.dev"
    }
  }
}

Gemini API 플러그인

Antigravity를 사용하는 경우 Gemini API 플러그인을 사용하면 작업공간을 가장 빠르게 설정할 수 있습니다. Gemini Docs MCP 서버, 모든 공식 Gemini 스킬 (gemini-api-dev, gemini-live-api-dev, gemini-omni-flash-api), API 키 도구를 하나의 다운로드로 번들링합니다.

• Antigravity에 설치 (UI): 설정 > 맞춤설정 > Google 플러그인으로 빌드로 이동하여 Gemini API를 다운로드합니다.
• CLI를 사용하여 설치: bash agy plugin install https://github.com/google-gemini/gemini-skills

기계가 읽을 수 있는 문서

표준 웹페이지에는 컨텍스트 창 공간을 차지하는 HTML 태그, 탐색 메뉴, 스크립트가 포함됩니다. ai.google.dev는 에이전트와 스크립트가 깨끗한 마크다운을 직접 가져올 수 있도록 머신 리더블 엔드포인트를 제공합니다.

• llms.txt 색인 (https://ai.google.dev/gemini-api/docs/llms.txt): 각 페이지로 연결되는 링크와 함께 모든 Gemini API 문서 페이지를 나열합니다.
• 직접 마크다운 URL (.md.txt): ai.google.dev의 문서 URL (예: https://ai.google.dev/gemini-api/docs/coding-agents.md.txt)에 .md.txt를 추가하여 저장된 프롬프트, AGENTS.md 규칙 또는 자동 스크립트의 깨끗한 마크다운 소스를 가져옵니다.

추천 프로젝트 규칙 (AGENTS.md개)

프로젝트 규칙 파일 (AGENTS.md, .cursorrules 또는 CLAUDE.md)은 모든 에이전트 세션 시작 시 로드되는 기준 규칙을 설정합니다. 코딩 에이전트가 기본적으로 현재 모델과 SDK를 사용하도록 프로젝트 루트에 다음 가이드라인을 추가합니다.

# Gemini API Guidelines

- Before writing Gemini API code, consult the `geminiDocs` MCP server (`gemini_search_docs` / `gemini_get_doc`) or `https://ai.google.dev/gemini-api/docs/llms.txt`.
- Always use the current Gemini API SDK (`google-genai` for Python, `@google/genai` for TypeScript/JavaScript). Never use legacy SDKs (`google-generativeai` or `@google/generative-ai`).
- Use the Interactions API (`client.interactions.create`) for new applications unless a specific feature requires `generateContent`.
- Use current recommended models (see https://ai.google.dev/gemini-api/docs/models) and avoid deprecated models.

확인 및 문제 해결

설정 확인

설정을 테스트하려면 코딩 에이전트에게 다음 질문을 하세요.

Look up the request schema for the Gemini Interactions API in the documentation.

구성된 에이전트는 geminiDocs MCP 서버에서 gemini_search_docs를 사용하고 google-genai 또는 @google/genai SDK와 함께 client.interactions.create를 사용하여 코드를 작성합니다.

상태 명령어

문제 해결

• 스킬 또는 MCP 서버가 감지되지 않음: 편집기 (Cursor 또는 VS Code) 또는 터미널 세션 (Claude Code 또는 Codex)을 다시 시작합니다. 대부분의 에이전트는 시작할 때만 MCP 서버와 스킬을 로드합니다.
• 전역 스킬 충돌: 에이전트가 전역으로 설치된 스킬을 무시하는 경우 --global 없이 프로젝트 루트에 스킬을 설치합니다. bash npx skills add google-gemini/gemini-skills --skill gemini-api-dev
• 규칙 무시됨: AGENTS.md, .cursorrules 또는 CLAUDE.md 파일이 프로젝트의 루트 디렉터리에 있는지 확인합니다.

다음 단계

• Gemini API 스킬 가이드
• GitHub의 Gemini API 기술
• Interactions API
• 사용 가능한 모델
• 라이브러리 및 SDK