OpenCode

기존 에이전트에 설정 맡기기Copy Anchor Link

컴퓨터에서 이미 사용할 수 있는 에이전트에 다음 작업을 복사해 전달하세요.

이 가이드를 읽고 OpenCode의 TokenLab 연결을 도와주세요:
https://tokenlab.sh/docs/ko/integrations/opencode
설치된 버전과 현재 적용된 설정을 먼저 확인하세요.
기존 계정, 제공자, 권한 및 기타 설정을 보존하세요.
로컬 파일을 백업하고 변경할 내용을 보여 주세요.
필요한 API 키는 제가 로컬로 입력하겠습니다. 채팅에서 키를 요구하거나 출력하거나 붙여 넣지 마세요.
먼저 설정이 정상적으로 로드되는지 확인하세요.
유료 요청 테스트는 실행 전에 비용을 별도로 설명하세요.

개요Copy Anchor Link

OpenCode는 터미널에서 실행되는 오픈소스 AI 코딩 도우미입니다. 여러 LLM 제공자를 지원하며, 수백 개의 모델에 접근할 수 있도록 TokenLab API를 사용하도록 구성할 수 있습니다.

설치Copy Anchor Link

OpenCode

npm install -g opencode-ai@1.18.31

설치 확인:

opencode --version

구성Copy Anchor Link

1단계: 환경 변수 설정Copy Anchor Link

빠른 시작의 macOS, Linux, WSL 또는 Windows PowerShell 절차로 키를 명령 기록에 남기지 않고 TOKENLAB_API_KEY를 설정한 뒤 같은 터미널에서 OpenCode를 실행하세요. 계속 사용하려면 로컬 비밀 관리 도구를 이용하고 셸 프로필에 평문 키를 추가하지 마세요.

2단계: OpenCode 구성Copy Anchor Link

아래 설정은 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"
        }
      }
    }
  }
}

선택 사항: Python 3.11+의 복구 가능한 OpenCode 설정 도구로 변경 사항을 미리 보고 적용하거나 원본 파일을 복원할 수 있습니다. TokenLab Skills 플러그인 0.1.2에는 새 스크립트가 포함되어 있습니다. 독립 Skill도 스크립트가 포함된 버전으로 업데이트하면 사용할 수 있습니다. 기존 플러그인 또는 독립 Skill 설치는 README 업데이트 안내에 따라 업데이트하고 스크립트가 있는지 확인하세요. 이 페이지의 수동 설정만으로도 완료할 수 있습니다.

기본 사용법Copy Anchor Link

빠른 시작에 따라 키를 설정한 뒤 이번 실행에서만 파일을 로드하고 모델을 명시적으로 선택하세요. 사용자 지정 경로나 제공자 이름은 명령에도 반영합니다. 기존 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를 셸 프로필에 저장하지 마세요. 수동 설정을 되돌릴 때는 새로 만든 별도 파일만 삭제하거나 기존 파일의 백업을 복원하세요.

사용 가능한 모델Copy Anchor Link

자주 사용하는 명령어Copy Anchor Link

코드 분석:

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"

대화형 명령어Copy Anchor Link

문제 해결Copy Anchor Link

모범 사례Copy Anchor Link