セットアップエラーで作業が中断したり、ツールが期待どおりに動作しなかったりすると、OpenCodeのインストールは複雑に感じることがあります。コマンドが見つからない、Node.jsの互換性に問題があるなど、初回インストール時につまずくケースは少なくありません。このOpenCodeインストールガイドでは、よくあるエラーの解決方法と、DesktopまたはCLI/TUIでMac・WindowsにOpenCodeを正しくセットアップする手順を詳しく解説します。すぐにコーディングを始められます。
OpenCodeとは？
OpenCodeは、ターミナル、IDE、デスクトップアプリケーションなど、好みの環境から直接コードの作成、編集、デバッグ、管理を行えるよう開発者を支援するオープンソースのAIコーディングエージェントです。主にコード提案に重点を置く従来のAIコーディングアシスタントとは異なり、OpenCodeはコードベース全体を理解し、ファイルを変更し、コマンドを実行して、開発ワークフローを自動化できます。複数のAIモデルやローカルモデルにも対応しているため、開発者はソフトウェアの構築方法をより柔軟に制御できます。
OpenCodeをインストールするための前提条件
OpenCodeをインストールする前に、システムが基本要件を満たしていることを確認してください。必要な条件は、デスクトップアプリケーションとターミナルベースのインターフェースのどちらを使用するかによって異なりますが、事前に適切な環境を整えておくと、スムーズにインストールできます。
デスクトップ版
オペレーティングシステム： macOS / Windows / Linux
OpenCodeは主要なオペレーティングシステム向けのデスクトップアプリケーションを提供しており、開発者は好みの環境にインストールして利用できます。macOS（Apple SiliconまたはIntel）、Windows（x64）、Linux（.deb、.rpm）など、互換性のあるオペレーティングシステムを使用していることを確認してください。
アプリをインストールする権限： デバイスにソフトウェアをダウンロードしてインストールするには、管理者権限またはシステムレベルの権限が必要になる場合があります。特に、インストール権限が制限されている職場やIT管理下の環境では重要です。
安定したインターネット接続： セットアップ時および利用中にOpenCodeをダウンロードし、アップデートをインストールし、対応するAIモデルやサービスに接続するには、安定したインターネット接続が必要です。
Terminal/TUI向け
ターミナルへのアクセス： OpenCodeはコマンドラインから直接インストールして使用できます。macOSのTerminal、Windowsのコマンド プロンプトまたはPowerShell、Linuxのシェルなど、ターミナルアプリケーションにアクセスできることを確認してください。
いずれか1つのインストール方法： OpenCodeは、さまざまなOSや開発者の好みに対応するため、複数のインストール方法をサポートしています。npm、curl、brew、Scoop、Chocolatey、WSLなど、環境に最も適したパッケージマネージャーまたはインストールツールを選択してください。
基本的なコマンドライン操作スキル： 一般的なターミナルコマンドに慣れていると、インストールや日常的な利用がより簡単になります。高度な専門知識は必要ありませんが、基本的な操作とコマンドの実行方法を理解しておくことをおすすめします。
OpenCode Desktopのインストール方法
OpenCode Desktopは、いくつかの簡単な手順でインストールして起動できます。以下の手順に従ってください。
ステップ1：OpenCode Desktopをダウンロードする
OpenCodeの公式ダウンロードページにアクセスし、Windows版またはmacOS版のアプリケーションを選択します。インストーラーがシステムに自動でダウンロードされます。安全性と正規性を確保するため、必ず公式サイトからダウンロードしてください。
ステップ2：インストーラーを実行する
ダウンロードしたインストーラーファイルを見つけ、ダブルクリックしてインストールを開始します。画面の指示に従ってセットアップを完了してください。
ステップ3：インストールを完了する
表示されるセットアップ画面に従って進み、求められた場合はインストール先のディレクトリを選択します。その後、インストーラーがシステム上でセットアップを完了するまで待ちます。
ステップ4：OpenCode Desktopを起動する
インストールが完了したら、スタートメニューまたはデスクトップのショートカットからOpenCode Desktopを開きます。新しいプロジェクトを開始するか、既存のフォルダを開いて作業を始めましょう。ワークスペースが読み込まれたら、AIアシスタントとやり取りして、プロジェクト内で直接コードの生成、問題のデバッグ、機能の構築を行えます。
MacにOpenCode Terminal/TUIをインストールする方法
Mac向けのOpenCode Terminal（TUI）は、公式パッケージマネージャーまたは1行のインストールコマンドで直接インストールできます。グラフィカルインターフェースではなくターミナルで作業したい開発者向けに設計されています。以下の手順でMacにOpenCode TUIをインストールしてください。
ステップ1：OpenCode Terminalのインストール方法を選ぶ
OpenCodeの公式ダウンロードページにアクセスし、OpenCode Terminalセクションに移動します。ここでは、curl、Homebrew、npm、bunなど、複数のインストール方法を確認できます。開発環境に最も適した方法を選び、対応するインストールコマンドをコピーしてください。
ステップ2：MacでTerminalアプリケーションを開く
MacでTerminalアプリを起動します。「アプリケーション」>「ユーティリティ」>「Terminal」から開くか、Spotlight検索で素早く見つけることができます。ここでOpenCodeのインストールコマンドを実行します。
ステップ3：OpenCode Terminalをインストールする
次のインストールコマンドをTerminalに貼り付け、Enterキーを押します。
curl -fsSL https://opencode.ai/install | bashインストールが完了するまで待ちます。OpenCodeが必要なファイルをダウンロードし、CLIを自動的にセットアップします。
ステップ4：OpenCodeターミナルインターフェースを起動する
インストールが完了したら、ターミナルでOpenCodeコマンドを実行して、ターミナルユーザーインターフェース（TUI）を起動します。対話型インターフェースがターミナルウィンドウで直接開き、AIプロバイダーへの接続、設定の構成、OpenCodeでの作業を開始できます。
WindowsでOpenCodeターミナル／TUIをインストールする方法
OpenCodeはWindowsで、WSL、npm、bunなど複数のインストール方法に対応しています。互換性と使いやすさの観点から、公式ドキュメントではWindows Subsystem for Linux（WSL）の使用を推奨しています。以下ではWSLを使ったインストール方法を説明します。すでにWSLをインストール済みの場合は、最初の手順を省略できます。
ステップ1：WSLをインストールする（推奨）
PowerShellを管理者として開き、次のコマンドを実行します。
wsl --installこのコマンドによりWindows Subsystem for Linux（WSL）が有効になり、既定でUbuntuがインストールされます。インストールが完了したら、コンピューターを再起動してください。初めてUbuntuを開く際は、WindowsがLinux環境のセットアップを自動的に完了します。
ステップ2：WSLを開いてOpenCodeをインストールする
Windowsのスタートメニューから、UbuntuなどのWSLターミナルを起動します。初めて開く場合は、初期設定を完了してください。次に、以下のコマンドを実行してOpenCodeをインストールします。
curl -fsSL https://opencode.ai/install | bashインストールが完了するまで待ってから次に進んでください。
ステップ3：インストールを確認する
インストールが完了したら、次のコマンドを実行します。
opencodeOpenCodeターミナル／TUIが正常に起動すれば、インストールは完了です。AI支援によるコーディングにOpenCodeを使い始められます。
OpenCodeに外部APIを統合する方法
OpenCodeの主な利点の一つは、API連携を通じて外部AIモデルプロバイダーに接続できることです。独自のAPIキーを追加すれば、さまざまな言語モデルにアクセスし、コーディングのワークフローに最適なモデルを選択できます。
OpenCodeに外部APIを統合する手順（一般的な手順）
以下に、OpenCodeへ外部APIを統合する手順を示します。imi
ステップ1：アカウントを作成し、APIキーを発行する
まず、Kimiなどの対応サービスを含む、利用したいAIプロバイダーでアカウントを作成します。アカウントの設定後、プロバイダーのAPIキー管理ページに移動し、新しいAPIキーを発行してください。このキーはプロバイダーをOpenCodeに接続する際に必要となるため、安全に保管してください。
ステップ2：プロバイダー接続メニューを開く
OpenCodeを起動し、ワークスペースを開きます。コマンドインターフェースで次のコマンドを実行します。
/connectこのコマンドを実行すると、外部AIサービスを追加・管理できるプロバイダー接続メニューが開きます。
ステップ3：APIキーを追加する
利用可能なオプションの一覧から、使用するプロバイダーを選択します。求められたら、先ほど発行したAPIキーを貼り付け、接続を確認してください。OpenCodeはキーを安全に保存し、選択したプロバイダーへのリクエストを認証するために使用します。
┌ API key
│
│ your_api_key_here
│
└ enterステップ4：利用可能なモデルを確認する
プロバイダーを接続したら、次のコマンドを実行して、そのAPIで利用可能なすべてのモデルを確認します。
/modelsOpenCodeに、対応モデルの一覧と各モデル名、設定オプションが表示されます。
ステップ5：モデルを選択して利用を開始する
利用可能な一覧から、使用するモデルを選択します。選択後、OpenCodeはそのモデルを介してリクエストを処理するため、接続したAPIを使ってコード生成、アプリケーションのデバッグ、その他の開発タスクを実行できます。要件が変わった場合は、後からモデルを切り替えることもできます。
Kimi APIをOpenCodeに統合する
OpenCodeは複数のAIプロバイダーに対応しており、開発者はAPIキーを使って外部モデルを接続できます。柔軟性の高い選択肢の一つがKimi APIです。
Moonshot AI Open Platformが提供するKimi APIでは、OpenAI互換のインターフェースを通じて高度なKimi言語モデルを利用できます。安全なAPIキーを使用して、コーディングツール、アプリケーション、AIを活用したワークフローに簡単に統合できます。このプラットフォームには、コーディング、推論、長文コンテキストの理解に最適化された各種Kimiモデルが用意されています。
以下の手順で、Kimi APIをOpenCodeに統合します。
ステップ1：Moonshot AIアカウントを作成し、APIキーを生成する
Kimi AI Open Platformにアクセスし、アカウントにサインインします。
ダッシュボードでAPI Keysに移動し、Create API Keyをクリックします。
キーが生成されたら（
sk-で始まります）、すぐにコピーして安全な場所に保存してください。キーは一度しか表示されず、OpenCodeとMoonshot AI間のリクエストを認証するために使用されます。
ステップ2：Moonshot AIをOpenCodeに接続する
OpenCodeのワークスペースを開き、次を実行します。
/connectプロバイダー接続メニューが表示されます。組み込みプロバイダーの一覧からMoonshot AI（またはKimi）を検索して選択します。OpenCodeからAPIキーの入力を求められます。
入力を求められたら、Moonshot AIコンソールで生成したAPIキーを貼り付け、Enterキーを押します。
┌ API key
│ sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
│
└ enter検証が完了すると、OpenCodeは認証情報を~/.local/share/opencode/auth.jsonに安全に保存し、Moonshot AIプロバイダーの設定に関連付けます。
注：OpenCodeはセキュリティのため、APIキーをメイン設定ファイルとは別に保存します。
/connectコマンドが認証情報の保存を処理し、プロバイダーの動作はopencode.jsonで設定します。
ステップ3：opencode.jsonでプロバイダーを設定する（必要な場合）
接続後にNo endpoints foundエラーが発生する場合や、プロバイダー設定をカスタマイズする必要がある場合は、opencode.jsonファイルにMoonshot AIの設定を追加します。
{"$schema": "https://opencode.ai/config.json","provider": {"moonshotai": {"name": "Moonshot AI","options": {"baseURL": "https://api.moonshot.ai/v1"},"models": {"kimi-k3": {"name": "Kimi K3"},"kimi-k2.7-code": {"name": "Kimi K2.7 Code"}}}}}ファイルを保存し、OpenCodeを再起動して変更を適用します。
ステップ4：利用可能なKimiモデルを確認する
プロバイダーを接続したら、次を実行します。
/modelsOpenCodeに、Moonshot AIアカウントを通じて利用可能なすべてのモデルが表示されます。以下を含みます。
| モデル | 説明 |
|---|---|
| kimi-k3 | 100万tokenのコンテキストウィンドウと、高度なコーディング・推論機能を備えた最新のフラッグシップモデル |
| kimi-k2.7-code | 256Kコンテキストと思考モードを備えた、コーディング専用モデル |
| kimi-k2.7-code-highspeed | より高速な出力を実現するコーディングモデルの高速版 |
| kimi-k2.6 | 256Kコンテキスト、思考モードと非思考モードを備えた汎用モデル |
ステップ5：Kimiモデルを選択してコーディングを始める
moonshotai/kimi-k3を選択し、アクティブなモデルとして設定します。選択後、OpenCodeは指定したKimiモデルをコード生成、デバッグ、リファクタリング、その他のAI支援開発タスクに使用します。
同じモデル選択メニューから、いつでも別のモデルに切り替えられます。
ヒント：Agent/Toolモードで問題（JSON Schemaの検証エラーなど）が発生する場合、これはMoonshot AIの厳格なスキーマ要件とOpenCodeのツールパラメータ形式の間で生じる既知の互換性問題です。安定性を高めるにはChatモードの使用を検討するか、
opencode-moonshot-compatibilityプラグインをインストールして温度設定の互換性を自動的に処理してください。
Kimi APIを使用するメリット
Kimi APIは、チームがアイデアから実装へより効率的に進めるよう支援し、現代的な開発ワークフローを支えるよう設計されています。コード生成にとどまらず、さまざまな種類の入力を理解し、プロジェクトの要件に適応し、定型的なエンジニアリング作業を自動化できます。主なメリットは次のとおりです。
マルチモーダル入力を実装可能な形に変換
Kimi APIは、デザインモックアップ、アーキテクチャ図、フローチャート、動画など、複数の形式の情報を解釈できます。こうしたコンテキストからプロジェクト要件を理解し、技術仕様や動作するコードに変換します。そのため、チームは手作業での変換を減らし、コンセプトから実装へと進めます。
長期にわたるコーディングと複雑なエンジニアリング作業に対応
Kimi APIは、計画、一貫性、改善を必要とする大規模なコーディング作業をOpenCodeで扱えるようにします。機能開発、コードのリファクタリング、複雑なエンジニアリング上の問題解決に役立ちます。
複数ステップのツール呼び出しで問題を解決
Kimi APIは、複数ステップのタスクを推論し、必要に応じてツールを呼び出せます。これにより、デバッグ、コード分析、1回の応答では完了できないワークフローに対応できます。
OpenCodeのインストール時に問題が起きた場合の対処法は？
OpenCodeのインストールは通常簡単ですが、環境の不一致、依存関係、設定上の問題により、よくあるセットアップエラーが発生することがあります。以下では、頻出するインストールの問題を迅速かつ効率的に解決するための、わかりやすく実用的なガイドを紹介します。
コマンドが見つかりません: opencode
このエラーは、システムがPATH内でOpenCodeの実行ファイルを見つけられないことを意味します。通常は、インストールが完了していないか、環境変数が正しく設定されていない場合に発生します。
まずインストールを確認し、バイナリディレクトリがシステムのPATHに追加されていることを確認してください。npmでインストールした場合は、グローバルnpmのbinパスを確認し、それに応じてシェル設定を更新します。修正後にターミナルを再起動すると、多くの場合は問題が解決します。
Node.jsのバージョンが古すぎる
Node.js環境が必要なのはnpmによるインストールのみです。インストールスクリプトとパッケージマネージャー（Homebrew、Scoop、Chocolatey）は、Node.jsを必要としないスタンドアロンバイナリをインストールします。
npmでインストールしてバージョンエラーが発生した場合は、node --versionで現在のバージョンを確認し、nvmなどのバージョンマネージャーでNode.jsをアップグレードしてください。アップグレード後は、更新されたランタイム環境との互換性を確保するため、OpenCodeを再インストールします。
npmの権限エラー
権限エラーは通常、npmが適切な書き込み権限なしにグローバルパッケージをインストールしようとしたときに発生します。
sudoを使用する代わりに、ホームフォルダ内にnpmグローバル用の専用ディレクトリを設定し、PATH設定を更新してください。これにより、より安全で安定したインストールが可能になります。権限を修正した後、インストールコマンドを再実行してセットアップを完了してください。
ネットワーク／ファイアウォールの問題
制限されたネットワークや企業環境では、npmレジストリへのアクセスがブロックされたり、ダウンロードが遅かったりするため、OpenCodeのインストールに失敗する場合があります。
この問題を解決するには、別のnpmレジストリに切り替えるか、curlやバイナリダウンロードなどの直接インストール方法を使用してください。また、接続がブロックされるとパッケージのインストールが中断されることが多いため、ファイアウォールがNode.jsとnpmの通信を許可していることも確認してください。
TUIの表示に関する問題
OpenCodeは起動するものの、表示が崩れる、位置がずれる、文字化けする場合は、通常ターミナルの互換性に問題があります。
Windows Terminal、WezTerm、iTerm2など、True ColorとUnicode表示に対応したモダンなターミナルエミュレーターを使用してください。ターミナル設定を更新するか環境を切り替えることで、通常は表示の問題をすぐに解決できます。
まとめ
OpenCodeを適切にインストールし、正しく設定することで、さまざまなシステムで安定して動作し、よくあるセットアップエラーのリスクを減らせます。依存関係、ターミナル設定、API接続を適切に管理すれば、問題を迅速に解決し、安定した開発環境を維持できます。Kimi APIのような外部サービスを統合すると、ワークフロー内で高度なモデルにアクセスできるようになり、柔軟性がさらに高まります。