Question 1

Cline을 T3 Code (ACP)와 함께 사용할 때 발생하는 'Failed to open acpRegistry provider session' 오류를 해결하는 방법

Accepted Answer

근본 원인은 Cline 3.0.73의 ACP 모드에 있는 버그입니다: `cline --acp`가 `category: "model"`로 태그된 두 개의 세션 구성 옵션을 반환합니다 — `provider`(인증 선택기)가 첫 번째, `model`이 두 번째입니다. ACP 스펙에 따르면 클라이언트는 동일 카테고리 간의 우선순위를 배열 순서로 결정하므로, T3 Code와 같은 스펙 준수 클라이언트는 `provider`를 모델 선택기로 취급하고 `session/set_config_option`을 통해 선택된 모델 ID를 해당 옵션에 전송합니다. Cline은 다음 오류로 이를 거부합니다: `Invalid value "openrouter/free" for session config option "provider": expected one of cline, cline-pass, openai-codex`, 그리고 세션이 열리지 않습니다.

검증된 우회 방법: 클라이언트와 `cline --acp` 사이에 stdio 프록시를 삽입하여 `session/new` JSON-RPC 응답에서 `provider` 옵션의 카테고리를 `"model"`에서 `"provider"`로 재작성합니다. 이 재작성을 적용하면 세션이 열리고, 모델이 응답하며, 도구가 정상적으로 실행됩니다.

올바른 수정(업스트림): Cline은 `category: "model"`을 `model` 옵션에만 유지하고 `provider`에는 `_provider`(밑줄로 시작하는 이름은 ACP 스펙에서 사용자 정의 용도로 예약됨) 또는 `model_config`와 같은 사용자 정의 카테고리를 할당해야 합니다. Cline 이슈 #15158을 추적하고, 패치된 릴리스가 게시되면 `cline` npm 패키지를 업그레이드하세요.

Question 2

It’s almost certainly a state-persistence bug, not intended behavior: the sidebar is initialized with the default comparator/time-sorted mode before the saved UI preference is loaded, or the saved value is never written/read back correctly.

Common causes are an app update changing the storage key, corrupted Electron/VS Code state storage, the profile/user-data directory being read-only, launching with a temporary/redirected profile, multiple windows racing to write the same setting, or the sort option being kept only in React memory instead of globalState/localStorage/a settings file.

Things to try: update Cline, change the sort after the window fully loads then quit via the menu rather than killing the process, avoid flags like `--user-data-dir` or temporary profiles, check write permissions for the app data directory (`%APPDATA%/Cline`, `~/Library/Application Support/Cline`, or `~/.config/Cline`), and look for a setting such as a sidebar sort/sortMode key. If it still resets, capture logs and file an issue; the fix is usually to persist the selected sort mode and restore it after initial state hydration.

Accepted Answer

Cline Desktop 0.0.37의 알려진 버그: Sessions ↔ Projects 정렬 토글이 유지되지 않습니다. `apps/examples/desktop-app/webview/components/agent-sidebar.tsx`에서 이 상태는 `useState<SidebarSortMode>("time")`로 초기화되고 토글은 로컬 컴포넌트 상태만 전환할 뿐이며, 정렬 모드에 대한 localStorage 읽기/쓰기가 없기 때문에 컴포넌트는 실행 시 항상 `"time"` 기본값으로 다시 마운트됩니다. 이를 해결할 수 있는 앱 내 설정은 없습니다. 우회 방법: (1) 실행할 때마다 정렬 토글을 수동으로 다시 클릭합니다. (2) 소스에서 빌드하는 경우, localStorage에서 `cline.code.sidebar-sort.v1`과 같은 키를 읽는(`"time"`으로 폴백) 지연 `useState` 초기화자로 컴포넌트를 패치하고 토글의 `onClick` 핸들러 안에서 새 값을 다시 기록합니다. 이는 형제 설정인 `cline.code.model-selection.v1` 및 `cline.code.workspace-selection.v2`에서 이미 사용되고 있는 것과 동일한 지속성 패턴입니다.

Question 3

Cline에서 OpenAI Compatible provider 사용 시 "Unsupported parameter: 'max_tokens' is not supported with this model. Use 'max_completion_tokens' instead" 오류를 해결하는 방법

Accepted Answer

**원인:** Cline의 OpenAI Compatible 프로바이더는 내장된 추론 모델 패턴(`isOpenAIReasoningEraModelId`: o1/o3/o4 및 GPT-5 제품군)과 일치하는 모델 ID에 대해서만 `max_tokens`를 `max_completion_tokens`로 변환합니다. `gpt-6-sol`과 같은 사용자 지정 모델 ID는 이러한 패턴과 일치하지 않으므로 Cline은 레거시 `max_tokens` 파라미터를 전송하며, GPT-6 세대의 엔드포인트는 이를 거부합니다.

**우회 방법 1 – 인식되는 패턴과 일치하는 모델 ID 별칭 사용.** 엔드포인트 앞단에 (모델 ID 기준으로 라우팅하는) 사용자 소유의 Azure APIM 게이트웨이가 있으므로, Cline의 추론 패턴과 일치하는 이름의 별칭(예: `gpt-5-sol` 또는 `gpt-5`/`o3`을 포함하는 임의의 ID)을 게시하고, APIM에서 실제 GPT-6 배포로 라우팅한 다음, 해당 별칭을 Cline의 모델 ID로 입력하세요. 그러면 Cline이 `max_completion_tokens`를 전송합니다.

**우회 방법 2 – 게이트웨이에서 파라미터 재작성.** Azure OpenAI로 전달하기 전에 요청 JSON 본문을 변환하여 `max_tokens`를 `max_completion_tokens`로 이름을 바꾸는 APIM 인바운드 정책(예: Liquid 템플릿을 사용하는 `set-body` 정책)을 추가하세요.

**영구적 해결책:** 추론 모델 ID 패턴을 GPT-6 제품군까지 포함하도록 확장하는 릴리스가 나오면 Cline을 업그레이드하세요(issue #14478에서 추적 중). 그 전까지는 최대 출력 토큰 제한이 구성된 경우 별칭 또는 게이트웨이 재작성이 필요합니다.

Cline

주요 기능

할 수 없는 것

사용 사례

태그

시작하기

유사한 프로젝트