Tabby:ローカルコード補完をインストールする セルフホスト型

ClineとAiderはチャットとエージェントモードを提供しますが、入力中に「グレーのテキスト」として表示されるインラインのコード自動補完は提供していません。これはGitHub Copilotを特徴づける機能です。Tabbyはまさにこの不足を補います。Tabbyはセルフホスト型のオープンソース(Apache 2.0)コード自動補完サーバーで、Dockerコンテナ内でGPUを使って動作し、エディタ内に直接Fill-In-the-Middleの候補を表示します。このガイドでは、Tabbyを手順に沿ってインストールし、StarCoderまたはQwen-Coderモデルを設定し、トークンを生成してVS CodeとJetBrainsに接続する方法を説明します。また、コードを自分たちのインフラから一切外に出さずに、1つのGPUでチーム全体にサービスを提供する方法も紹介します。
#ClineではなくTabbyを選ぶ理由
TabbyとClineは競合ではなく、補完関係にあります。Cline(およびAider)は会話型チャットとマルチファイルのエージェントモードに優れていますが、どちらも入力中の行単位の自動補完は行いません。一方、Tabbyはそれだけを専門に行い、とても得意としています。2026年の勝ちパターンは、会話とリファクタリングにCline、入力に合わせて現れるグレーの補完候補にTabbyです。
- インライン表示のグレーのテキスト
- カーソルのすぐ後ろに、候補が灰色の文字で表示されます。Tabキーで採用し、Escキーで無視します。操作感はCopilotとまったく同じです。
- 100%セルフホスト
- サーバーはお客様の環境(Docker)で動作します。第三者にコードの一部が送信されません——NDAや規制業界のコードに最適です。
- Multi-utilisateurs
- 純粋にローカルな拡張機能とは異なり、Tabbyはサーバーです。1つのGPUでネットワークを介してチーム全体にサービスを提供できます。
- テレメトリは無効化可能
- Tabbyはデフォルトで匿名統計を送信しますが、環境変数で完全に停止できます。入力したソースコードが送信されることは決してありません。
#前提条件
私たちの経験とガイド付きルートを活かして、ローカルコパイロットを作り、コードアシスタントを使いこなしましょう。
- 永久に利用できるオンラインスペース
- PDF + ファイル
- 30日間返金対応
- Docker
- Tabbyはコンテナとしてデプロイします。Windows/macOSではDocker Desktop、LinuxではDocker Engineを使用します。
- NVIDIA GPU(推奨)
- CUDAへのアクセスにはNVIDIA Container Toolkitを使います。TabbyはCPUでも動作しますが、インライン補完の待ち時間が長くなり、快適に使えなくなります。
- 約6 GBのVRAM
- 量子化された1B~3Bの補完モデルには十分です。VRAMが多ければ、より大きなモデルを使うか、より多くの開発者が同時に利用できます。
- 編集者
- VS CodeまたはJetBrains IDE(IntelliJ、PyCharm、WebStormなど)。Tabby拡張機能は両方にあります。
#どの補完モデルを選ぶか
インライン補完には、チャットにはない制約があります。それはレイテンシーです。候補は数百ミリ秒以内に表示されなければなりません。そうでなければ、候補の表示より速く入力することになります。そのため、チャット向けの大規模なinstructモデルではなく、-baseバリアントのコンパクトなFill-In-the-Middle(FIM)モデルを優先します。
| VRAM | コード補完モデル | 注記 |
|---|---|---|
| 4~6 GB | StarCoder2 3B | 応答が速く、多言語に対応しており、Tabbyの標準的な選択肢として適しています。 |
| 6~8 GB | Qwen2.5-Coder 1.5B / 3B(ベース) | FIMに優れ、非常に高速、FR/Python/TS対応。 |
| 8~12 GB | Qwen2.5-Coder 7B(ベース) | 2026年のFIMの定番モデル(4.7 GB):的確な提案で、レイテンシもまだ低い。 |
| 12 GB+ | StarCoder2 7B / Qwen-Coder 7B | 複数の開発者が同じサーバーを共同利用する場合に。 |
#1. DockerでTabbyを起動する
GPUアクセスを有効にし、データ用の永続ボリュームと選択した補完モデルを指定してTabbyサーバーを起動します。ポート8080でWebインターフェースとAPIを公開します。
- 01起動を確認する初回起動時に、Tabbyがモデルをダウンロードします(数分)。サーバーがポート8080で待ち受けていることを示すメッセージが表示されるまで、docker logs -f tabbyでログを確認してください。
- 02Webインターフェースを開くhttp://localhost:8080 にアクセスしてください。初回アクセス時に、管理者アカウント(メールアドレスとパスワード)の作成を求められます。これはローカル環境で動作するため、これらの認証情報は手元のボリューム ~/.tabby 内に保存されます。
- 03コード補完をテストするインターフェースの「Playground」タブでは、エディタを接続する前でもモデルが応答することを確認できます。
#2. アクセストークンを作成する
エディタはトークンを使ってTabbyサーバーで認証を行います。これにより、チームで誰が接続しているかを把握し、システム全体に支障をきたすことなく個別のアクセス権を取り消せます。
- 01設定に移動Webインターフェース(http://localhost:8080)で、アカウント/セキュリティのセクションを開いてください。現在のユーザーのトークンが表示されます。
- 02トークンをコピー文字列(多くの場合、auth_で始まります)を取得してください。VS CodeとJetBrainsの拡張機能で入力を求められるのは、この文字列です。
- 03必要に応じて再生成する漏洩が起きた場合や、共同作業者が離任した場合は、インターフェースからトークンを再生成してください。古いトークンは直ちに無効になります。
#3. VS Codeを接続する
- 01拡張機能をインストールするExtensions(Ctrl+Shift+X)→「Tabby」(公開元:TabbyML)を検索する → Install。
- 02エンドポイントを入力する初回起動時に、拡張機能がサーバーのURLを要求します。http://localhost:8080(またはネットワーク上で共有されているサーバーのIP)を入力してください。
- 03トークンを貼り付ける前のステップでコピーしたアクセストークンを入力してください。ステータスバーのTabbyアイコンが緑色(接続済み)になるはずです。
- 04Coderコードを入力してください。カーソルの後にグレーの補完候補が表示されます。採用するにはTabキーを押し、無視するにはそのまま入力を続けてください。
#4. JetBrainsを接続する
同じ設定は、IntelliJ IDEA、PyCharm、WebStorm、GoLand、Riderなど、JetBrainsの全製品で使えます。Tabby拡張機能は、このプラットフォームに対応する一つの共通プラグインです。
- 01プラグインのインストールSettings → Plugins → Marketplace → 「Tabby」を検索 → Install、その後IDEを再起動する。
- 02接続を設定するSettings → Tools → Tabby:エンドポイント(http://localhost:8080)とアクセストークンを入力してください。
- 03確認するステータスバーのTabbyインジケーターで接続を確認できます。インラインの候補はVS Codeと同じように表示されます。
#5. Tabby の接続先を自分の Ollama に設定する
すでにClineやAiderのためにOllamaを動作させている場合は、第2の推論エンジンをロードする必要はありません。TabbyはOpenAI互換プロトコルを通じてOllamaバックエンドを利用できます。これにより、補完とチャットのために単一のモデルサーバーを共有できます。
Tabby側では、ローカルモデルの代わりにHTTPバックエンドを指定します。設定はデータボリューム内のconfig.tomlファイル(~/.tabby/config.toml)で行い、補完エンジンの接続先をOllama APIに設定します。
#6. 複数の開発者間でGPUを共有する
純粋にローカルで動作する拡張機能と比べたTabbyの決定的な利点は、1台のサーバーと1基のGPUを複数の開発者で利用できることです。GPUを搭載したマシン(専用の端末やチーム用サーバー)にTabbyをインストールし、各開発者がエディタの接続先をそのネットワークアドレスに設定します。
- ネットワーク上に公開する
- 開発者の端末からポート 8080 にアクセスできる必要があります。内部ネットワークでは、サーバーのローカル IP アドレスで十分です(http://192.168.x.x:8080)。
- 開発者1人あたり1トークン
- インターフェースで開発者ごとにアカウント/トークンを作成してください。追跡可能性を維持し、アクセスを個別に無効にできます。
- 必要なGPUの性能・容量を見積もる
- 小型のコード補完モデル(1.5B〜3B)なら、処理能力の限界に達することなく、複数の開発者が同時に利用できます。補完は短いため、リクエストの処理が重なることはまれです。
- リバースプロキシ+HTTPS
- LAN外からアクセスする場合は、TLS対応のリバースプロキシ(Caddy、Nginx)の背後にTabbyを配置してください。ポート8080を保護されていない状態でインターネットに公開してはいけません。
#パフォーマンス設定とトラブルシューティング
- 遅延が大きすぎる
- モデルを一段小さいものに変更し(3B → 1.5B)、--device cudaが有効でCPUへのフォールバックになっていないことを確認して、補完候補の最大長を制限してください。
- 提案なし
- 拡張機能の状態アイコン(トークンとエンドポイントが正しいか)と、コンテナが稼働しているか(docker ps)を確認してください。Web Playgroundを使うと、問題がサーバー側にあるのか、エディタ側にあるのかを切り分けられます。
- 的外れな提案
- ほぼ常に、FIM 用の prompt_template が間違っているか、-base ではなく instruct 版を使っていることが原因です。ベースモデルに戻し、正しい FIM テンプレートを使ってください。
- リポジトリのインデックス作成(RAG)
- Tabbyはコードにインデックスを作成し、より文脈に即した提案を行えます。GPUに余裕がある場合はインターフェースで有効にし、レイテンシーに影響が出る場合は無効にしてください。
- GPUメモリがいっぱい
- 複数のモデルを併用する場合(Tabbyと、Ollama経由のCline)は、KVキャッシュを量子化し、nvidia-smiでVRAMを監視してください。
#よくある質問
TabbyはClineやCopilotの代わりになりますか?+
TabbyにGPUは必要ですか?+
私のコードはどこかに送信されますか?+
既存のOllamaを再利用できますか?+
単一のTabbyサーバーで何人の開発者をサポートできますか?+
#結論
これで、100%セルフホストのコード自動補完サーバーが整いました。GPUを使ってDockerで動くTabby、Fill-In-the-Middle方式のStarCoderまたはQwen-Coderモデル、アクセストークン、そしてVS CodeでもJetBrainsでも使えるCopilot風の薄いグレーの補完候補表示がそろっています。さらに、1台のGPUでチーム全体にサービスを提供できます。チャットとエージェントにはClineを組み合わせれば、必要な環境がすべてそろい、コードが自分のインフラストラクチャの外に出ることはありません。設定に何時間もかけたくない場合(FIMテンプレート、Ollamaの設定、役割別のモデルなど)、有料ガイド「Copilote de code local」には、すぐに使えるOllama + Cline + Aiderのパッケージが用意されています。インライン自動補完用にTabbyを追加できる構成です。
ご意見、誤りのご指摘、補足はありますか?ぜひお知らせください。皆さんにとってより良いガイドにするために役立ちます。