Setup guide - OpenCode
Set up CodeForge for OpenCode
Install OpenCode, use your CodeForge key, run the generated setup script for your platform, and launch either the desktop app or the terminal UI.
1. Install OpenCode
Desktop is the easiest path for most users. If you prefer working in the shell, install the terminal version and keep using the TUI.
Desktop recommended
Download the desktop app, or install the CLI with your preferred package manager.
choco install opencode
scoop install opencode
npm install -g opencode-aiDesktop preferred
Desktop is the smoothest start. You can also install the CLI directly.
brew install anomalyco/tap/opencode
npm install -g opencode-ai
curl -fsSL https://opencode.ai/install | bashDesktop or terminal
Use the desktop build if you want a visual app, or stay fully in the terminal.
brew install anomalyco/tap/opencode
npm install -g opencode-ai
curl -fsSL https://opencode.ai/install | bash2. Download the CodeForge setup utility
Run the native utility, enter your CodeForge API key, and choose OpenCode or Codex. It validates your key and configures only CodeForge settings without replacing your other harness settings.
Choose your platform
The utility is a native executable. No .NET runtime is required on the computer where you run it.
chmod +x <file> and run it from a terminal. The utility waits for confirmation before it exits.
3. Allowed models from your tier
Sign in to see the models available on your plan and generate a ready-to-run setup for them.
Sign in / Sign up4. Manual setup for other OpenAI-compatible clients
Sign in to generate your personal CodeForge endpoint and API key, then apply them to your preferred client.
Sign in / Sign up