메인 콘텐츠로 건너뛰기

​
개요

OpenCode는 터미널에서 실행되는 오픈 소스 AI 코딩 어시스턴트입니다. 여러 LLM 제공업체를 지원하며, 300개 이상의 모델에 액세스하기 위해 LemonData의 API를 사용하도록 설정할 수 있습니다.

​
설치

curl -fsSL https://opencode.ai/install | bash
설치 확인: 
opencode --version

​
설정

​
1단계: 환경 변수 설정

export OPENAI_API_KEY="sk-your-lemondata-key"
export LOCAL_ENDPOINT="https://api.lemondata.cc/v1"
영구적인 설정을 위해 ~/.bashrc 또는 ~/.zshrc에 추가하세요: 
echo 'export OPENAI_API_KEY="sk-your-lemondata-key"' >> ~/.zshrc
echo 'export LOCAL_ENDPOINT="https://api.lemondata.cc/v1"' >> ~/.zshrc
source ~/.zshrc

​
2단계: OpenCode 설정

프로젝트 루트에 ~/.config/opencode/opencode.json (전역) 또는 opencode.json을 생성하거나 편집하세요: 
{
  "provider": {
    "openai": {
      "options": {
        "apiKey": "sk-your-lemondata-key",
        "baseURL": "https://api.lemondata.cc/v1"
      }
    }
  },
  "model": "gpt-4o",
  "agent": {
    "coder": {
      "model": "gpt-4o"
    }
  }
}

​
기본 사용법

대화형 모드 시작: 
opencode
프롬프트와 함께 실행: 
opencode "Explain this codebase"
모델 지정: 
opencode --model gpt-4o "Fix the bugs in main.py"

​
사용 가능한 모델

모델최적 용도
gpt-4o복잡한 작업, 코드 아키텍처
gpt-4o-mini빠른 수정, 단순 쿼리
claude-sonnet-4-5코드 리뷰, 문서화
claude-opus-4-5복잡한 추론
gemini-2.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대화 기록 삭제
/exitOpenCode 종료

​
문제 해결

  • LOCAL_ENDPOINT가 https://api.lemondata.cc/v1으로 설정되어 있는지 확인하세요
  • 네트워크 연결 상태를 확인하세요
  • 테스트를 위해 curl https://api.lemondata.cc/v1/models를 실행해 보세요
  • OPENAI_API_KEY 환경 변수가 설정되어 있는지 확인하세요
  • 키가 sk-로 시작하는지 확인하세요
  • LemonData 대시보드에서 키가 활성 상태인지 확인하세요
  • 설정의 모델 이름이 정확히 일치하는지 확인하세요
  • lemondata.cc/en/models에서 모델 가용성을 확인하세요

​
권장 사항

코드베이스를 더 잘 이해할 수 있도록 프로젝트 루트에서 OpenCode를 실행하세요.
단순한 작업에는 더 빠른 모델(gpt-4o-mini)을, 복잡한 작업에는 강력한 모델(gpt-4o, claude)을 사용하세요.
프로젝트에 변경 사항을 적용하기 전에 항상 AI가 생성한 코드를 검토하세요.