← 문서 목록

개발 도구 연결

opencode

업데이트

설정 만들기

쓸 모델을 여러 개 고르고 「확인」을 누르면, 고른 모델을 모두 바로 쓸 수 있는 설정이 아래에 만들어집니다. 첫 번째로 고른 모델이 기본 모델이 됩니다. 컨텍스트·출력 상한·가격 같은 값은 모델 카탈로그에서 채웁니다. 이 도구는 에이전트로 동작하므로 도구 호출을 지원하는 모델만 고를 수 있습니다.

모델 불러오는 중…

opencode에 everyais를 OpenAI 호환 provider로 추가합니다. 명령 한 줄이면 everyais 모델이 모두 /models에 나옵니다.

자동 연결 (권장)

  1. 터미널에서 실행합니다.

    bash
    opencode auth login https://platform.everyais.com
  2. everyais API key:가 나오면 대시보드에서 만든 키를 붙여 넣고 Enter를 누릅니다. 입력한 키는 화면에 보이지 않습니다.

  3. opencode를 실행하고 /models에서 everyais 모델을 고릅니다.

도구 호출을 지원하는 everyais 모델이 모두 컨텍스트·출력 상한·가격과 함께 등록됩니다. opencode는 켤 때마다 이 설정을 다시 받으므로 새 모델과 가격 변경이 저절로 반영됩니다. 추론을 지원하는 모델은 Ctrl+T나 opencode run --variant high로 추론 강도를 바꿉니다.

  • macOS·Linux·WSL에서 동작합니다(sh 필요). Windows에서는 아래 파일 설정을 쓰세요.
  • 연결을 끊으려면 opencode auth logout을 실행하고 https://platform.everyais.com을 고릅니다.

파일로 설정하기

모델을 직접 고르거나 기본 모델을 정해 두려면 opencode.json에 적습니다.

  1. 키를 환경변수에 넣습니다. 셸 설정 파일(~/.zshrc 등)에 넣어 두면 매번 입력하지 않아도 됩니다.

    bash
    export EVERYAIS_API_KEY="everyais_your_api_key"
  2. 위 「설정 만들기」에서 모델을 고르고 「확인」을 누릅니다. 도구 호출을 지원하는 모델만 목록에 나옵니다. 1번째 모델이 기본 모델(model)이 되고, 2번째 모델은 제목 만들기 같은 가벼운 작업(small_model)에 쓰입니다. 추론을 지원하는 모델은 「추론 강도」도 고를 수 있습니다.

  3. 만들어진 내용을 ~/.config/opencode/opencode.json에 저장하면 모든 프로젝트에서 쓰입니다. 프로젝트 루트의 opencode.json에 두면 그 프로젝트에서만 쓰입니다. 파일이 이미 있으면 provider 아래 everyais 항목과 model, small_model만 합치세요.

  4. opencode를 실행하고 /models에 everyais 모델이 보이는지 확인합니다.

설정 항목

항목하는 일
npm: "@ai-sdk/openai-compatible"OpenAI 호환 API로 요청하는 어댑터
options.baseURLhttps://api.everyais.com/v1. /v1까지 넣습니다
options.apiKey{env:EVERYAIS_API_KEY}는 환경변수에서 키를 읽으라는 뜻입니다. 변수가 비어 있으면 401이 납니다
model기본 모델. opencode는 첫 / 앞을 provider 이름으로 읽으므로 everyais/ 뒤에 모델 ID를 붙입니다. 그래서 everyais가 두 번 들어갑니다
small_model2번째로 고른 모델. 제목 만들기 같은 가벼운 작업에 씁니다

모델마다 아래 값을 카탈로그에서 채웁니다. 카탈로그에 없는 값은 넣지 않습니다.

키값
name표시 이름
tool_call도구 호출 지원 여부
modalities.input받는 입력. 이미지를 받는 모델에는 image가 붙습니다
limit.context · limit.output컨텍스트 크기와 최대 출력 토큰. opencode는 두 값을 함께 받으므로 둘 다 알 때만 넣습니다
cost1M 토큰당 가격(USD). 입력, 출력, 캐시 읽기, 캐시 쓰기 가격과 200K 토큰을 넘는 입력의 가격(context_over_200k)입니다
options.reasoningEffort고른 추론 강도

키를 opencode에 저장하려면 /connect에서 Other를 고르고 provider ID에 everyais를 넣은 뒤 키를 붙여 넣습니다. 이때 options.apiKey 줄은 지워도 됩니다.

예시

json
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "everyais": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "everyais",
      "options": {
        "baseURL": "https://api.everyais.com/v1",
        "apiKey": "{env:EVERYAIS_API_KEY}"
      },
      "models": {
        "everyais/claude-sonnet-5-5": { "name": "Claude Sonnet 5.5", "tool_call": true },
        "everyais/gemini-3-8-flash": { "name": "Gemini 3.8 Flash", "tool_call": true }
      }
    }
  },
  "model": "everyais/everyais/claude-sonnet-5-5",
  "small_model": "everyais/everyais/gemini-3-8-flash"
}

문제가 생기면

증상확인할 것
시작할 때 failed to fetch remote config자동 연결은 opencode를 켤 때마다 https://platform.everyais.com에서 설정을 받습니다. 네트워크를 확인하거나 opencode auth logout으로 연결을 끊으세요
401자동 연결이면 opencode auth login을 다시 실행해 키를 넣으세요. 파일 설정이면 opencode를 실행한 셸에서 echo $EVERYAIS_API_KEY로 키가 있는지 확인하세요
404 model_not_foundmodels의 키가 everyais 모델 ID와 정확히 같은지 확인하세요
기본 모델을 찾지 못합니다model이 everyais/everyais/... 형태인지 확인하세요
문의접수