OpenCode: OpenCode Installation

Last updated: 2026-08-31

OpenCode supports multi-platform installation. The one-click script is recommended for quick setup.

1. What You Will Learn

• System requirements
• One-click installation method
• Platform-specific installation
• Verification and startup

2. System Requirements

(1) Operating Systems

(2) Terminal Tools

A modern terminal is recommended for the best experience:

(3) API Key

OpenCode doesn't include models—you need to configure an AI provider:

• OpenCode Zen (official selection, includes free models)
• OpenAI (GPT)
• Anthropic (Claude)
• DeepSeek
• Alibaba Bailian
• GLM / MiniMax

3. One-Click Installation (Recommended)

For macOS / Linux / WSL:

curl -fsSL https://opencode.ai/install | bash

After installation, navigate to your project and start:

cd <project>
opencode

4. Node.js Installation

If you're familiar with Node.js:

npm install -g opencode-ai

Or with pnpm:

pnpm install -g opencode-ai

Or with yarn:

yarn global add opencode-ai

5. Platform-Specific Installation

(1) macOS (Homebrew)

brew install anomalyco/tap/opencode

The official tap is recommended for faster updates. brew install opencode updates more slowly.

(2) Windows

WSL is recommended for stability and full feature support.

Other methods:

# 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

You can also download binaries directly from the GitHub Releases page.

(3) Linux

# Universal method (recommended)
curl -fsSL https://opencode.ai/install | bash

# Arch Linux
sudo pacman -S opencode
# or
paru -S opencode-bin

# Docker
docker run -it --rm ghcr.io/anomalyco/opencode

6. Verify Installation

opencode --version

Output similar to the following indicates success:

1.1.50

7. Start OpenCode

opencode

If you encounter EACCES: permission denied, fix directory permissions:

BASH

📋 Copy

sudo chown -R $(whoami) ~/.local
chmod -R 755 ~/.local

8. Permission Troubleshooting

❓ FAQ

📖 Summary

• One-click install curl -fsSL https://opencode.ai/install | bash is the fastest method
• Windows users should use WSL
• Node.js installation suits frontend developers
• Fix permission issues with chown and chmod
• Verify with opencode --version

📝 Exercises

1. Basic: Install OpenCode on your OS and verify the version number.

2. Intermediate: Try two different installation methods and compare their pros and cons.

3. Advanced: Run OpenCode in Docker with a mounted local project directory.

Web-Tutorial Tech Team

A team of developers maintaining programming tutorials. Each tutorial is written and reviewed by developers with expertise in that field. We work to keep our content accurate and reliable — if you spot an issue, please let us know.

About Us