複雑な設定なしで、自分のAIモデルをコーディングに使いたいですか？DroidはCLIで外部APIに対応しているため、ワークフローに合ったカスタムモデルを簡単に接続できます。このガイドでは、APIの設定方法、よくある問題の解決方法、DroidでKimiを使う方法を紹介します。まずは読み進めてください。
Droidとは？
Droidは、開発者のコード作成、エラー解決、開発作業をより効率的に支援するAIコーディングツールです。組み込みAIモデルに対応するほか、CLIからカスタムモデルを接続できるため、より柔軟に利用できます。すばやく支援を受けたい場合にも、より自分に合った設定が必要な場合にも、さまざまなコーディングワークフローで役立ちます。
Droidで組み込みAIモデルを使う方法
組み込みAIモデルなら、事前に外部APIへ接続する必要がないため、Droidですぐにコーディングを始められます。アプリをインストールしたら、プラットフォーム内でモデルを選択し、コード分析、機能開発、バグ修正、レビューでAIの支援を利用できます。Droidを使い始める手順は次のとおりです。
ステップ1：Droidをインストールして開く
まず、使用するデバイスにFactory Appをダウンロードしてインストールを完了します。その後、アプリを開いてアカウントにサインインします。これで、アプリ内のDroidと組み込みAI機能を利用できるようになります。
ステップ2：Droidをプロジェクトフォルダーに接続する
作業ディレクトリを、作業するコードベースに設定します。これによりDroidがローカルプロジェクトに接続され、ファイルの読み取り、コード構造の把握、より正確なコンテキストに基づく開発作業の支援が可能になります。
ステップ3：組み込みモデルを選択してプロンプトを入力する
モデルセレクターを開き、Droidで利用できる組み込みAIモデルから1つを選びます。モデルを選択したら、コードベースの分析、バグ修正、コードレビュー、機能開発などを依頼するプロンプトを入力できます。
Droidを外部APIに接続する方法
Droidを外部APIに接続すると、組み込みの選択肢に限定されず、好みのモデルを自由に利用できます。Droid CLIで設定ファイルにカスタムモデルを追加して設定し、保存すると/modelメニューからそのモデルを選択できるようになります。以下ではKimiを簡単な例として、APIキーの設定からモデルの選択まで、一連の設定手順を紹介します。
ステップ1：Moonshot AIでKimi APIキーを取得する
まず、Moonshot AIでKimi APIキーを作成するか、既存のキーをコピーします。Droidはこのキーを使ってKimi APIに接続し、ご自身のアカウント経由でリクエストを送信するため、このキーが必要です。設定ファイル内で安全に使用できるよう、MOONSHOT_API_KEYなどの環境変数として保存することをおすすめします。
ステップ2：Droidの設定ファイルを開く
次に、Droid CLIでカスタムモデルを追加する設定ファイルを開きます。macOSでは、ファイルパスは~/.factory/settings.jsonです。Windows PowerShellでは、%USERPROFILE%\.factory\settings.jsonを使用します。このファイルは、Droidがカスタムモデルの設定を読み込むメインのファイルです。
ステップ3：Kimiをカスタムモデルとして追加する
settings.json内のcustomModels配列にKimiを追加します。これにより、使用するモデル、呼び出すAPIエンドポイント、従うプロバイダー形式、認証に使用するAPIキーがDroidに伝わります。ファイルにすでに他の設定がある場合は、すべてを置き換えず、既存のcustomModels配列内にこのモデルオブジェクトを追加してください。
ステップ4：ファイルを保存してDroidを再起動する
設定を追加したら、ファイルを保存してDroid CLIを再起動します。これにより、Droidが更新後の設定を再読み込みし、新しく追加したカスタムモデルを正しく認識します。
ステップ5：Droid内で/modelを使ってKimiモデルを選択する
Droid CLIを開き、/modelコマンドを実行します。Kimiの設定がCustom modelsセクションに表示されます。リストから選択すると、コーディングセッションでKimiがアクティブなモデルになります。
ステップ6：タスクを実行する
Kimiを選択したら、Droidで実際の作業に使い始めることができます。コードレビュー、バグ修正、コードベースの説明などをプロンプトで試してみてください。DroidはKimi APIを通じてリクエストを送信し、そのタスクにこのモデルを使用します。
Kimi APIを使うメリット
KimiをDroidに接続すると、CLI上の外部モデルにとどまらず、日々の開発ワークフローに組み込める実用的なコーディング支援ツールになります。小規模なコーディング作業から大規模なエンジニアリングタスクまで支援します。Kimi APIを使う主なメリットは次のとおりです。
開発効率を高める
Kimiは、コードの生成、ロジックの説明、修正案の提示を通じて、日常的なコーディング作業をより迅速に進められるよう支援します。簡単な開発支援のために複数のツールを切り替える必要がありません。Droid内でKimiを使えば、定型的なプログラミング作業をより効率よく進められます。
より信頼性の高いコードを書く
Kimiはコードをレビューし、考えられる問題を指摘して、小さなミスが大きな問題になる前に構造の改善を支援します。ロジックを整理し、保守性を高めたい場合に、このような早期のフィードバックは役立ちます。時間をかけて、テスト、更新、理解がしやすいコードの構築につながります。
多様な開発タスクに対応する
Kimiはゼロからコードを書くことだけに限られません。リファクタリング、コードのドキュメント化、不慣れなプロジェクトの理解、さまざまなタスクにおける機能開発の支援にも活用できます。そのため、ワークフローの多くの部分を1つのAIモデルに支援してほしい開発者にとって、柔軟な選択肢となります。
API接続時によくあるエラーのトラブルシューティング
Droidで外部APIキーを接続する手順は通常簡単ですが、設定時の小さなミスが問題を引き起こすことがあります。ほとんどの問題はDroid自体ではなく、設定ファイル、プロバイダー名、APIキー、モデルサーバーの設定に起因します。確認箇所が分かれば、これらのエラーは簡単に修正できることが多いです。
モデルがセレクターに表示されない
~/.factory/settings.jsonのJSON構文を確認してください。レガシー形式を使用している場合は、config.jsonを確認してください。設定の変更はファイル監視によって自動的に検出されます。
カスタムモデルの設定に必要なすべてのフィールドが含まれていることを確認してください。
「Invalid provider」エラー
providerの値が
anthropic、openai、generic-chat-completion-apiのいずれかと完全に一致していることを確認してください。providerフィールドにスペルミスや大文字・小文字の誤りがないか確認してください。
認証エラー
APIキーが有効で、利用可能なクレジットがあることを確認してください。
APIキーにプロバイダーに必要な権限が付与されていることを確認してください。
ベースURLがプロバイダーのドキュメントに記載されたAPIエンドポイントと一致していることを確認してください。
ローカルモデルに接続できない
ollama serveなどを実行し、ローカルモデルサーバーが起動していることを確認してください。ベースURLが正しく、プロバイダーで必要な場合は
/v1/が含まれていることを確認してください。モデルがすでに取得済みか、ローカルで利用できることを確認してください。
レート制限またはクォータエラー
プロバイダーのAPIレート制限と利用クォータを確認してください。
プロバイダーのダッシュボードで利用状況を確認し、制限に達していないかを確認してください。
まとめ
DroidでカスタムAPIを利用すると、AIを使ったコードの構築、テスト、改善をより細かく管理できます。設定が完了すれば、自分のニーズに合ったモデルを中心にコーディングワークフローを組み立てやすくなります。組み込みの選択肢を使い続ける場合でも、外部モデルを接続する場合でも、DroidならAIを開発に柔軟に取り入れられます。カスタム設定を手軽に始めたいなら、DroidでKimiを試してみる価値があります。日々のコーディング作業をよりスムーズかつ迅速に進めるための実用的な選択肢です。