Skip to content

Commit fa51fce

Browse files
authored
Merge pull request #880 from n3wr1ch/feat/cline-pass-provider
feat(provider): add ClinePass subscription provider
2 parents 08f7188 + 6f1efd7 commit fa51fce

42 files changed

Lines changed: 1052 additions & 102 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

‎docs-site/src/content/docs/getting-started/quickstart.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ ocx init
1313

1414
`ocx init` walks you through:
1515

16-
1. **Pick a provider** — choose one of the 66 built-in registry presets or `custom` to type a base
16+
1. **Pick a provider** — choose one of the 68 built-in registry presets or `custom` to type a base
1717
URL and adapter.
1818
2. **API key** — paste a key, or reference an environment variable like `${ANTHROPIC_API_KEY}`.
1919
3. **Default model** — for key, local, and custom providers, accept the preset or enter a model id.

‎docs-site/src/content/docs/guides/providers.md‎

Lines changed: 16 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -190,15 +190,30 @@ selectors, then retry. Signing in from a machine with no existing `kiro-cli` ses
190190

191191
## 3. API-key catalog
192192

193-
opencodex ships 66 built-in presets: 55 key-based, seven OAuth, three local, and the default
193+
opencodex ships 68 built-in presets: 57 key-based, seven OAuth, three local, and the default
194194
ChatGPT-forward preset. The dashboard's **Add provider** picker opens a key provider's dashboard,
195195
validates the key, and stores it. Notable entries:
196196

197+
**ClinePass** uses a Cline API key with the [official subscription catalog](https://docs.cline.bot/getting-started/clinepass)
198+
and [Chat Completions endpoint](https://docs.cline.bot/api/chat-completions), operated by Cline Bot Inc. under
199+
[Cline's terms](https://cline.bot/tos). A routed id such as `cline-pass/cline-pass/kimi-k3` is
200+
intentional: the first segment selects the opencodex provider, while `cline-pass/kimi-k3` is the
201+
full model slug sent upstream. ClinePass quota is shared by the account across rolling 5-hour,
202+
weekly, and monthly limits. opencodex currently advertises the live-verified `low` reasoning tier;
203+
higher requested tiers clamp to `low` until the gateway publishes or verifies a wider ladder.
204+
205+
**Cline** is the same API key and endpoint on pay-as-you-go usage billing across 100+ models
206+
(OpenRouter-style ids like `anthropic/claude-sonnet-4-6`). Cline's promotional free models are only
207+
available in the Cline IDE/CLI, not through the API; `minimax/minimax-m2.5` is the documented API
208+
free-experimentation model.
209+
197210
| Provider | Base URL |
198211
| --- | --- |
199212
| **OpenAI (API key)** | `https://api.openai.com/v1` |
200213
| **Anthropic (API key)** | `https://api.anthropic.com` |
201214
| **OpenRouter** | `https://openrouter.ai/api/v1` |
215+
| **Cline** | `https://api.cline.bot/api/v1` |
216+
| **ClinePass** | `https://api.cline.bot/api/v1` |
202217
| **Ollama Cloud** | `https://ollama.com/v1` |
203218
| Google Gemini · Google Vertex AI | `https://generativelanguage.googleapis.com` · `https://aiplatform.googleapis.com` |
204219
| Azure OpenAI | `https://{resource}.openai.azure.com/openai` |

‎docs-site/src/content/docs/ja/getting-started/quickstart.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ ocx init
1313

1414
`ocx init` では次の手順を説明します。
1515

16-
1. **プロバイダーを選択してください** — 66 の組み込みレジストリ プリセットのいずれか、または `custom` を選択してベースを入力します
16+
1. **プロバイダーを選択してください** — 68 の組み込みレジストリ プリセットのいずれか、または `custom` を選択してベースを入力します
1717
URLとアダプター。
1818
2. **API キー** — キーを貼り付けるか、`${ANTHROPIC_API_KEY}` のような環境変数を参照します。
1919
3. **デフォルト モデル** — キー、ローカル、カスタム プロバイダーの場合は、プリセットを受け入れるか、モデル ID を入力します。

‎docs-site/src/content/docs/ja/guides/providers.md‎

Lines changed: 16 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -119,15 +119,30 @@ Kiro のログインには Kiro CLI が必要です。Unix では `curl -fsSL ht
119119

120120
## 3. API キーカタログ
121121

122-
opencodex には組み込みプリセットが 66 個含まれています。キー方式 55、OAuth 7、ローカル 3、
122+
opencodex には組み込みプリセットが 68 個含まれています。キー方式 57、OAuth 7、ローカル 3、
123123
デフォルト ChatGPT 転送プリセット 1 です。ダッシュボードの **Add provider** ピッカーはキー発行ページを開き、
124124
入力したキーを検証した後保存します。主な項目は以下のとおりです:
125125

126+
**ClinePass** は Cline API キーで[公式サブスクリプションカタログ](https://docs.cline.bot/getting-started/clinepass)と
127+
[Chat Completions エンドポイント](https://docs.cline.bot/api/chat-completions)に接続します。運営主体は
128+
[Cline の利用規約](https://cline.bot/tos)に記載された Cline Bot Inc. です。`cline-pass/cline-pass/kimi-k3` のようなルーティング ID は
129+
意図した形式です。先頭は opencodex のプロバイダー、残りの `cline-pass/kimi-k3` は upstream に送信する
130+
完全なモデル slug です。使用量はアカウントのローリング 5 時間、週次、月次の各上限で共有されます。
131+
現在 opencodex が公開する reasoning tier は実機検証済みの `low` のみで、より高い要求は公式範囲が
132+
公開または検証されるまで `low` にクランプされます。
133+
134+
**Cline** は同じ API キー・エンドポイントを従量課金で使い、100 以上のモデルにアクセスできます
135+
(OpenRouter 形式の ID、例: `anthropic/claude-sonnet-4-6`)。Cline の期間限定無料モデルは
136+
Cline IDE/CLI のみで API からは使えません。`minimax/minimax-m2.5` は API で利用できる
137+
無料試用モデルとして文書化されています。
138+
126139
| プロバイダー | ベース URL |
127140
--- | --- |
128141
| **OpenAI (API キー)** | `https://api.openai.com/v1` |
129142
| **Anthropic (API キー)** | `https://api.anthropic.com` |
130143
| **OpenRouter** | `https://openrouter.ai/api/v1` |
144+
| **Cline** | `https://api.cline.bot/api/v1` |
145+
| **ClinePass** | `https://api.cline.bot/api/v1` |
131146
| **Ollama Cloud** | `https://ollama.com/v1` |
132147
| Google Gemini · Google Vertex AI | `https://generativelanguage.googleapis.com` · `https://aiplatform.googleapis.com` |
133148
| Azure OpenAI | `https://{resource}.openai.azure.com/openai` |

‎docs-site/src/content/docs/ja/reference/adapters.md‎

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -32,6 +32,11 @@ interface ProviderAdapter {
3232
プロバイダーが明示的に alias を設定しない限り、`xhigh` と `max` は異なるラベルのまま保ちます。`provider.noReasoningModels` に含まれる id には値を **一切送りません**。
3333
- `delta.content`(テキスト)、`delta.reasoning_content`(thinking)、`delta.tool_calls[]` を
3434
ストリーミングし、`usage` を収集します。
35+
- ClinePass は、ライブ検証済みのゲートウェイ形式 `reasoning: { enabled: true, effort: "low" }`
36+
(reasoning を無効にする場合は `{ enabled: false }`)を使用します。公開 API ドキュメントには
37+
現在このリクエスト形式が明記されていません。アダプターは他の effort リクエストを検証済みの
38+
`low` に調整し、`delta.reasoning_content` または `delta.reasoning` を reasoning delta として扱い、
39+
`stream_options.include_usage` でストリーム usage を要求し、非ストリームのレスポンス envelope からも usage を読み取ります。
3540

3641
## `openai-responses`
3742

‎docs-site/src/content/docs/ja/reference/configuration/providers.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -70,6 +70,7 @@ description: プロバイダー エントリ、認証、エンドポイント、
7070
| `modelAdapters?` | `Record<string, string>` | 混合配線ゲートウェイのモデルごとの `openai-chat` または `openai-responses` 配線オーバーライド。明示的なエントリはレジストリのデフォルトを破ります。DeepSeek のプリセットは `deepseek-v4-flash` のネイティブ Responses を選択でき、GitHub Copilot は GPT-5 ファミリー (`gpt-5.3-codex`, `gpt-5.4`, `gpt-5.4-mini`, `gpt-5.5`, `gpt-5.6-luna`, `gpt-5.6-sol`, `gpt-5.6-terra`) を Responses 専用デフォルトとして宣言します。これらのモデルはエージェント トラフィックで `/chat/completions` を拒否するためです。`gpt-5.4-nano` のようなビルトイン デフォルトのないモデルはここでオプトインできます。単線アップストリーム ピンと正規の ChatGPT 転送はオーバーライドを拒否します。 |
7171
| `reasoningEffortMap?` | `Record<string, string>` |ラベルを推論するためのプロバイダー全体のワイヤ エイリアス。 |
7272
| `modelReasoningEffortMap?` | `Record<string, Record<string, string>>` |推論ラベルのモデルごとのワイヤ エイリアス。 |
73+
| `reasoningWireFormat?` | `"gateway-object"` | `reasoning_effort` ではなく `reasoning: { enabled, effort }` を受け取る OpenAI 互換ゲートウェイ用です。ClinePass プリセットが自動設定します。 |
7374
| `noReasoningModels?` | `string[]` |推論/思考パラメーターを拒否するモデル。 |
7475
| `noTemperatureModels?` | `string[]` |発信者指定の`temperature`を拒否するモデル。 |
7576
| `noTopPModels?` | `string[]` |発信者指定の`top_p`を拒否するモデル。 |

‎docs-site/src/content/docs/ko/getting-started/quickstart.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ ocx init
1313

1414
`ocx init`은 다음 과정을 안내합니다:
1515

16-
1. **프로바이더 선택** — 내장 레지스트리 프리셋 66개 중 하나를 고르거나 `custom`을 선택해 base URL과 adapter를 직접 입력합니다.
16+
1. **프로바이더 선택** — 내장 레지스트리 프리셋 68개 중 하나를 고르거나 `custom`을 선택해 base URL과 adapter를 직접 입력합니다.
1717
2. **API 키** — 키를 붙여넣거나 `${ANTHROPIC_API_KEY}` 같은 환경 변수를 참조합니다.
1818
3. **기본 모델** — 키, 로컬, custom 프로바이더에서는 프리셋을 그대로 쓰거나 모델 ID를 직접 입력합니다.
1919
4. **프록시 포트** — 기본값은 `10100`입니다.

‎docs-site/src/content/docs/ko/guides/providers.md‎

Lines changed: 17 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -119,15 +119,31 @@ Kiro 로그인에는 Kiro CLI가 필요합니다. Unix에서는 `curl -fsSL http
119119

120120
## 3. API 키 카탈로그
121121

122-
opencodex에는 빌트인 프리셋이 66개 들어 있습니다. 키 방식 55개, OAuth 7개, 로컬 3개,
122+
opencodex에는 빌트인 프리셋이 68개 들어 있습니다. 키 방식 57개, OAuth 7개, 로컬 3개,
123123
기본 ChatGPT 포워드 프리셋 1개입니다. 대시보드의 **Add provider** 선택기는 키 발급 페이지를 열고,
124124
입력한 키를 검증한 뒤 저장합니다. 주요 항목은 다음과 같습니다:
125125

126+
**ClinePass**는 Cline API 키로 [공식 구독 카탈로그](https://docs.cline.bot/getting-started/clinepass)와
127+
[Chat Completions 엔드포인트](https://docs.cline.bot/api/chat-completions)에 연결합니다. 운영 주체는
128+
[Cline 약관](https://cline.bot/tos)에 명시된 Cline Bot Inc.입니다. `cline-pass/cline-pass/kimi-k3`
129+
같은 라우팅 ID는 정상입니다.
130+
앞의 `cline-pass`는 opencodex 프로바이더이고, 뒤의 `cline-pass/kimi-k3`는 upstream에 보내는
131+
전체 모델 slug입니다. ClinePass 사용량은 계정의 5시간 롤링·주간·월간 한도를 함께 사용합니다.
132+
현재 opencodex는 실측된 `low` reasoning 단계만 광고하며, 더 높은 요청은 공식 지원 범위가
133+
게시되거나 검증될 때까지 `low`로 제한합니다.
134+
135+
**Cline**은 동일한 API 키·엔드포인트를 종량제로 사용하며 100개 이상의 모델에 접근합니다
136+
(OpenRouter 형식 ID, 예: `anthropic/claude-sonnet-4-6`). Cline의 프로모션 무료 모델은
137+
Cline IDE/CLI에서만 제공되며 API로는 사용할 수 없습니다. `minimax/minimax-m2.5`는 API에서
138+
사용할 수 있는 무료 체험 모델로 문서화되어 있습니다.
139+
126140
| 프로바이더 | 베이스 URL |
127141
| --- | --- |
128142
| **OpenAI (API key)** | `https://api.openai.com/v1` |
129143
| **Anthropic (API key)** | `https://api.anthropic.com` |
130144
| **OpenRouter** | `https://openrouter.ai/api/v1` |
145+
| **Cline** | `https://api.cline.bot/api/v1` |
146+
| **ClinePass** | `https://api.cline.bot/api/v1` |
131147
| **Ollama Cloud** | `https://ollama.com/v1` |
132148
| Google Gemini · Google Vertex AI | `https://generativelanguage.googleapis.com` · `https://aiplatform.googleapis.com` |
133149
| Azure OpenAI | `https://{resource}.openai.azure.com/openai` |

‎docs-site/src/content/docs/ko/reference/adapters.md‎

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -38,6 +38,11 @@ interface ProviderAdapter {
3838
유지합니다. `provider.noReasoningModels`에 든 id에는 값을 **아예 보내지 않습니다**.
3939
- `delta.content`(텍스트), `delta.reasoning_content`(thinking), `delta.tool_calls[]`를
4040
스트리밍하고 `usage`를 수집합니다.
41+
- ClinePass는 라이브로 검증된 게이트웨이 형식 `reasoning: { enabled: true, effort: "low" }`을
42+
사용하며, reasoning을 끌 때는 `{ enabled: false }`를 사용합니다. 공개 API 문서에는 현재 이 요청
43+
형식이 명시되어 있지 않습니다. 어댑터는 다른 effort 요청을 검증된 `low`로 조정하고,
44+
`delta.reasoning_content` 또는 `delta.reasoning`을 reasoning delta로 처리하며,
45+
`stream_options.include_usage`로 스트림 usage를 요청하고 비스트림 응답 envelope에서도 usage를 읽습니다.
4146

4247
## `openai-responses`
4348

‎docs-site/src/content/docs/ko/reference/configuration/providers.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -70,6 +70,7 @@ description: 공급자 항목, 인증, 엔드포인트, 모델 카탈로그, 할
7070
| `modelAdapters?` | `Record<string, string>` | 혼합 와이어 게이트웨이를 위한 모델별 `openai-chat` 또는 `openai-responses` 와이어 재정의입니다. 명시적 항목이 레지스트리 기본값보다 우선합니다. DeepSeek 프리셋은 `deepseek-v4-flash`에 네이티브 Responses를 선택할 수 있고, GitHub Copilot은 GPT-5 계열(`gpt-5.3-codex`, `gpt-5.4`, `gpt-5.4-mini`, `gpt-5.5`, `gpt-5.6-luna`, `gpt-5.6-sol`, `gpt-5.6-terra`)을 Responses 전용 기본값으로 선언합니다. 이 모델들은 에이전트 트래픽에서 `/chat/completions`를 거부하기 때문입니다. `gpt-5.4-nano`처럼 기본값이 없는 모델은 여기서 직접 옵트인할 수 있습니다. 단일 와이어 상위 항목과 정식 ChatGPT forward는 재정의를 거부합니다. |
7171
| `reasoningEffortMap?` | `Record<string, string>` | reasoning 레이블의 공급자 전반 와이어 별칭입니다. |
7272
| `modelReasoningEffortMap?` | `Record<string, Record<string, string>>` | reasoning 레이블의 모델별 와이어 별칭입니다. |
73+
| `reasoningWireFormat?` | `"gateway-object"` | `reasoning_effort` 대신 `reasoning: { enabled, effort }`를 받는 OpenAI 호환 게이트웨이용입니다. ClinePass 프리셋이 자동 설정합니다. |
7374
| `noReasoningModels?` | `string[]` | reasoning/thinking 매개변수를 거부하는 모델입니다. |
7475
| `noTemperatureModels?` | `string[]` | 호출자가 지정한 `temperature`를 거부하는 모델입니다. |
7576
| `noTopPModels?` | `string[]` | 호출자가 지정한 `top_p`를 거부하는 모델입니다. |

0 commit comments

Comments
 (0)