OpenCode: OpenCode Installation
最終更新：2026-08-31
--- title: OpenCodeインストール description: OpenCodeの各OSでのインストール方法（ワンクリックインストール、パッケージマネージャーインストール、検証方法）を理解する order: 2 lang: ja
OpenCodeはマルチプラットフォームに対応しています。ワンクリックスクリプトでの迅速な導入を推奨します。
1. 学習内容
- システム環境要件
- ワンクリックインストール方法
- 各プラットフォームのインストール方法
- インストールの検証と起動
2. 環境要件
(1) オペレーティングシステム
| OS | サポート状況 |
|---|---|
| macOS | ✅ 完全サポート |
| Linux | ✅ 完全サポート |
| Windows | ⚠️ WSLの使用を推奨 |
(2) ターミナルツール
最高の体験を得るためにモダンなターミナルが必要です：
| ターミナル | プラットフォーム | 説明 |
|---|---|---|
| WezTerm | クロスプラットフォーム | 推奨 |
| Alacritty | クロスプラットフォーム | 高パフォーマンス |
| Ghostty | Linux/macOS | 新興選択肢 |
| Kitty | Linux/macOS | GPUアクセラレーション |
(3) API Key
OpenCode自体はモデルを提供せず、AIサービスプロバイダーの設定が必要です：
- OpenCode Zen（公式厳選、無料モデル含む）
- OpenAI（GPT）
- Anthropic（Claude）
- DeepSeek
- Alibaba Bailian
- GLM / MiniMax
3. ワンクリックインストール（推奨）
macOS / Linux / WSL向け：
BASH
curl -fsSL https://opencode.ai/install | bash
インストール完了後、プロジェクトディレクトリに移動して起動：
BASH
cd <project>
opencode
4. Node.jsインストール
Node.jsエコシステムに慣れている場合：
BASH
npm install -g opencode-ai
pnpmを使用する場合：
BASH
pnpm install -g opencode-ai
yarnを使用する場合：
BASH
yarn global add opencode-ai
5. 各プラットフォームのインストール
(1) macOS（Homebrew）
BASH
brew install anomalyco/tap/opencode
公方tapの使用を推奨。更新が速い。
brew install opencodeは更新が遅い。
(2) Windows
WSLの使用を推奨。より安定し、全機能を完全にサポート。
その他の方法：
BASH
# Chocolatey
choco install opencode
# Scoop
scoop install opencode
# NPM
npm install -g opencode-ai
# Mise
mise use -g github:anomalyco/opencode
# Docker
docker run -it --rm ghcr.io/anomalyco/opencode
GitHub Releasesページからバイナリを直接ダウンロードすることも可能。
(3) Linux
BASH
# 汎用方法（推奨）
curl -fsSL https://opencode.ai/install | bash
# Arch Linux
sudo pacman -S opencode
# または
paru -S opencode-bin
# Docker
docker run -it --rm ghcr.io/anomalyco/opencode
6. インストールの検証
BASH
opencode --version
以下のような出力があればインストール成功：
TEXT
📖 参照専用
1.1.50
7. OpenCodeの起動
BASH
opencode
EACCES: permission deniedエラーが発生した場合、ディレクトリ権限を修正：
BASHsudo chown -R $(whoami) ~/.local chmod -R 755 ~/.local
8. 権限問題のトラブルシューティング
| 問題 | 解決策 |
|---|---|
| EACCES: permission denied | sudo chown -R $(whoami) ~/.local |
| command not found | PATHにインストールディレクトリが含まれているか確認 |
| バージョンが古い | opencode upgradeを実行 |
❓ FAQ
Q WindowsネイティブとWSL、どちらを選ぶべきか？
A WSLを推奨。Windowsネイティブは一部機能が制限され、WSLは完全なLinux体験が得られ、OpenCodeとの互換性が高い。
Q インストール後にcommand not foundと表示される場合？
A 通常はPATHの問題。npmグローバルインストールのパスがPATHに含まれていない可能性。
npm prefix -gでグローバルインストールパスを確認し、binディレクトリをPATHに追加。Q AliceはmacOS、BobはWindowsにインストールするが、どちらがスムーズか？
A Aliceの方がスムーズ。macOSはネイティブサポートで1コマンドで完了。BobはWSLのインストールが必要で手順が多い。BobにはWSLの使用を推奨。
Q Dockerインストールの制限は？
A Docker方式はコンテナ内で動作するため、デフォルトではホストのプロジェクトファイルにアクセス不可。
-vでプロジェクトディレクトリをマウントする必要がある：docker run -it --rm -v $(pwd):/workspace ghcr.io/anomalyco/opencode📖 まとめ
- ワンクリックインストール
curl -fsSL https://opencode.ai/install | bashが最速 - WindowsユーザーはWSLを推奨
- Node.jsインストールはフロントエンド開発者に適している
- 権限問題は
chownとchmodで修正 - インストール後は
opencode --versionで検証
📝 練習問題
-
基本問題：お使いのOSにOpenCodeをインストールし、バージョン番号を確認してください。
-
応用問題：2つの異なるインストール方法を試し、それぞれのメリット・デメリットを比較してください。
-
チャレンジ問題：DockerでOpenCodeを実行し、ローカルプロジェクトディレクトリをマウントしてプロジェクトファイルを読み込めるようにしてください。
