The Claude Cohort · Claude Code Desktop

Install Your WaveSpeed CLI

Okay now, this is the tool that lets Claude Code make real images and video for you, right from the terminal built into Claude Code Desktop. No dashboard, no uploading files by hand. Let's get it running, one command at a time.

If you already know your way around a terminal, here's the whole install in five lines. Everyone else, keep scrolling, we break down each one below.

  1. Open the terminal in Claude Code Desktop: Ctrl + `
  2. Confirm Node is installed: node -v
  3. Install the CLI: npm install -g @wavespeed/cli
  4. Log in and create your dedicated API key: wavespeed login
  5. Verify the connection: wavespeed status

You need AI media, not another browser tab

When you're building with Claude Code, stopping to open a website, log in, upload a file, and download the result breaks your whole rhythm. WaveSpeed is the AI model marketplace, images, video, audio, all of it. The CLI is what lets Claude Code talk to WaveSpeed directly, so you can just say "make me an image of X" and it happens without you ever leaving your terminal.

Real-world picture: think of the terminal as a walkie-talkie, not a filing cabinet. You don't click through folders in it. You say the word and the thing happens. That's it. That's the whole scary reputation, gone.

One install, works everywhere

We're installing this with npm, the app store for your terminal. It's already on your computer if you've set up Claude Code, because Claude Code runs on the same engine, Node.js. The -g in the install command means "global", so once it's in, the wavespeed command works no matter which project folder you're standing in.

Five steps, start to finish

Follow these in order, right inside Claude Code Desktop. Don't skip ahead, each step confirms the last one worked.

1

Open the terminal in Claude Code Desktop

Press Ctrl + ` (Ctrl and the backtick key, top left of your keyboard under Esc) to open the built-in terminal panel. Same shortcut on Mac and Windows, no Cmd needed. You can also click Views in the toolbar and choose Terminal.

This terminal is real and typed into directly, it's not the chat. If you'd rather not type it yourself, you can also just tell Claude in the chat "run npm install -g @wavespeed/cli" and approve it when it asks. Either way works, we'll show the typed-in version below.

2

Check you have Node installed

This is the engine npm runs on. If Claude Code already works on your machine, you have it. Let's just confirm.

node -v

See a version number like v22.13.0? You're good, skip to step 2. See "command not found" instead? Go to nodejs.org, download the LTS installer, run it, then come back here.

3

Install the CLI

This pulls WaveSpeed's command-line tool down and makes the wavespeed command work anywhere on your machine.

npm install -g @wavespeed/cli
4

Log in and create your own dedicated API key

Run this and it opens wavespeed.ai/accesskey in your browser.

wavespeed login

On that page, create a brand new key, this is your dedicated key, not one you borrow from a classmate or copy out of a group chat. Copy it, then paste it back into your terminal when the CLI asks. It saves quietly to your machine after that, you won't have to paste it again.

Real-world picture: an API key is like a name badge that lets WaveSpeed know it's really you making the request. Everyone in the cohort needs their own badge. Sharing one means you can't tell whose usage is whose, and if it ever needs to be shut off, it shuts off for everyone wearing it.
5

Verify it's connected

This is your proof. If it shows your API key and a status, you are ready to build.

wavespeed status

Prove it works

Don't just install it and move on. Run one real command right now so you know it's live.

wavespeed models "nano banana"

If a list of models shows up in your terminal, you're done. That's the whole install. Next time you're in Claude Code, just ask it to generate an image or video for you, it already knows how to reach for this tool.

If something doesn't work

Do this

  • Close and reopen your terminal after installing Node for the first time
  • Run wavespeed status any time you're not sure if you're logged in
  • Copy commands exactly, spelling and dashes matter

Avoid this

  • Don't paste an API key into a chat with anyone, ever
  • Don't add sudo (Mac) or run as Administrator (Windows) unless you know why
  • Don't skip step 1, "command not found" almost always means Node is missing

That's it. You're wired up.

You didn't just install some software. You gave Claude Code a new set of hands. Now go build something with it.