OpenCode - Capriole AI Docs

OpenCode란

OpenCode는 터미널 인터페이스, 데스크톱 앱, IDE 확장으로 제공되는 오픈 소스 AI 코딩 에이전트입니다. 제공자 구성을 통해 Capriole AI의 OpenAI 호환 및 Anthropic 호환 엔드포인트로 지원 모델 요청을 보낼 수 있습니다.

사전 준비

시작하기 전에 다음이 있는지 확인하세요.

Capriole AI 계정(여기에서 가입)
Capriole AI API key(키 받기)

설치

공식 설치 스크립트로 OpenCode를 설치하세요.

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

또는 npm으로 설치하세요.

npm install -g opencode-ai

설치를 확인하세요.

opencode --version

구성

모델 검증

OpenCode 1.14.48에서 Fable 5.1의 Anthropic Messages(claude-latest) 경로와 zai/glm-5.3-flash의 Chat Completions 경로는 파일 읽기 도구 및 최종 답변 검사를 통과했습니다. 아래 구성에서는 이 경로를 사용합니다. Chat Completions를 통한 anthropic/claude-fable-5-1과 google/gemini-3.8-flash는 저장된 OpenCode 세션에 완료된 파일 읽기와 올바른 답변이 있지만 run --format json에 최종 텍스트 이벤트가 누락됩니다. 전체 CLI 출력 검사를 통과하지 못했으므로 아래 구성에는 추가하지 않습니다. xai/grok-4.6는 Chat Completions 요청을 받지만 코딩 에이전트 작업 검사를 통과하지 못해 아래 구성에 포함하지 않습니다. 제공자 직접 검사에서도 Grok 4.5의 도구 사용이 불안정했습니다. API 요청 완료가 올바른 에이전트 답변을 뜻하지는 않습니다. ~/.config/opencode/opencode.json을 만들거나 업데이트하세요. OpenAI 및 OpenAI 호환 제공자에는 apiKey를, Anthropic 제공자에는 authToken을 사용하세요.

{
  "$schema": "https://opencode.ai/config.json",
  "model": "capriole-ai-openai/openai-latest",
  "small_model": "capriole-ai-openai/openai-latest",
  "enabled_providers": ["capriole-ai-openai", "capriole-ai-compatible", "capriole-ai-anthropic"],
  "provider": {
    "capriole-ai-openai": {
      "npm": "@ai-sdk/openai",
      "name": "Capriole AI OpenAI",
      "options": {
        "baseURL": "https://api.caprioletech.com/v1",
        "apiKey": "YOUR_CAPRIOLE_AI_API_KEY"
      },
      "models": {
        "openai-latest": {
          "name": "OpenAI latest",
          "options": {
            "forceReasoning": true
          },
          "variants": {
            "minimal": {
              "reasoningEffort": "minimal",
              "reasoningSummary": "auto"
            },
            "low": {
              "reasoningEffort": "low",
              "reasoningSummary": "auto"
            },
            "medium": {
              "reasoningEffort": "medium",
              "reasoningSummary": "auto"
            },
            "high": {
              "reasoningEffort": "high",
              "reasoningSummary": "auto"
            },
            "xhigh": {
              "reasoningEffort": "xhigh",
              "reasoningSummary": "auto"
            }
          }
        },
        "openai/gpt-6-astra": {
          "name": "GPT-6 Astra",
          "options": {
            "forceReasoning": true
          }
        },
        "openai/gpt-5.6-terra": {
          "name": "GPT 5.6 Thinking",
          "options": {
            "forceReasoning": true
          }
        },
        "openai/gpt-5.6-luna": {
          "name": "GPT 5.6",
          "options": {
            "forceReasoning": true
          }
        },
        "openai/gpt-5.5": {
          "name": "GPT 5.5",
          "options": {
            "forceReasoning": true
          },
          "variants": {
            "minimal": {
              "reasoningEffort": "minimal",
              "reasoningSummary": "auto"
            },
            "low": {
              "reasoningEffort": "low",
              "reasoningSummary": "auto"
            },
            "medium": {
              "reasoningEffort": "medium",
              "reasoningSummary": "auto"
            },
            "high": {
              "reasoningEffort": "high",
              "reasoningSummary": "auto"
            },
            "xhigh": {
              "reasoningEffort": "xhigh",
              "reasoningSummary": "auto"
            }
          }
        }
      }
    },
    "capriole-ai-compatible": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Capriole AI Compatible",
      "options": {
        "baseURL": "https://api.caprioletech.com/v1",
        "apiKey": "YOUR_CAPRIOLE_AI_API_KEY"
      },
      "models": {
        "anthropic/claude-fable-5": {
          "name": "Fable 5"
        },
        "anthropic/claude-opus-5": {
          "name": "Opus 5"
        },
        "xai/grok-4.5": {
          "name": "Grok 4.5"
        },
        "zai/glm-5.3-flash": {
          "name": "GLM 5.3 Flash"
        },
        "zai/glm-5.2": {
          "name": "GLM 5.2"
        },
        "moonshot/kimi-k3": {
          "name": "Kimi K3"
        }
      }
    },
    "capriole-ai-anthropic": {
      "npm": "@ai-sdk/anthropic",
      "name": "Capriole AI Anthropic",
      "options": {
        "baseURL": "https://api.caprioletech.com/v1",
        "authToken": "YOUR_CAPRIOLE_AI_API_KEY"
      },
      "models": {
        "claude-latest": {
          "name": "Claude latest",
          "variants": {
            "low": {
              "thinking": {
                "type": "adaptive",
                "display": "summarized"
              },
              "effort": "low"
            },
            "medium": {
              "thinking": {
                "type": "adaptive",
                "display": "summarized"
              },
              "effort": "medium"
            },
            "high": {
              "thinking": {
                "type": "adaptive",
                "display": "summarized"
              },
              "effort": "high"
            },
            "xhigh": {
              "thinking": {
                "type": "adaptive",
                "display": "summarized"
              },
              "effort": "xhigh"
            },
            "max": {
              "thinking": {
                "type": "adaptive",
                "display": "summarized"
              },
              "effort": "max"
            }
          }
        },
        "claude-fable-5-1": {
          "name": "Fable 5.1"
        },
        "claude-fable-5": {
          "name": "Fable 5"
        },
        "claude-opus-5": {
          "name": "Opus 5"
        },
        "claude-opus-4-8": {
          "name": "Opus 4.8",
          "variants": {
            "low": {
              "thinking": {
                "type": "adaptive",
                "display": "summarized"
              },
              "effort": "low"
            },
            "medium": {
              "thinking": {
                "type": "adaptive",
                "display": "summarized"
              },
              "effort": "medium"
            },
            "high": {
              "thinking": {
                "type": "adaptive",
                "display": "summarized"
              },
              "effort": "high"
            },
            "xhigh": {
              "thinking": {
                "type": "adaptive",
                "display": "summarized"
              },
              "effort": "xhigh"
            },
            "max": {
              "thinking": {
                "type": "adaptive",
                "display": "summarized"
              },
              "effort": "max"
            }
          }
        },
        "claude-opus-4-7": {
          "name": "Opus 4.7",
          "variants": {
            "low": {
              "thinking": {
                "type": "adaptive",
                "display": "summarized"
              },
              "effort": "low"
            },
            "medium": {
              "thinking": {
                "type": "adaptive",
                "display": "summarized"
              },
              "effort": "medium"
            },
            "high": {
              "thinking": {
                "type": "adaptive",
                "display": "summarized"
              },
              "effort": "high"
            },
            "xhigh": {
              "thinking": {
                "type": "adaptive",
                "display": "summarized"
              },
              "effort": "xhigh"
            },
            "max": {
              "thinking": {
                "type": "adaptive",
                "display": "summarized"
              },
              "effort": "max"
            }
          }
        },
        "claude-opus-4-6": {
          "name": "Opus 4.6",
          "variants": {
            "low": {
              "thinking": {
                "type": "adaptive",
                "display": "summarized"
              },
              "effort": "low"
            },
            "medium": {
              "thinking": {
                "type": "adaptive",
                "display": "summarized"
              },
              "effort": "medium"
            },
            "high": {
              "thinking": {
                "type": "adaptive",
                "display": "summarized"
              },
              "effort": "high"
            },
            "xhigh": {
              "thinking": {
                "type": "adaptive",
                "display": "summarized"
              },
              "effort": "xhigh"
            },
            "max": {
              "thinking": {
                "type": "adaptive",
                "display": "summarized"
              },
              "effort": "max"
            }
          }
        },
        "claude-sonnet-4-6": {
          "name": "Sonnet 4.6",
          "variants": {
            "low": {
              "thinking": {
                "type": "adaptive",
                "display": "summarized"
              },
              "effort": "low"
            },
            "medium": {
              "thinking": {
                "type": "adaptive",
                "display": "summarized"
              },
              "effort": "medium"
            },
            "high": {
              "thinking": {
                "type": "adaptive",
                "display": "summarized"
              },
              "effort": "high"
            },
            "xhigh": {
              "thinking": {
                "type": "adaptive",
                "display": "summarized"
              },
              "effort": "xhigh"
            },
            "max": {
              "thinking": {
                "type": "adaptive",
                "display": "summarized"
              },
              "effort": "max"
            }
          }
        }
      }
    }
  }
}

OpenCode 실행

구성에서 YOUR_CAPRIOLE_AI_API_KEY를 바꾼 뒤 OpenCode를 시작하세요.

opencode

/models로 OpenAI latest, GPT-6 Astra, GPT 5.6 Thinking, GPT 5.6, GPT 5.5, Fable 5.1, Fable 5, Opus 5, Grok 4.5, GLM 5.3 Flash, GLM 5.2, Kimi K3, Claude latest, Opus 4.8, Opus 4.7, Opus 4.6, Sonnet 4.6을 선택하세요. Ctrl+T로 모델 variant를 순환하세요.

지원 모델

OpenCode는 Capriole AI를 통해 OpenAI latest, GPT-6 Astra, GPT 5.6 Thinking, GPT 5.6, GPT 5.5, Fable 5.1, Fable 5, Opus 5, Grok 4.5, GLM 5.3 Flash, GLM 5.2, Kimi K3, Claude latest, Opus 4.8, Opus 4.7, Opus 4.6, Sonnet 4.6을 지원합니다. Fable 5와 Opus 5는 Chat Completions 호환 제공자 또는 Anthropic Messages 제공자를 사용할 수 있습니다.

openai-latest
openai/gpt-6-astra
openai/gpt-5.6-terra
openai/gpt-5.6-luna
openai/gpt-5.5
anthropic/claude-fable-5
anthropic/claude-opus-5
xai/grok-4.5
zai/glm-5.3-flash
zai/glm-5.2
moonshot/kimi-k3
claude-latest
claude-fable-5-1
claude-fable-5
claude-opus-5
claude-opus-4-8
claude-opus-4-7
claude-opus-4-6
claude-sonnet-4-6

문제 해결

OpenCode가 인증 오류를 반환하는 이유는 무엇인가요?

~/.config/opencode/opencode.json의 apiKey와 authToken이 모두 YOUR_CAPRIOLE_AI_API_KEY가 아니라 Capriole AI API key를 사용하는지 확인하세요.

GPT 요청이 실패하는 이유는 무엇인가요?

GPT 제공자가 npm: "@ai-sdk/openai"와 baseURL: "https://api.caprioletech.com/v1"을 사용해 Responses API로 요청하는지 확인하세요.

Grok, GLM, Kimi 요청이 실패하는 이유는 무엇인가요?

capriole-ai-compatible이 npm: "@ai-sdk/openai-compatible"와 baseURL: "https://api.caprioletech.com/v1"을 사용해 두 모델 모두 Chat Completions를 사용하는지 확인하세요.

Anthropic 요청이 실패하는 이유는 무엇인가요?

Anthropic 제공자가 npm: "@ai-sdk/anthropic", authToken, baseURL: "https://api.caprioletech.com/v1"을 사용하는지 확인하세요.

Capriole AI 모델이 나타나지 않는 이유는 무엇인가요?

모델 참조가 capriole-ai-openai/openai-latest, capriole-ai-compatible/moonshot/kimi-k3, capriole-ai-anthropic/claude-latest처럼 <providerId>/<modelId> 형식인지, enabled_providers에 Capriole AI 제공자가 포함되어 있고 disabled_providers가 차단하지 않는지 확인하세요.

모델 variant가 나타나지 않는 이유는 무엇인가요?

~/.config/opencode/opencode.json을 업데이트한 뒤 OpenCode를 다시 시작했는지 확인한 다음, /models를 열고 Ctrl+T로 variant를 순환하세요.

구성 변경이 적용되지 않는 이유는 무엇인가요?

프로젝트 수준 opencode.json 또는 OPENCODE_CONFIG 재정의가 있는지 확인한 다음 OpenCode를 다시 시작하세요.

제공자 초기화 또는 제공자 패키지 오류가 나타나는 이유는 무엇인가요?

ProviderInitError는 먼저 제공자 구성을 확인하세요. 제공자 패키지 오류는 ~/.cache/opencode를 지우고 OpenCode를 다시 시작해 제공자 패키지를 다시 설치하세요.

참고

Anthropic 제공자는 authToken을 사용해 AI SDK Anthropic 제공자가 Authorization: Bearer 인증을 보내게 합니다.
OpenCode 1.14.48은 @ai-sdk/openai-compatible를 통해 Grok 4.5, GLM 5.2, Kimi K3로 셸 도구 워크플로를 완료합니다.
OpenCode variant는 클라이언트 쪽 모델 설정입니다. 새로운 Capriole AI API 모델 ID를 만들지 않습니다.
공식 참고: OpenCode install, OpenCode config, OpenCode providers, OpenCode models and variants, OpenCode keybinds, OpenCode troubleshooting, OpenAI Responses API, AI SDK OpenAI provider, AI SDK Anthropic provider, Anthropic adaptive thinking, Anthropic effort.

​OpenCode란

​사전 준비

​설치

​구성

​모델 검증

​OpenCode 실행

​지원 모델

​문제 해결

​OpenCode가 인증 오류를 반환하는 이유는 무엇인가요?

​GPT 요청이 실패하는 이유는 무엇인가요?

​Grok, GLM, Kimi 요청이 실패하는 이유는 무엇인가요?

​Anthropic 요청이 실패하는 이유는 무엇인가요?

​Capriole AI 모델이 나타나지 않는 이유는 무엇인가요?

​모델 variant가 나타나지 않는 이유는 무엇인가요?

​구성 변경이 적용되지 않는 이유는 무엇인가요?

​제공자 초기화 또는 제공자 패키지 오류가 나타나는 이유는 무엇인가요?

​참고