코딩 도구
GitHub Copilot CLI
BYOK을 사용하여 GitHub Copilot CLI를 TokenLab에 연결
개요
GitHub Copilot CLI는 OpenAI Chat Completions 호환 엔드포인트라면 무엇이든 연결할 수 있습니다. TokenLab은 Copilot CLI의 BYOK 환경 변수를 통해 작동합니다.
설치
Node.js 22 이상 버전에서 npm을 통해 설치합니다:
npm install -g @github/copilot@1.0.85macOS 또는 Linux에서는 Homebrew를 사용할 수도 있습니다:
brew install --cask copilot-cli설치를 확인합니다:
copilot --versionTokenLab 구성
Copilot CLI를 시작하기 전에 공급자 변수를 설정하십시오:
macOS, Linux, WSL 또는 Windows PowerShell용 빠른 시작 터미널 지침을 사용하여 명령 기록에 키를 남기지 않고 TOKENLAB_API_KEY를 설정하십시오. 해당 터미널에서 Copilot CLI를 실행하십시오. 지속적으로 사용하려면 로컬 보안 관리자를 사용하십시오. 셸 프로필에 일반 텍스트 키를 추가하지 마십시오.
이 변수들은 이번 실행에만 적용됩니다. 저장된 계정, 기본 모델 및 권한 설정은 그대로 유지됩니다. 이전 설정을 사용하려면 변수 없이 평소처럼 실행하십시오. 셸 프로필에 해당 변수를 영구적으로 저장하지 마십시오.
COPILOT_PROVIDER_TYPE=openai COPILOT_PROVIDER_BASE_URL=https://api.tokenlab.sh/v1 COPILOT_PROVIDER_API_KEY="${TOKENLAB_API_KEY:?Set TOKENLAB_API_KEY first}" copilot --model claude-sonnet-5-5| 변수 | TokenLab 값 |
|---|---|
COPILOT_PROVIDER_TYPE | openai |
COPILOT_PROVIDER_BASE_URL | https://api.tokenlab.sh/v1 |
COPILOT_PROVIDER_API_KEY | 귀하의 TokenLab API 키 |
COPILOT_MODEL | 라이브 모델 ID (예: claude-sonnet-5-5) |
GitHub은 선택한 모델이 스트리밍과 도구 호출(tool calling)을 모두 지원할 것을 요구합니다. claude-sonnet-5-5는 도구 호출을 지원하며 GitHub 권장 최소 사양인 128K보다 큰 컨텍스트 윈도우를 가지고 있습니다.
확인
Copilot CLI 내에서 먼저 다음과 같이 읽기 전용 작업을 요청해 보십시오:
Inspect this repository and summarize its top-level structure. Do not modify files.설정을 저장하거나 모델을 나열하는 것만으로는 키나 완료된 요청을 확인할 수 없습니다. 프롬프트 사용 시 TokenLab 잔액이 차감됩니다. 도구를 사용하기 전에 응답과 해당 요청 기록을 확인하십시오. 보조 요청도 비용이 청구될 수 있습니다.
Copilot CLI가 문서화하는 공급자 설정을 보려면 다음을 실행하십시오:
copilot help providers동일한 에이전트에서 이미지 및 비디오 생성
Copilot CLI는 TokenLab MCP 서버를 사용하여 이미지와 짧은 비디오를 생성할 수도 있습니다. 각 생성 작업은 동일한 TokenLab 잔액에서 차감됩니다. 이 항목을 ~/.copilot/mcp-config.json에 병합하십시오. Copilot CLI는 PATH만 서버로 전달하므로 두 변수 모두 env에 넣어야 합니다:
{
"mcpServers": {
"tokenlab": {
"type": "local",
"command": "npx",
"args": ["-y", "@tokenlabai/mcp-server@0.6.48"],
"env": {
"TOKENLAB_MCP_TOOL_PROFILE": "core",
"TOKENLAB_API_KEY": "<TOKENLAB_API_KEY>"
},
"tools": ["*"]
}
}
}이 로컬 파일에서 <TOKENLAB_API_KEY>를 귀하의 키로 교체하십시오. Copilot CLI를 시작하고 /mcp show 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를 호출합니다. 다른 설정은 Copilot CLI에 MCP 서버 추가를 참조하십시오.
문제 해결
Git으로 추적되는 셸 스크립트나 도트파일(dotfiles)에 API 키를 커밋하지 마십시오. 터미널 기록, 스크린샷 또는 로그에 노출된 키는 즉시 교체(rotate)하십시오.