문서

Open Interpreter

Open Interpreter는 Codex의 조상처럼 TOML 테이블에서 제공업체를 불러오지만, 상위 Codex가 제거한 Chat Completions 전송 방식을 유지하고 있습니다. [model_providers.kunavo] 블록 하나면 에이전트가 해당 키로 연결 가능한 모든 모델에서 실행됩니다.

~/.openinterpreter/config.toml의 [model_providers.kunavo] 테이블 하나 — base_url, env_key, wire_api = "chat" — 로 Rust 터미널 에이전트가 키가 접근할 수 있는 모든 모델에서 실행됩니다

~/.openinterpreter/config.toml

model_provider = "kunavo"
model = "claude-sonnet-5"

[model_providers.kunavo]
name = "Kunavo"
base_url = "https://api.kunavo.com/v1"
env_key = "KUNAVO_API_KEY"     # the NAME of the variable, not the key
wire_api = "chat"

기본 URL은 chat 와이어에서 /v1 접미사를 유지해야 합니다. Open Interpreter 문서는 명시적인 규칙 대신 예시로 이를 보여 줍니다. 공급자 페이지의 사용자 지정 공급자 블록에는 base_url = "https://api.example.com/v1", 구성 페이지에는 "https://api.acme.example/v1", 이름을 명시해 설명하는 호스팅 게이트웨이에는 "https://app.nz/v1"가 사용됩니다. 접미사를 빼면 인증 오류가 아니라 404 오류가 발생합니다.

Kunavo는 이 클라이언트를 자사 엔드포인트에 연결해 실행해 본 적이 없습니다. 이 페이지의 다른 클라이언트도 마찬가지입니다. 여기서 확인한 것은 구성 방식입니다. 아래 키 이름은 이 페이지 하단의 날짜를 기준으로 Open Interpreter 자체 문서에 기재된 것이고, 기본 URL과 모델 ID는 Kunavo의 값입니다. 설정 안내 페이지를 게시했다고 해서 테스트를 실행한 것은 아닙니다. 작동 여부는 검증 요청으로 확인하세요.

"Open Interpreter"라는 이름을 쓰는 프로그램은 서로 다른 두 가지이며, 이 블록은 Rust 버전을 위한 것입니다. 0.4.3에서 고정된 Python 패키지는 --api_base, --api_key, --model openai/<id> 또는 Python의 interpreter.llm를 통해 구성합니다. 현재 터미널 에이전트에는 이 항목들이 없으며, 위 TOML 테이블만 읽습니다. 무엇이든 수정하기 전에 interpreter --version을 실행하세요. 예전 튜토리얼의 pip install open-interpreter은 같은 이름을 두고 다른 바이너리가 경쟁하게 만듭니다.

Claude 모델 ID를 사용하면 Open Interpreter가 claude-code 하네스를 자동으로 선택합니다. 문서에 따르면 기본값은 "Anthropic, Claude 모델 ID, Anthropic 기본 URL 또는 임의의 messages 공급자"일 때 해당 하네스를 선택합니다. 여기서는 유효한 조합입니다. 라우팅 표에 claude-code가 wire_api = "chat"와 호환된다고 나와 있습니다. 다른 하네스를 원하면 harness를 명시적으로 설정하세요. 명시적 값이 항상 우선하며, 인식할 수 없는 값은 오류를 명확히 내는 대신 내장 요청 빌더가 없는 chat으로 대체됩니다.

아직 키가 없나요? Kunavo 계정을 만들고, 키를 생성한 다음(키는 sk-kn-로 시작합니다) $10부터 크레딧을 추가하세요. 호출 비용은 해당 잔액에서 차감되며 실패한 호출에는 요금이 부과되지 않습니다. 그러면 대시보드가 Open Interpreter 설정 화면에서 열립니다.

단계별 안내

/app/keys에서 키를 생성해 복사하세요. 키는 한 번만 표시됩니다.
env_key에 입력할 이름으로 환경 변수를 내보내세요: export KUNAVO_API_KEY=sk-kn-.... 이 필드에는 변수의 값이 아니라 이름을 넣습니다. 문서에는 env_key가 "환경 변수에서 bearer 토큰을 읽는다"고 나와 있습니다.
위 블록을 ~/.openinterpreter/config.toml에 넣으세요. 저장소 하나에만 적용하려면 신뢰하는 프로젝트의 .openinterpreter/config.toml 안에 넣으면 됩니다. 프로젝트 구성이 사용자 구성보다 우선하고, 해당 실행에서는 -c key=value 플래그가 둘 다보다 우선합니다.
interpreter을 시작하고 /model을 실행하세요. 선택기는 먼저 활성 공급자의 models 경로를 요청하고, Kunavo가 GET /v1/models를 응답하므로 목록이 자동으로 채워집니다.
잘못된 값이 적용되고 있다면 /debug-config을 실행하세요. 유효한 구성과 각 값의 출처가 출력되므로 오래된 프로필이나 프로젝트 파일을 TOML에서 다시 찾는 것보다 빠르게 문제를 해결할 수 있습니다.

Open Interpreter의 모델 공급자 페이지에서 확인했습니다(2026년 9월 21일 기준). 서드파티 설정은 변경될 수 있으므로, 여기의 필드 이름이 실제 화면과 다르면 이 문서가 아니라 해당 페이지를 기준으로 삼으세요.

이것이 요약본입니다. 전체 안내—모델 선택, 실제 세션 비용, 실패 유형—는 Open Interpreter의 버전 차이, 가격 및 대안에 있습니다.

클라이언트를 디버깅하기 전에 확인할 사항

한 번의 요청으로 문제가 엔드포인트, 키 또는 구성 파일 중 어디에 있는지 판단할 수 있습니다. 이 요청에서 JSON이 반환되면 동일한 base URL과 키가 Open Interpreter에서 작동합니다.

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

필드에 입력할 model id

모든 텍스트 모델은 model id로 접근할 수 있습니다. 현재 목록은 GET /v1/models이며, 가격이 포함된 카탈로그는 모델 페이지에서 확인할 수 있습니다. 요금은 토큰 100만 개당 USD 기준이며 입력 / 출력 순서입니다.

모델 ID	Kunavo 입력/출력	Open Interpreter에서의 위치
`claude-sonnet-5`	$1.40 / $7.00	편집 및 실행 반복 작업을 위한 기본 작업 모델
`claude-opus-5`	$3.50 / $17.50	잘못된 계획의 비용이 큰 대규모 리팩터링 계획 수립
`claude-haiku-4-5`	$0.70 / $3.50	턴 수가 중요한 셸 중심 세션
`gpt-5-6-sol`	$2.00 / $12.00	같은 키로 다른 계열 모델에 2차 의견 요청

월정액 없이 선불 잔액에서 토큰별로 청구됩니다. billing을 참고하세요. 반복되는 컨텍스트(에디터나 채팅 클라이언트가 보내는 데이터의 대부분)에서는 모델 선택보다 프롬프트 캐싱이 청구액에 더 큰 영향을 줍니다.

자주 묻는 질문

Open Interpreter에서 사용자 지정 API 공급자를 지정하려면 어떻게 하나요?

~/.openinterpreter/config.toml에 name, base_url, env_key, wire_api를 포함한 [model_providers.<id>] 테이블을 추가한 다음, 최상위 model_provider 키로 해당 공급자를 선택하고 model로 모델을 지정하세요. OpenAI 호환 엔드포인트에는 wire_api = "chat"을 사용하고, /v1로 끝나는 기본 URL을 지정하세요. Open Interpreter 자체 공급자 페이지에서 사용자 지정 공급자와 이름을 명시해 설명하는 호스팅 게이트웨이에 사용하는 형식입니다. env_key에는 환경 변수 이름을 넣으므로 키를 파일에 붙여 넣지 말고 환경 변수로 내보내세요.

Open Interpreter의 base_url은 끝에 /v1을 붙여야 하나요?

chat 와이어에서는 그렇습니다. 문서는 경로 구성 규칙을 설명하는 문장을 제공하지 않지만, 기재된 모든 사용자 지정 공급자 예시에 접미사가 붙어 있습니다. 공급자 페이지에는 https://api.example.com/v1, 구성 페이지에는 https://api.acme.example/v1, 이름을 명시해 설명한 게이트웨이에는 https://app.nz/v1이 사용됩니다. messages 와이어는 다르게 작동합니다. 클라이언트에 포함된 Anthropic 스타일 공급자는 /v1이 없는 API 루트를 사용합니다. 따라서 /v1이 필요하다는 답은 wire_api = "chat" 및 wire_api = "responses"에만 해당합니다.

예전의 --api_base 및 --model openai/... 플래그는 아직 작동하나요?

아니요. 이 플래그는 0.4.3에서 고정된 Python 패키지에 속합니다. 해당 패키지는 LiteLLM을 통해 라우팅하므로 openai/ 접두사가 필요했습니다. 현재 터미널 에이전트는 Codex의 Rust 포크이며, 해당 플래그나 접두사 규칙을 사용하지 않습니다. ~/.openinterpreter/config.toml 또는 프로젝트 수준의 .openinterpreter/config.toml에서 TOML 공급자 테이블을 읽고 model_provider와 model로 공급자 및 모델을 선택합니다. 구성은 처음부터 새로 작성됩니다. docs.openinterpreter.com은 Rust 문서로 리디렉션되므로 예전 튜토리얼의 링크는 여전히 열리지만, 설치되어 있지 않은 프로그램에 대해 설명합니다.

왜 /model 선택기에 사용자 지정 공급자의 컨텍스트 창이 표시되지 않나요?

해당 메타데이터는 클라이언트에 포함된 카탈로그에서 가져오기 때문입니다. 이 카탈로그는 models.dev와 일부 실시간 공급자 엔드포인트를 기반으로 생성되며, 공급자가 Anthropic 식별 정보, 기본 URL, 공급자 이름 또는 인증 환경 변수로 항목과 일치할 때만 데이터가 채워집니다. 2026년 9월 21일 저장소의 파일을 확인한 결과 Kunavo는 이 생성 카탈로그에 없습니다. 따라서 직접 작성한 공급자는 엔드포인트 자체의 models 경로에서 모델 목록만 가져옵니다. 모델은 계속 실행할 수 있으며, 선택기에 표시되는 부가 정보가 줄어들 뿐입니다.

Anthropic 계정 없이 Open Interpreter에서 Claude 모델을 사용할 수 있나요?

네. wire_api는 공급업체가 아니라 전송 방식을 지정하기 때문입니다. wire_api = "chat"이면 모델 ID가 설정한 base_url로 그대로 전달되어 해당 엔드포인트에서 확인됩니다. 따라서 사용하는 자격 증명은 해당 엔드포인트의 자격 증명입니다. Open Interpreter는 Claude 모델 ID를 기준으로 claude-code 하네스를 자동 선택하지만, 이 하네스는 chat 와이어와 호환되는 것으로 안내되어 있으므로 이 조합은 우회 방법이 아니라 문서에 기재된 방식입니다.