OpenCode のインストールは、セットアップ中にエラーが発生したり、ツールが期待どおりに動作しなかったりすると、戸惑うことがあります。コマンドの不足から Node.js の互換性の問題まで、多くのユーザーが最初のインストールでつまずきます。この OpenCode インストールガイドでは、よくあるエラーを解消し、Desktop 版でも CLI/TUI 版でも、Mac と Windows で OpenCode を確実にセットアップするための完全な手順を紹介します。これにより、余計な手間をかけずにコーディングを始められます。
OpenCode とは？
OpenCode は、開発者がターミナル、IDE、デスクトップアプリケーションなど、使い慣れた環境から直接コードの記述・編集・デバッグ・管理を行えるように設計された、オープンソースの AI コーディング Agent です。コード提案を中心とする従来の AI コーディングアシスタントとは異なり、OpenCode はコードベース全体を理解し、ファイルを変更し、コマンドを実行し、開発ワークフローを自動化できます。また、複数の AI モデルやローカルモデルにも対応しているため、開発者はソフトウェア構築の方法についてより高い柔軟性と制御を得られます。
OpenCode インストールの前提条件
OpenCode をインストールする前に、システムが基本要件を満たしていることを確認してください。具体的な前提条件は、デスクトップアプリケーションを使うかターミナルベースのインターフェースを使うかによって異なりますが、適切な環境を整えておくことでインストール作業をスムーズに進められます。
デスクトップ版の場合
オペレーティングシステム： macOS / Windows / Linux
OpenCodeは主要なOSに対応したデスクトップアプリケーションを提供しており、開発者は好みの環境にツールをインストールして利用できます。macOS（Apple SiliconまたはIntel）、Windows（x64）、Linux（.deb、.rpm）など、対応OSを使用していることを確認してください。
アプリのインストール権限： デバイスにソフトウェアをダウンロード・インストールするには、管理者権限またはシステムレベルの権限が必要になる場合があります。職場や管理されたIT環境では、インストール権限が制限されていることがあるため特に注意が必要です。
安定したインターネット接続： OpenCodeのダウンロード、アップデートのインストール、セットアップおよび利用中に対応するAIモデルやサービスへ接続するには、スムーズなインターネット接続が必要です。
ターミナル/TUIの場合
ターミナルへのアクセス： OpenCodeはコマンドラインから直接インストールして使用できます。macOSのTerminal、WindowsのコマンドプロンプトやPowerShell、Linuxのシェルなど、ターミナルアプリケーションにアクセスできることを確認してください。
一つのインストール方法： 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をインストールする
以下のインストールコマンドをターミナルに貼り付け、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のスタートメニューから、WSLターミナル（Ubuntuなど）を起動します。初めて開く場合は、初期セットアップを完了してください。その後、次のコマンドを実行してOpenCodeをインストールします。
curl -fsSL https://opencode.ai/install | bash続行する前に、インストールが完了するまで待ちます。
ステップ3：インストールを確認する
インストールが完了したら、次のコマンドを実行します。
opencodeOpenCodeターミナル/TUIが正常に起動すれば、インストールは完了です。これでOpenCodeを使ったAI支援コーディングを始められます。
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 オープンプラットフォームが提供するKimi APIは、OpenAI互換のインターフェースを通じて高度なKimi言語モデルへのアクセスを提供します。安全なAPIキーを使うことで、コーディングツールやアプリケーション、AI駆動のワークフローに簡単に統合できます。このプラットフォームには、コーディング、推論、長文コンテキストの理解タスクに最適化されたさまざまなKimiモデルが用意されています。
以下の手順に従って、Kimi APIをOpenCodeに統合します。
ステップ1：Moonshot AIアカウントを作成し、APIキーを生成する
Kimi AI オープンプラットフォーム にアクセスし、アカウントにサインインします。
ダッシュボードから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-k2.6": {"name": "Kimi K2.6"},"kimi-k2.5": {"name": "Kimi K2.5"}}}}}ファイルを保存し、OpenCodeを再起動して変更を適用します。
ステップ4：利用可能なKimiモデルを確認する
プロバイダーを接続したら、以下を実行します。
/modelsOpenCodeは、Moonshot AIアカウントを通じて利用可能なすべてのモデルを表示します。以下のようなモデルが含まれます。
| モデル | 説明 |
|---|---|
| kimi-k2.6 | 1T MoE アーキテクチャを採用した最新のフラッグシップモデルで、高度なコーディングと推論能力を備える |
| kimi-k2.5 | コーディングと長文コンテキストのタスクに最適化された高性能モデル |
| moonshot-v1-128k | 文書解析向けの長文コンテキストモデル |
| moonshot-v1-32k | 汎用タスク向けのバランス型モデル |
| moonshot-v1-8k | 高速応答向けの短文コンテキストモデル |
ステップ5：Kimiモデルを選択してコーディングを始める
moonshotai/kimi-k2.6を選択し、アクティブモデルとして設定します。選択すると、OpenCodeは選んだKimiモデルを使って、コード生成、デバッグ、リファクタリング、その他のAI支援による開発タスクを行います。
同じモデル選択メニューから、いつでも別のモデルに切り替えることができます。
ヒント：Agent/Toolモードで問題（JSON Schemaの検証エラーなど）が発生する場合、これはMoonshot AIの厳格なスキーマ要件とOpenCodeのツールパラメータ形式との間で既知の互換性の問題です。安定性を重視する場合はChatモードの使用を検討するか、
opencode-moonshot-compatibilityプラグインをインストールしてtemperatureの互換性を自動的に処理させてください。
Kimi API を使用するメリット
Kimi API は、アイデアから実装への移行をより効率的にすることで、現代の開発ワークフローを支援するように設計されています。コード生成だけでなく、さまざまな種類の入力を理解し、プロジェクトの要件に適応し、日常的なエンジニアリング作業を自動化できます。主なメリットは以下のとおりです。
マルチモーダル入力を動作する実装に変換
Kimi API は、デザインモックアップ、アーキテクチャ図、フローチャート、動画など、複数の形式の情報を解釈できます。この文脈を利用してプロジェクトの要件を理解し、技術仕様や機能するコードに変換します。これにより、チームは手作業での変換ステップを減らしながら、コンセプトから実装へと進むことができます。
長期にわたるコーディングや複雑なエンジニアリング作業に対応
Kimi API は、計画性、一貫性、精緻化が求められる大規模なコーディング作業を OpenCode が処理できるように支援します。機能の構築、コードのリファクタリング、複雑なエンジニアリング上の問題解決に有用です。
複数ステップのツール呼び出しで問題を推論
Kimi API は複数ステップにわたるタスクを推論し、必要に応じてツールを呼び出すことができます。これは、デバッグ、コード解析、そして1回の応答では完了できないワークフローに役立ちます。
OpenCode インストール時の問題を解決する方法は？
OpenCode のインストールは通常簡単ですが、環境の不一致、依存関係、設定の問題により、よくあるセットアップエラーに遭遇することがあります。以下では、最も頻発するインストール上の問題を迅速かつ効率的に解決するための、明確で実践的なガイドを紹介します。
Command not found: opencode
このエラーが表示された場合、システムが PATH 上で OpenCode の実行ファイルを見つけられないことを意味します。これは通常、インストールが不完全な場合や、環境変数が正しく設定されていない場合に発生します。
これを解決するには、まずインストールを確認し、バイナリのディレクトリがシステムの PATH に追加されていることを確認してください。npm 経由でインストールした場合は、グローバルの npm bin パスを確認し、それに応じてシェルの設定を更新してください。修正後にターミナルを再起動すると、問題が解決することが多いです。
Node.js のバージョンが古すぎる
OpenCode には Node.js 18 以上が必要で、それより古いバージョンではインストールやランタイムの失敗が発生します。
これを解決するには、node --version で現在のバージョンを確認してください。古い場合は、nvm などのバージョン管理ツールを使って Node.js をアップグレードしてください。アップグレード後は、更新されたランタイム環境との互換性を確保するために OpenCode を再インストールしてください。
npm の権限エラー
権限エラーは、通常、npm が適切な書き込み権限なしにグローバルパッケージをインストールしようとした場合に発生します。
sudo を使う代わりに、ホームフォルダ内に専用の npm グローバルディレクトリを設定し、PATH の設定を更新してください。これにより、より安全で安定したインストールが可能になります。権限を修正した後、インストールコマンドを再実行してセットアップを完了してください。
ネットワーク／ファイアウォールの問題
制限のあるネットワークや企業環境では、npm レジストリへのアクセスがブロックされていたり、ダウンロードが遅かったりすることで、OpenCode のインストールが失敗する場合があります。
これを解決するには、別の npm レジストリに切り替えるか、curl やバイナリのダウンロードなどの直接インストール方法を使用してください。また、ブロックされた接続はパッケージのインストールを妨げることが多いため、ファイアウォールが Node.js と npm の通信を許可していることを確認してください。
TUI の表示に関する問題
OpenCode は開くものの、表示が崩れていたり、ずれていたり、文字が乱れて表示される場合、その問題は通常ターミナルの互換性によるものです。
Windows Terminal、WezTerm、iTerm2 など、トゥルーカラーと Unicode 表示に対応した最新のターミナルエミュレーターを使用してください。ターミナルの設定を更新したり、別の環境に切り替えたりすることで、表示上の問題は通常すぐに解決します。
まとめ
OpenCode を適切にインストールし正しく設定することで、さまざまなシステムでスムーズな動作を実現し、よくあるセットアップエラーのリスクを減らすことができます。依存関係、ターミナルの設定、API 接続を適切に管理すれば、問題を素早く解決し、安定した開発環境を維持できます。Kimi API のような外部サービスを統合することで、ワークフロー内で高度なモデルへのアクセスが可能になり、柔軟性がさらに高まります。