OpenCode

개요

유형: 코딩 도구주요 경로: OpenAI 호환지원 수준: 지원 경로

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

설치

설치 스크립트
Homebrew
Go

curl -fsSL https://opencode.ai/install | bash

brew install opencode-ai/tap/opencode

또는 커뮤니티 tap을 사용하세요(더 자주 업데이트됨):

brew install anomalyco/tap/opencode

go install github.com/opencode-ai/opencode@latest

설치 확인:

opencode --version

구성

1단계: 환경 변수 설정

export OPENAI_API_KEY="sk-your-tokenlab-key"

영구적으로 구성하려면 ~/.bashrc 또는 ~/.zshrc에 추가하세요:

echo 'export OPENAI_API_KEY="sk-your-tokenlab-key"' >> ~/.zshrc
source ~/.zshrc

2단계: OpenCode 구성

OpenCode의 현재 문서는 opencode.json 또는 opencode.jsonc를 통해 제공자를 구성할 것을 권장합니다. TokenLab의 경우, 내장된 openai 제공자를 덮어쓰는 대신 사용자 지정 제공자를 사용하세요:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "tokenlab": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "TokenLab",
      "options": {
        "baseURL": "https://api.tokenlab.sh/v1",
        "apiKey": "{env:OPENAI_API_KEY}"
      },
      "models": {
        "gpt-5.4": {
          "name": "GPT-5.4"
        },
        "gpt-5-mini": {
          "name": "GPT-5 Mini"
        }
      }
    }
  },
  "model": "tokenlab/gpt-5.4"
}

chat-completions 스타일 호환성을 위해 @ai-sdk/openai-compatible를 사용하세요. /v1/responses 기반 경로가 특별히 필요한 경우, OpenCode 문서에서는 패키지를 @ai-sdk/openai로 변경할 것을 권장합니다.

기본 사용법

대화형 모드 시작:

opencode

프롬프트와 함께 실행:

opencode "Explain this codebase"

모델 지정:

opencode --model tokenlab/gpt-5.4 "Fix the bugs in main.py"

사용 가능한 모델

모델	적합한 용도
`gpt-5.4`	복잡한 작업, 코드 아키텍처
`gpt-5-mini`	빠른 수정, 간단한 질의
`claude-sonnet-4-6`	코드 리뷰, 문서화
`claude-opus-4-6`	복잡한 추론
`gemini-3.5-flash`	빠른 응답
`deepseek-r1`	알고리즘 설계

자주 사용하는 명령어

코드 분석:

opencode "What does this function do?" < src/utils.ts

코드 생성:

opencode "Create a REST API with Express"

변경 사항 검토:

git diff | opencode "Review these changes"

오류 수정:

opencode "Fix the TypeScript errors in this project"

대화형 명령어

명령어	설명
`/help`	사용 가능한 명령어 표시
`/model <name>`	다른 모델로 전환
`/clear`	대화 기록 지우기
`/exit`	OpenCode 종료

문제 해결

연결 오류

options.baseURL이 https://api.tokenlab.sh/v1로 설정되어 있는지 확인하세요
네트워크 연결 상태를 확인하세요
테스트를 위해 curl https://api.tokenlab.sh/v1/models를 시도해 보세요

인증 실패

OPENAI_API_KEY 환경 변수가 설정되어 있는지 확인하세요
options.apiKey가 {env:OPENAI_API_KEY} 또는 다른 유효한 secret source를 참조하는지 확인하세요
키가 sk-로 시작하는지 확인하세요
TokenLab dashboard에서 키가 활성 상태인지 확인하세요

모델을 찾을 수 없음

config의 모델 이름이 정확히 일치하는지 확인하세요
tokenlab.sh/en/models에서 모델 사용 가능 여부를 확인하세요

모범 사례

프로젝트 컨텍스트 사용

코드베이스를 더 잘 이해할 수 있도록 프로젝트 루트에서 OpenCode를 실행하세요.

적절한 모델 선택

간단한 작업에는 더 빠른 모델(gpt-5-mini)을 사용하고, 복잡한 작업에는 더 강력한 모델(gpt-5.4, claude-sonnet-4-6)을 사용하세요.

생성된 코드 검토

프로젝트에 변경 사항을 적용하기 전에 AI가 생성한 코드를 항상 검토하세요.

호환성 매트릭스

코딩 도구

네이티브 SDK

프레임워크 및 플랫폼

채팅 앱

개요

설치

구성

1단계: 환경 변수 설정

2단계: OpenCode 구성

기본 사용법

사용 가능한 모델

자주 사용하는 명령어

대화형 명령어

문제 해결

모범 사례

​개요

​설치

​구성

​1단계: 환경 변수 설정

​2단계: OpenCode 구성

​기본 사용법

​사용 가능한 모델

​자주 사용하는 명령어

​대화형 명령어

​문제 해결

​모범 사례

개요

설치

구성

1단계: 환경 변수 설정

2단계: OpenCode 구성

기본 사용법

사용 가능한 모델

자주 사용하는 명령어

대화형 명령어

문제 해결

모범 사례