코딩 도구
Gemini CLI
TokenLab API를 사용하도록 Google Gemini CLI 구성하기
개요
Gemini CLI 0.60.0은 API 키 인증을 위한 GOOGLE_GEMINI_BASE_URL을 지원합니다. gemini_generate_content를 지원하는 최신 모델과 함께 TokenLab의 Gemini 전용 엔드포인트를 사용하십시오. 공식 구성 참조 및 인증 가이드를 확인하시기 바랍니다. 이 설정은 Google 구독을 TokenLab을 통해 라우팅하지 않습니다.
설치
Gemini CLI 0.60.0은 Node.js 20 이상이 필요합니다.
npm install -g @google/gemini-cli@0.60.0
gemini --version구성
macOS, Linux, WSL 또는 Windows PowerShell용 빠른 시작 터미널 지침을 사용하여 명령 기록에 키를 남기지 않고 TOKENLAB_API_KEY를 설정하십시오. 해당 터미널에서 Gemini CLI를 실행하십시오. 지속적인 사용을 위해서는 로컬 보안 관리자를 사용하시고, 셸 프로필에 일반 텍스트 키를 추가하지 마십시오.
기존 Google 로그인 및 구성을 유지하십시오. 별도의 TokenLab 실행을 위해 ~/.gemini-tokenlab (PowerShell의 경우 $HOME)과 같이 사용하지 않는 구성 루트를 선택하고 .gemini 디렉토리를 생성하십시오. 기존의 .gemini/settings.json 및 설정에 필요한 정책 파일을 해당 위치로 복사하되, 권한, 샌드박스 및 관련 없는 설정은 그대로 유지하십시오. 복사본에만 다음 인증 필드를 병합하십시오(설정 파일이 없는 경우 생성). OAuth 캐시를 복사하거나 기존 자격 증명을 삭제하지 마십시오. 관리형 인증 정책을 재정의하지 말고 그대로 따르십시오.
{
"security": {
"auth": {
"selectedType": "gemini-api-key"
}
}
}사용법
아래 실행 명령은 ~/.gemini-tokenlab/.gemini/settings.json을 사용합니다. 다른 루트를 선택한 경우 경로를 조정하십시오. Gemini의 일반적인 신뢰 프롬프트를 통해 작업 디렉토리를 승인하고, 기존 도구 승인 정책을 유지하십시오. 모델은 이 세션에 대해 명시적으로 선택됩니다.
GEMINI_CLI_HOME="$HOME/.gemini-tokenlab" GEMINI_API_KEY="${TOKENLAB_API_KEY:?Set TOKENLAB_API_KEY first}" GOOGLE_GEMINI_BASE_URL=https://api.tokenlab.sh gemini --model gemini-3.8-flash이 변수들은 이번 실행에만 적용되며, 저장된 계정, 기본 모델 및 권한 설정은 그대로 유지됩니다. 이전 설정을 사용하려면 변수 없이 평소처럼 실행하십시오. 셸 프로필에 이 변수들을 영구적으로 저장하지 마십시오.
확인
설정을 저장하거나 모델을 나열하는 것만으로는 키나 완료된 요청이 확인되지 않습니다. 프롬프트 사용 시 TokenLab 잔액이 차감됩니다. 도구를 사용하기 전에 응답과 해당 요청 기록을 확인하십시오. 보조 요청도 비용이 청구될 수 있습니다.
Reply only with TOKENLAB_CONNECTION_OK. Do not use tools or modify files.동일한 에이전트에서 이미지 및 비디오 생성
Gemini CLI는 TokenLab MCP 서버를 사용하여 이미지와 짧은 비디오를 생성할 수도 있습니다. 각 생성 작업은 동일한 TokenLab 잔액에서 차감됩니다. 이 항목을 TokenLab 설정 복사본인 ~/.gemini-tokenlab/.gemini/settings.json에 병합하십시오. Gemini CLI는 실행 환경에서 $TOKENLAB_API_KEY를 읽어오므로 키가 파일에 기록되지 않습니다.
{
"mcpServers": {
"tokenlab": {
"command": "npx",
"args": ["-y", "@tokenlabai/mcp-server@0.6.48"],
"env": {
"TOKENLAB_MCP_TOOL_PROFILE": "core",
"TOKENLAB_API_KEY": "$TOKENLAB_API_KEY"
}
}
}
}위의 실행 명령으로 Gemini CLI를 시작하고 /mcp를 실행하십시오. tokenlab 서버가 연결된 것으로 표시되어야 합니다. 연결되지 않은 경우 작업 폴더를 신뢰하십시오. 그런 다음 다음을 시도해 보십시오:
Call get_model_pricing for nano-banana-2, then use create_image with nano-banana-2 at 1k to make a photo of a matte black coffee mug on a white desk.create_video는 작업 ID를 반환합니다. 에이전트는 비디오가 준비될 때까지 get_task_status를 호출합니다. 다른 설정에 대해서는 Gemini CLI MCP 가이드를 참조하십시오.