코딩 도구
OpenCode
TokenLab API를 사용하도록 OpenCode 구성하기
에이전트에게 설정 맡기기
이 작업을 컴퓨터에서 실행 중인 에이전트에 복사하세요:
Read this guide and help me connect OpenCode to TokenLab:
https://tokenlab.sh/docs/ko/integrations/opencode
Check my installed version and active configuration first.
Preserve existing accounts, providers, permissions and other settings.
Back up local files and show proposed changes.
Have me enter any API key locally; never ask for, print or paste it in chat.
Check configuration loading first.
Explain any paid request test separately before running it.개요
OpenCode는 사용자 지정 OpenAI 호환 공급자를 통해 TokenLab을 사용할 수 있습니다. TokenLab API 키, Base URL 및 현재 모델 ID를 추가하세요.
설치
npm install -g opencode-ai@1.18.31설치 확인:
opencode --version구성
1단계: 환경 변수 설정
macOS, Linux, WSL 또는 Windows PowerShell용 빠른 시작 터미널 지침을 사용하여 명령 기록에 키를 남기지 않고 TOKENLAB_API_KEY를 설정하세요. 해당 터미널에서 OpenCode를 실행합니다. 지속적인 사용을 위해서는 로컬 보안 관리자를 사용하세요. 셸 프로필에 일반 텍스트 키를 추가하지 마세요.
2단계: OpenCode 구성
아래 구성은 OpenCode 1.18.31 버전에서 확인되었습니다. 다른 버전은 공식 문서를 참조하여 별도의 확인이 필요합니다.
아래 구성을 사용하여 별도의 ~/.config/opencode/tokenlab.jsonc 파일을 만듭니다. XDG_CONFIG_HOME이 설정되어 있다면 해당 디렉토리 아래의 opencode/tokenlab.jsonc를 사용하세요. 기존의 opencode.json / opencode.jsonc, 계정, 기본 모델 및 권한은 변경하지 마세요. 이 별도의 파일은 OPENCODE_CONFIG로 선택하여 호출할 때만 로드됩니다. 파일이나 공급자 이름이 이미 다른 설정에 사용 중이라면, 다른 파일명/이름을 선택하고 명령어를 조정하세요.
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"tokenlab": {
"npm": "@ai-sdk/openai-compatible",
"name": "TokenLab",
"options": {
"baseURL": "https://api.tokenlab.sh/v1",
"apiKey": "{env:TOKENLAB_API_KEY}"
},
"models": {
"gpt-5.6-terra": {
"name": "GPT-5.6 Terra"
},
"gpt-5.6-luna": {
"name": "GPT-5.6 Luna"
}
}
}
}
}이 구성은 Chat Completions을 위해 @ai-sdk/openai-compatible을 사용합니다. Chat Completions 및 필요한 도구를 지원하는 최신 모델을 선택하세요. 이 예시로부터 다른 프로토콜이나 버전에 대한 지원을 추론하지 마세요.
선택 사항: 가역적 OpenCode 설정 도우미는 Python 3.11+ 환경에서 미리보기, 적용 및 원본 파일 복원 기능을 제공합니다. TokenLab Skills 플러그인 0.1.2에는 이러한 스크립트가 포함되어 있습니다. 독립형 Skill 설치도 해당 스크립트가 포함된 버전으로 업데이트한 후 사용할 수 있습니다. 기존 플러그인이나 독립형 Skill 설치의 경우, README 업데이트 지침을 따르고 스크립트가 존재하는지 확인하세요. 여기서 설명하는 수동 구성은 도우미 없이도 사용할 수 있습니다.
기본 사용법
Quickstart를 사용하여 키를 설정한 다음, 이 파일을 로드하고 해당 호출에 사용할 모델을 명시적으로 선택하세요. 사용자 정의한 경우 실제 경로와 공급자 이름을 대체하세요. 기존의 OPENCODE_CONFIG 또는 인라인 OPENCODE_CONFIG_CONTENT 설정은 별도의 실행 환경에 유지하세요. 프로젝트 및 관리형 설정이 우선할 수 있습니다.
OPENCODE_CONFIG="${XDG_CONFIG_HOME:-$HOME/.config}/opencode/tokenlab.jsonc" opencode models tokenlab
OPENCODE_CONFIG="${XDG_CONFIG_HOME:-$HOME/.config}/opencode/tokenlab.jsonc" opencode --model tokenlab/gpt-5.6-terra모델 검색은 로컬 로딩을 확인하며, 키의 유효성이나 실제 요청 성공 여부를 확인하지는 않습니다. 프롬프트는 TokenLab 잔액을 사용하며, OpenCode는 제목 생성과 같이 별도로 청구되는 보조 요청을 보낼 수 있습니다. 응답과 일치하는 요청 기록을 확인하세요.
일반 설정을 사용하려면 이 레이어 없이 실행하세요. 이 가이드를 위해 OPENCODE_CONFIG를 셸 프로필에 영구적으로 저장하지 마세요. 수동 설정을 취소하려면 생성한 별도의 파일만 삭제하거나, 이전에 백업이 있었다면 복원하세요.
동일한 에이전트에서 이미지 및 비디오 생성
OpenCode는 TokenLab MCP 서버를 사용하여 이미지와 짧은 비디오를 생성할 수도 있습니다. 각 생성 작업은 동일한 TokenLab 잔액에서 차감됩니다. 이 mcp 항목을 provider 옆의 동일한 tokenlab.jsonc에 병합하세요. OpenCode는 {env:TOKENLAB_API_KEY}를 터미널의 변수로 대체하므로 키가 파일에 기록되지 않습니다:
{
"mcp": {
"tokenlab": {
"type": "local",
"command": ["npx", "-y", "@tokenlabai/mcp-server@0.6.48"],
"environment": {
"TOKENLAB_MCP_TOOL_PROFILE": "core",
"TOKENLAB_API_KEY": "{env:TOKENLAB_API_KEY}"
},
"timeout": 30000
}
}
}더 긴 timeout 설정은 첫 시작 시 npx가 패키지를 다운로드할 시간을 제공합니다. 동일한 OPENCODE_CONFIG로 opencode mcp list를 실행하여 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를 호출합니다. 다른 설정은 OpenCode MCP 서버를 참조하세요.
모델 선택
모델 페이지에서 현재 코딩 모델 ID를 복사하세요. 기본값을 설정하기 전에 자신의 저장소에서 모델을 비교해 보세요.
일반 명령어
코드 분석:
OPENCODE_CONFIG="${XDG_CONFIG_HOME:-$HOME/.config}/opencode/tokenlab.jsonc" opencode run --model tokenlab/gpt-5.6-terra "What does this function do?" < src/utils.ts코드 생성:
OPENCODE_CONFIG="${XDG_CONFIG_HOME:-$HOME/.config}/opencode/tokenlab.jsonc" opencode run --model tokenlab/gpt-5.6-terra "Create a REST API with Express"변경 사항 검토:
git diff | OPENCODE_CONFIG="${XDG_CONFIG_HOME:-$HOME/.config}/opencode/tokenlab.jsonc" opencode run --model tokenlab/gpt-5.6-terra "Review these changes"오류 수정:
OPENCODE_CONFIG="${XDG_CONFIG_HOME:-$HOME/.config}/opencode/tokenlab.jsonc" opencode run --model tokenlab/gpt-5.6-terra "Fix the TypeScript errors in this project"대화형 명령어
| 명령어 | 설명 |
|---|---|
/help | 사용 가능한 명령어 표시 |
/models | 다른 모델로 전환 |
/clear | 대화 기록 지우기 |
/exit | OpenCode 종료 |