OpenCodeとは何ですか？
OpenCodeは、ターミナルで動作するオープンソースのAIコーディングエージェントで、デスクトップ、IDE、サーバーベースのワークフローからも利用できます。ファイルの読み取り、構造の説明、コードの編集、変更のレビュー、接続されたLLMプロバイダーを通じたタスクの実行を通じて、開発者がコードベースを扱うのを支援します。Kimi APIなどのモデルプロバイダーに接続すると、OpenCodeはそのプロバイダーを使って開発環境内で計画・推論・実行を行います。
OpenCodeでできることは？
プロジェクトに直接働きかけられるAIコーディングワークフローが欲しいときにOpenCodeを選ぶことができます。例えば：
コードの記述・編集・リファクタリング： OpenCodeに機能の追加、既存ファイルの修正、関数のリファクタリング、モジュールの変更方法の説明を依頼できます。最良の結果を得るには、対象となる正確なファイルやディレクトリを指定してください。
エラーのデバッグとテストの生成： OpenCodeはエラー出力を確認し、関連ファイルを読み取り、修正案を提示し、テストを追加できます。障害がプロジェクトのコンテキストに依存する場合に特に有用です。
コード変更のレビュー： コミット前にローカルの変更をOpenCodeでレビューできます。潜在的なバグ、不足しているテスト、一貫性のないパターン、リスクのある変更を検出できます。
開発ワークフローの自動化： OpenCodeは非対話型やサーバーベースのワークフローもサポートしています。例えば、コマンドラインから一度限りのプロンプトを実行したり、ヘッドレスなOpenCodeサーバーを起動して他のクライアントや連携先を接続したりできます。
LLM APIでOpenCodeを設定するための前提条件
LLM APIでOpenCodeを設定する前に、以下を用意してください：
macOS、Linux、またはWSLを推奨するWindowsで動作するターミナル。
Node.js、Homebrew、またはその他対応しているインストール方法。
安全にテストできるプロジェクトフォルダー。
モデルプロバイダーのアカウント。
OpenCodeに関しては、プロバイダーの認証情報が機密情報である点に注意してください。キーを公開の課題（issue）、共有スクリーンショット、ソースファイル、コミット済みの設定ファイルに貼り付けないでください。
ステップ1：OpenCodeをインストールする
OpenCode公式ドキュメントによる最速のインストール方法は、インストールスクリプトを使うことです。ターミナルで以下を実行してください：
OpenCodeはnpm、Homebrew、その他のコマンドによるインストールにも対応しています。デスクトップ版を使いたい場合は、お使いのデバイスに合ったバージョンをダウンロードできます。
ステップ2：OpenCodeを起動する
OpenCodeで作業したいプロジェクトに移動します：
OpenCodeを起動します：
このプロジェクトでOpenCodeを初めて使う場合は、TUI内から初期化してください：
LLM APIでOpenCodeを設定する方法
多くの場合、「OpenCode API」とは、APIキーを介してOpenCodeを外部のLLMプロバイダーに接続することを指します。プロバイダーがモデルを提供し、OpenCodeはプロジェクト内でコーディングエージェントのワークフローを担います。以下の手順では、プロバイダーの例としてKimi APIを使用します。
ステップ1：Kimi APIキーを作成する
Kimi オープンプラットフォームを開きます。コンソールからAPIキーを作成し、パスワードマネージャーやシークレットマネージャーに保存してください。コンソールで完全なキーが一度しか表示されない場合は、ページを離れる前にコピーしておいてください。
ステップ2：モデルプロバイダーを接続する
プロジェクトでOpenCodeを起動します：
OpenCode のインターフェース内で、次を実行します。
Moonshot AI を検索するか、お使いの OpenCode バージョンに表示される Kimi 対応プロバイダーの項目を探してください。OpenCode の公式プロバイダードキュメントには Moonshot AI プロバイダーの設定手順が記載されています。Moonshot AI コンソールでキーを作成し、/connect を実行して Moonshot AI を検索し、API キーを入力します。
お使いのバージョンに Moonshot AI が表示されない場合は、OpenCode を更新してモデル一覧を更新してください。
ステップ3：Kimi API キーを入力する
OpenCode が API キーを求めたら、Kimi API キーを貼り付けてください。
OpenCode はプロバイダーの認証情報をローカルの認証ファイルに保存します。公式のプロバイダードキュメントには、このパスが記載されています。
通常、このファイルを直接編集する必要はありません。代わりに OpenCode の /connect プロバイダーフローを使用してください。
ステップ4：Kimi モデルを選択する
プロバイダーを接続したら、OpenCode 内でモデルを選択します。
使用したい Kimi モデルを選択します。新しいコーディングエージェントのワークフローには、まず次のモデルから始めてください。
特定のモデルを指定して OpenCode を非対話モードで実行する必要がある場合は、お使いの OpenCode のモデル一覧に表示される provider/model 形式を使用してください。例：
その後、OpenCode が表示する正確なモデル識別子を使用してください。
ステップ5：最初のコーディングタスクを実行する
まずはリスクの低いタスクから始めて、プロバイダー、モデル、プロジェクトへのアクセス、権限がすべて正しく機能することを確認してください。
期待される結果：
次に、小さなコーディングタスクを試してみます。
これにより、変更を許可する前に、OpenCode がプロジェクトを読み取り、コードベースについて推論できることを確認できます。
OpenCode で Kimi API を使う理由
コーディングやエージェントのワークフロー向けに OpenAI 互換のモデルプロバイダーを探している場合、Kimi API は OpenCode に適した選択肢です。
高いコーディング・推論能力
{{KIMI_MODEL_LATEST_FULL}} は、長期にわたるコーディング、指示への追従、自己修正、エージェントの実行を公式にサポートするモデルとして位置づけられています。そのため、複数ファイルにわたる編集、デバッグ、リファクタリング、レビューといった OpenCode のタスクに適しています。
大規模プロジェクトに対応する長文コンテキストサポート
{{KIMI_MODEL_LATEST_FULL}} の公式ドキュメントには、{{KIMI_MODEL_LATEST_FULL}} およびいくつかの K2 系モデルの長文コンテキストサポートが記載されています。エージェントのワークフローでは、複数のファイルを読み取ったり、実装パターンを比較したり、大量のタスク履歴を保持したりする必要がある場合に、長文コンテキストが役立ちます。
セットアップを簡単にする OpenAI 互換 API
Kimi API は OpenAI の API 形式と互換性があります。OpenAI スタイルのチャット補完に対応済みのツールであれば、多くの場合、API キー、ベース URL、モデル名を設定するだけで済みます。
OpenCode 以外での柔軟な利用
同じ Kimi API キーを、他の OpenAI 互換の開発ツール、直接記述したスクリプト、社内ワークフローなどでも使用できます。後で OpenCode サーバーや OpenCode SDK を使用する場合は、先に Kimi をモデルプロバイダーとして設定してください。
知っておくべき OpenCode API の主な設定項目
これらの設定項目が、OpenCode の API およびプロバイダー設定に関する問題の大部分を左右します。
API キー
API キーは、モデルプロバイダーに対してリクエストを認証するためのものです。OpenCode では通常、次のようにして設定します。
プロバイダー
プロバイダーは、モデルの提供元を OpenCode に伝えるものです。本ガイドでは、プロバイダーは Moonshot AI / Kimi API です。他のプロバイダーも個別に設定できますが、各プロバイダーごとに専用の認証情報とモデル一覧が必要です。
ベース URL
ベース URL は、OpenAI 互換の API リクエストを直接送る際に使用するエンドポイントです。Kimi API の例では、最新の Kimi API ドキュメントまたはアカウントコンソールに表示されているエンドポイントを使用してください。
モデル名
モデル名はプロバイダー側の表記と正確に一致させる必要があります。わずかな入力ミスでも「モデルが見つからない」エラーの原因になります。
一般的な例:
OpenCode では、次のコマンドでプロバイダー/モデルの識別子を確認できます。
OpenCode API のよくあるエラーのトラブルシューティング
セットアップに関する問題の多くは、認証情報、エンドポイント、プロバイダー、モデル名、コンテキストサイズのいずれかに原因があります。
認証に失敗する
API キーが誤って貼り付けられた、削除された、あるいは再発行された場合に認証が失敗することがあります。また、選択しているプロバイダーが間違っている場合や、キーが OpenCode で現在設定されているアカウントやリージョンと異なる場合にも発生します。
対処方法:
プロバイダーを再接続し、新しい API キーを貼り付けてください。環境変数を使って直接テストしている場合は、キーをリセットします。
無効なエンドポイントエラー
無効なエンドポイントエラーは、通常 OpenCode が正しいプロバイダーのエンドポイントに到達できないことを意味します。よくある原因として、ベース URL のスペルミス、ツール間で .ai と .cn のエンドポイントを混在させて使っている、あるいはプロキシやファイアウォールがプロバイダーに届く前にリクエストを書き換えている、といったことが挙げられます。
対処方法:
最新の Kimi API ドキュメントやコンソールに表示されているエンドポイントを確認してください。API を直接テストする場合は、常に一つのエンドポイントに統一して使用します。
モデルがサポートされていない
このエラーは、モデル名のスペルミス、選択したモデルがアカウントで利用できない、または OpenCode のモデル一覧キャッシュが古い場合に発生することがあります。また、OpenCode が使用するプロバイダー/モデルの識別子が、プロバイダーのドキュメントに記載されている元のモデル名と異なる場合にも起こります。
対処方法:
その後、もう一度モデルを選択してください。
レート制限に達した
レート制限エラーは、通常プロバイダーに対して短時間に多くのリクエストが送られたことを意味します。これは、複数の Agent タスクが同時に実行されている場合や、スクリプトや連携ツールが失敗したリクエストを過度に再試行している場合に発生することがあります。
対処方法:
タスクを一時停止し、並列実行数を減らして、プロバイダーのコンソールでクォータや請求状況を確認してください。OpenCode や Kimi API への直接呼び出しの周りに無限リトライループを書かないようにしましょう。
コンテキストウィンドウのオーバーフロー
コンテキストウィンドウのオーバーフローは、通常タスクがモデルが一度に処理できる量を超えていることを意味します。これは、多数のファイルが含まれている場合、OpenCode にリポジトリ全体を調べるよう指示した場合、あるいは長時間のセッションで会話履歴が積み重なりすぎた場合に発生することがあります。
対処法：
OpenCode に、より小さな範囲での作業を依頼します。
より限定的なタスクの場合は、新しいセッションを開始することもできます。
まとめ
OpenCode は、あなたのコードベースをモデルプロバイダーに接続し、ターミナルからコーディングタスクを実行できます。Kimi API は、OpenAI 互換のセットアップを通じて、こうしたワークフローのモデルバックエンドを提供できます。実用的なコーディング Agent のワークフローを構築したい場合は、Kimi API キーを作成し、OpenCode で Moonshot AI を接続し、Kimi モデルを選択して、小規模なプロジェクトタスクを実行してセットアップを確認してください。
よくある質問
/connect からそれを入力してください。OpenCode はプロバイダーの認証情報をローカルに保存し、公式ドキュメントでは認証情報ファイルのパスとして ~/.local/share/opencode/auth.json が示されています。opencode models を実行してください。Kimi API の場合は、OpenCode のモデル一覧に表示される正確な Kimi モデル識別子（アカウントで利用可能な場合の kimi-k2.6 など）を選択してください。/connect。