Install IQ Code
Choose the installer for your platform or add the IQ Code plugin marketplace.
Before you start
The installers need Claude Code 2.1.287 or later, used in your terminal. IQ Code is tested on macOS, Linux and Windows. Windows needs Git for Windows. The Claude desktop app's Code tab is not verified for IQ Code yet: install from a terminal, then check that /iq opens in the Code tab.
The public release is 1.2.5. Read the source and license or report an issue.
One-line installer
curl -fsSL https://iq-routing.com/install.sh | shirm https://iq-routing.com/install.ps1 | iexcurl -fsSL https://iq-routing.com/install.cmd -o install.cmd && .\install.cmd && del install.cmdVerify the download
Compare each script's SHA-256 with the value below before you run it.
install.shDownload install.sh
SHA-256 of install.sh
cf8ab9218b0ab3acb0202400b91f4fc785ff3b78701db7da24d7dcc1a3e2738cinstall.ps1Download install.ps1
SHA-256 of install.ps1
374289cdacdd97116db56e8825002cd17965fcd7566fbcd0cc8e65fa9f58d18ainstall.cmdDownload install.cmd
SHA-256 of install.cmd
0aeb68a6d8f7d4bb2083b774862b81f7ac7da39e48cde0e0905842949c110610
The installers run the marketplace commands below, then can ask for your IQ key with hidden input; press Enter to skip. To check a script first, open Verify the download. Restart Claude Code after installing, or run /reload-plugins in an open session.
Plugin marketplace
claude plugin marketplace add IQ-Routing/IQ-Code
claude plugin install iq-code@iq-routingRun both commands in your terminal, then restart Claude Code or run /reload-plugins.
Check the install
/iqYou should see Home, Routing, Cost, Plan and Settings. Run /iq-route status to check routing. The meter, cache clock, plan pace and themes work without an IQ key.
Optional: add your IQ key
IQ Code routing needs the Personal plan ($6/month, 2,000 routing decisions a month) or higher, and an IQ key. Team and Enterprise plans include routing decisions. The free display features work without an IQ account or key. Start free to create an account. Already have an account? Create your IQ key on the API Keys page. In Claude Code, run:
/plugin configure iq-code@iq-routing
/reload-pluginsEnter your key in the masked IQ API key field. Key changes apply after /reload-plugins or a restart. Claude Code stores the key in the macOS Keychain, falling back to ~/.claude/.credentials.json if the Keychain rejects the write. Linux and Windows use ~/.claude/.credentials.json (%USERPROFILE%\.claude\.credentials.json on Windows). Do not put the key in your project or source control.
Uninstalling the plugin from its last install scope removes the key Claude Code stores for it, so add the key again after you reinstall. --keep-data keeps the plugin's data folder; it does not keep the key.
Run /iq-route on to enable routing. It stays on in new sessions on this device until /iq-route off. Without a usable key, /iq-route on leaves routing off and tells you how to add one. The key authenticates IQ requests and is separate from your Anthropic credentials.
Read what routing sends before enabling it.
For account and billing questions, email support@iq-routing.com.