메인 콘텐츠로 건너뛰기
OpenCode (GitHub)는 여러 provider와 함께 작동하는 오픈소스 터미널 AI 코딩 에이전트입니다.
프로토콜: OpenAI 호환
  • Base URL: https://api.orcarouter.ai/v1 (/v1 포함)
OpenAI 프로토콜을 통한 Claude reasoning 모델은 temperature != 1을 거부합니다 (400 temperature may only be set to 1 when thinking is enabled). 비 reasoning 모델을 사용하거나 reasoningEffort를 활성화하세요 — thinking 활성화를 참고하세요.

​
설치

npm install -g opencode-ai

​
구성

설정 파일: ~/.config/opencode/opencode.json. 
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "orcarouter": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "OrcaRouter",
      "options": { "baseURL": "https://api.orcarouter.ai/v1", "apiKey": "sk-orca-..." },
      "models": { "orcarouter/auto": { "name": "OrcaRouter Auto" } }
    }
  },
  "model": "orcarouter/orcarouter/auto"
}
원하면 특정 모델로 바꾸세요, 예: google/gemini-2.5-flash 또는 anthropic/claude-opus-4.8. 모델 ID는 항상 vendor/model 형식을 사용합니다.

​
실행

opencode run "Reply with exactly: OK"
예상 출력: OK.

​
참고 사항

  • base URL에는 /v1이 포함되어야 합니다.
  • 모델 참조는 provider/model 형식을 사용합니다. provider 이름이 orcarouter이고 모델 ID 또한 vendor 접두사를 가지므로, 참조는 세 개의 세그먼트가 됩니다: orcarouter/orcarouter/auto (또는 특정 모델의 경우 orcarouter/anthropic/claude-opus-4.8).
VS Code 확장: OpenCode의 공식 VS Code 확장(sst-dev.opencode)은 에디터 안에서 CLI를 실행하며 동일한 opencode.json을 공유합니다 — 별도의 에디터 내 엔드포인트 설정은 없습니다. 위와 같이 한 번만 구성하면 확장이 이를 그대로 사용합니다.

​
thinking / reasoning 활성화

모델의 options에서 reasoningEffort를 설정하세요: 
"models": {
  "anthropic/claude-sonnet-4.6": {
    "name": "Sonnet 4.6",
    "options": { "reasoningEffort": "high" }
  }
}
reasoningEffort를 활성화하면 위의 temperature 경고도 우회됩니다 — thinking이 활성화되면 temperature = 1이 유효하므로 400이 사라집니다. Anthropic 네이티브 제어를 위해서는 @ai-sdk/anthropic provider가 thinking: { type: "enabled", budgetTokens: N }을 받습니다.