# Cline 連携

> **最終確認**：2026-09-18 · 📄 公式ドキュメント準拠（VS Code 拡張 4.1.19、2026-09-17 公開。Cline Desktop は下記）

## 概要

| 項目 | 内容 |
|---|---|
| 利用できるモデル | Claude ✅（方式 A：Anthropic provider）· GPT ✅ · 中国系モデル ✅（方式 B：OpenAI Compatible）· Gemini ❌（本ページは Gemini を扱わない） |
| プロトコルと Base URL | Anthropic：`https://api.qcode.cc/api` · OpenAI：`https://api.qcode.cc/openai/v1` |
| 設定場所 | VS Code 拡張の設定パネル（API Provider + Use custom base URL）。デスクトップ版も同じ思想 |
| 公式ドキュメント | [cline.bot](https://cline.bot) · [GitHub](https://github.com/cline/cline) |

[Cline](https://github.com/cline/cline) は VS Code 向けの AI プログラミング拡張機能（数百万インストール）で、任意の AI モデルやカスタム API エンドポイントに対応しています。Plan / Act の 2 モード、ファイル編集の diff プレビュー、ターミナル実行、MCP ツール呼び出しを標準搭載しています。Cline と QCode.cc API を組み合わせることで、VS Code 内で低コストに Claude、GPT、[国内系モデル](/docs/usage/cn-models) を利用できます。

## Cline を選ぶ理由

- **ゼロマークアップ**：モデル料金への上乗せなし、QCode.cc API の料金のみ

- **マルチモデル切り替え**：同じインターフェースで `claude-sonnet-5`、`claude-opus-5`、`gpt-5.6-terra` などを切り替え可能（4.x も利用可）

- **VS Code との深い統合**：サイドバーパネル、インラインコード操作、ファイル編集の diff プレビュー、自動承認

- **Plan / Act の 2 モード**：先に計画してから実行 — 複雑な変更も制御しやすい

- **完全オープンソース**：コードが透明で、コミュニティが活発

- **MCP 対応**：Model Context Protocol で外部ツール（DB、ブラウザ、ドキュメント）に接続

## インストールと設定

### ステップ 1：Cline 拡張機能のインストール

VS Code で：

1. 拡張機能パネルを開く（`Ctrl+Shift+X` / `Cmd+Shift+X`）

2. **「Cline」** を検索

3. **インストール** をクリック

4. インストール後、左側のアクティビティバーに Cline アイコンが表示されます

> Cline にはコマンドライン版（Cline CLI）もあり、同じ設定をターミナルで再利用できます。本ガイドでは VS Code 拡張機能を中心に説明します。

### ステップ 2：QCode.cc API の設定

QCode.cc の API キー（`cr_` で始まる）1 本で、Anthropic プロトコルと OpenAI プロトコルの両方に対応します。Cline には 2 通りの接続方法があり、**どちらか一方**を選べば OK です：

#### 方法 A：Anthropic 互換（Claude モデルに推奨）

Cline の設定（歯車アイコン）の **API Provider** ドロップダウンで **「Anthropic」** を選択し、以下を入力します：

| 設定項目 | 値 |
|--------|-----|
| API Key | QCode.cc の API キー（`cr_` で始まるもの） |
| Use custom base URL | チェックを入れて `https://api.qcode.cc/api` を入力 |
| Model | `claude-sonnet-5`（日常の既定）または `claude-opus-5`（難しい作業）。`claude-sonnet-4-6` / `claude-opus-4-8` は販売継続 |

> SDK は Base URL の後ろに自動で `/v1/messages` を追加します。そのため Base URL は `/api` までで止め、`/api/v1/messages` と書かないでください。末尾のスラッシュも付けないでください。

#### 方法 B：OpenAI 互換

**API Provider** ドロップダウンで **「OpenAI Compatible」** を選択し、以下を入力します：

| 設定項目 | 値 |
|--------|-----|
| Base URL | `https://api.qcode.cc/openai/v1` |
| API Key | QCode.cc の API キー（`cr_` で始まるもの） |
| Model ID | `gpt-5.6-terra`、`gpt-5.5`、または [国内系 id](/docs/usage/cn-models) の `glm-5.2` など。**`claude-*` は指定できません** |

> 🔴 **OpenAI 互換モードでは Claude を使えません。** QCode の OpenAI エンドポイントは GPT 系と中国系 4 ファミリーのみを提供し、`claude-*` を指定すると `model_not_available_on_endpoint` が返ります。Claude を使うには上の**方式 A（Anthropic）**に戻り、Base URL に `https://api.qcode.cc/api` を指定してください。対応表は [エンドポイントと API パス](/docs/getting-started/endpoints-and-api-paths)。

### ステップ 3：接続の確認

Cline のチャットボックスに簡単なメッセージ（例：「Hello」）を入力し、返答があれば設定完了です。

ターミナルで curl を使って自己確認することもできます（`401` が返れば、パスは正しく認証情報だけが欠けている状態です）：

```bash
# Anthropic プロトコル
curl -i https://api.qcode.cc/api/v1/messages \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5","max_tokens":16,"messages":[{"role":"user","content":"hi"}]}'

# OpenAI プロトコル（このレッグは GPT 系か中国系 id のみ）
curl -i https://api.qcode.cc/openai/v1/chat/completions \
  -H "content-type: application/json" \
  -d '{"model":"gpt-5.5","messages":[{"role":"user","content":"hi"}]}'
```

## バックアップノード

同じキーは 4 つのアクセスドメインで利用でき、互いにバックアップになります。メインドメインが不安定な場合は、Base URL の `api` を下表の対応サブドメインに置き換えてください：

| ノード | Anthropic プロトコル Base URL | OpenAI プロトコル Base URL |
|------|------------------------------|----------------------------|
| デフォルト | `https://api.qcode.cc/api` | `https://api.qcode.cc/openai/v1` |
| アジア太平洋（中国本土で優先） | `https://asia.qcode.cc/api` | `https://asia.qcode.cc/openai/v1` |
| 米国 | `https://us.qcode.cc/api` | `https://us.qcode.cc/openai/v1` |
| 欧州 | `https://eu.qcode.cc/api` | `https://eu.qcode.cc/openai/v1` |

> 中国本土のユーザーは `asia.qcode.cc` を優先すると、通常もっとも低遅延です。詳細は [接続点と API フォーマット](/docs/getting-started/endpoints-and-api-paths) を参照してください。

## Cline Desktop

2026-09-14 に Cline デスクトップ版が公開されました（[公式発表](https://cline.bot/blog/cline-desktop-an-open-source-app-for-open-weight-models) 原文：*"Bring your own API key and connect natively to any provider — Anthropic, OpenAI, Gemini, open-weight models, or a local endpoint"*。[製品ページ](https://cline.bot/desktop) には日付の記載なし）。設定の考え方は拡張版と同じ（API Provider 選択 + カスタム Base URL）。デスクトップ版の項目名は公式文書に単独の記載がないため、実画面を正としてください。ダウンロードと対応 OS：[cline.bot/desktop](https://cline.bot/desktop)。

## Plan / Act の 2 モード

Cline はチャットボックスの下に **Plan** / **Act** の切り替えを備えています：

- **Plan（計画）**：Cline はコードを読み、質問し、実装方針を提案しますが、ファイルは**変更しません**。着手前に要件をすり合わせるのに最適です。

- **Act（実行）**：Cline が実際にファイルの作成・編集、コマンド実行、ツール呼び出しを行います。各変更は diff で表示され、承認または自動承認できます。

典型的なワークフロー：まず **Plan** モードで方針を整理・確認させ、次に **Act** モードに切り替えて段階的に実装します。複雑なタスクでは `claude-opus-5` で計画し、`claude-sonnet-5` で実行するのがおすすめです。4.x は対照用に残っています。

## 使い方のヒント

### 1. モデル選択のおすすめ

| シーン | 推奨モデル | 説明 |
|------|---------|------|
| 日常的なコーディング | `claude-sonnet-5` | 現行バランス枠、1M / 128K。執筆時点の入力単価は 4.6 より低い |
| 複雑なアーキテクチャ設計 / Plan | `claude-opus-5` | 現行旗艦。`claude-opus-4-8` は販売継続 |
| 軽量タスク / 文言修正 | `claude-haiku-4-5` | 最も低コスト |
| GPT スタイルが必要 | `gpt-5.6-terra` | OpenAI プロトコルで直接選択可能 |
| 国内系 / より安い単価 | `glm-5.2` / `deepseek-v4-pro` | [国内系モデルの接続](/docs/usage/cn-models) |

価格の詳細は [課金について](/docs/reference/billing) を参照してください。

### 2. MCP ツールの設定

Cline は Model Context Protocol（MCP）に対応しており、モデルから外部ツール（DB クエリ、ブラウザ、ドキュメント検索など）を呼び出せます。Cline の **MCP Servers** パネルでサーバーを追加します：

```json
{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/project"]
    }
  }
}
```

MCP サーバーは上流モデルから分離されており、QCode.cc に Anthropic / OpenAI のどちらのプロトコルで接続してもツール呼び出しは正常に動作します。各サーバーのインストール手順やパラメータは、そのツールの公式ドキュメントを参照してください。

### 3. プロジェクト単位のカスタム指示（.clinerules）

プロジェクトのルートに `.clinerules` ファイルを作成すると、そのリポジトリ固有のコンテキスト（コードスタイル、技術スタックの規約、ディレクトリ構成など）を固定で注入できます。Cline は毎回の会話でこれらのルールを含めるため、繰り返し貼り付ける必要がありません：

```text
# .clinerules
- 全体で TypeScript（strict モード）を使用
- src/lib 配下のユーティリティを優先的に再利用
- コミット前に `pnpm test` を実行
```

ルールファイルのフィールドや高度な使い方は、Cline の公式ドキュメントを参照してください。

### 4. 画像入力（画像の読み取り）

`claude-opus-5`、`claude-sonnet-5`（および販売継続中の 4.8 / 4.6）、GPT-5.x はいずれも画像入力（ビジョン）に対応しています。UI のスクリーンショット、エラー画面、アーキテクチャ図を Cline のチャットボックスに直接ドラッグして、画像をもとにコーディングやデバッグをさせられます。

> 注意：ここで言うのはモデルに画像を**読み取らせる**ことです。画像を**生成**したい場合は、[gpt-image-2 画像生成](/docs/usage/image-2)（モデル名 `gpt-image-2`）を使用してください。

### 5. 自動承認とコスト管理

- 設定では「ファイル読み取り」「ファイル書き込み」「コマンド実行」ごとに **Auto-approve** を有効化でき、中断を減らせます。リスクの高い操作には手動確認を残すのがおすすめです。

- Cline はリクエストごとのトークン使用量と推定費用を表示するため、支出を把握しやすくなります。複雑なタスクは Plan モードで範囲を絞ると、無駄なやり取りを避けられます。

- 大規模なコードベースでは、モデルにプロジェクト全体を読ませるのではなく、`@`（ファイル/フォルダ/URL の指定）で正確なコンテキストを与えると、トークンを節約でき、より焦点が絞られます。

### 6. Claude Code CLI との併用

Cline と Claude Code CLI にはそれぞれ強みがあり、併用をおすすめします：

| シーン | 推奨ツール |
|------|----------|
| VS Code 内での素早い編集 | Cline |
| 複雑なプロジェクト分析 | Claude Code CLI |
| 複数ファイルのリファクタリング | Cline |
| Git 操作、コードレビュー | Claude Code CLI |
| コードベース全体の移行 / レビュー | Claude Code CLI（[サブエージェント](/docs/advanced/subagents)） |
| CI/CD の自動化 | Claude Code CLI（[ヘッドレスモード](/docs/advanced/headless)） |

### 7. 共有クォータ

Cline と Claude Code CLI は同じ QCode.cc API キーを使用し、プランのクォータを共有します。ツールごとに別のキーを申請する必要はありません。

## よくある質問

### 接続に失敗する / 401 / 404 の場合

1. Base URL の末尾に余分な `/` が**ない**か確認

2. Anthropic モードでは Base URL を `/api` までにする（SDK が `/v1/messages` を補完）。フルパスを手書きしない

3. OpenAI モードでは Base URL を `/openai/v1` までにする

4. API キーが `cr_` で始まり、完全にコピーされているか確認

5. バックアップノードへの切り替えを試す（例：`asia.qcode.cc`）

6. ネットワークが QCode.cc サービスにアクセスできるか確認

### モデルリストが空の場合

OpenAI 互換モードでは、Model ID の入力欄にモデル名（例：`glm-5.3`）を手動で入力してください。リストからの選択は不要です。

### Plan モードでファイルが変更されない

これは想定どおりの動作です。Plan モードは計画のみで、Act モードに切り替えてから変更が書き込まれます。

### 設定は正しそうなのに 401 が出る

`401` は通常、パスは正しく認証だけが失敗している状態を意味します。API Key が完全か、Provider の種類（Anthropic か OpenAI Compatible か）と対応する Base URL を正しく選んでいるか、再確認してください。

## 次のステップ

- [接続点と API フォーマット](/docs/getting-started/endpoints-and-api-paths) で全プロトコルとドメインを確認

- [Aider 連携](/docs/ide/aider) で QCode.cc 対応のもう一つのオープンソースツールを確認

- [VS Code 連携](/docs/ide/vscode) で Claude Code 公式拡張機能を確認

- [国内系モデルの接続](/docs/usage/cn-models) で同じ OpenAI 互換の記入法を GLM / Kimi / DeepSeek / Qwen に使う

- [課金について](/docs/reference/billing) で料金の詳細を確認

> まだ API キーをお持ちでない場合は？[QCode.cc のプランと料金を見る →](https://qcode.cc/pricing)