Connect your API keys
Most of the toolkit needs no API keys at all. You only need them for the skills that generate images or video, because those call outside services to do the rendering.
The keys
Section titled “The keys”You bring your own keys, so usage is billed to your own accounts. Each key is read only from your computer’s environment, and if a skill needs a key you haven’t set, it stops and tells you rather than producing a broken or placeholder file.
| Tool | What it powers | Keys you need | Get them at |
|---|---|---|---|
| Gemini | Image generation | GEMINI_API_KEY | aistudio.google.com/apikey |
| Creatify | Video ads + batch image generation | CREATIFY_API_ID, CREATIFY_API_KEY | app.creatify.ai → Settings → API |
| GitHub (optional) | Hosting local reference images | GITHUB_TOKEN, GITHUB_OWNER, GITHUB_REPO | Only needed if you reference local image files. You can skip it by passing public image URLs instead. |
Adding them on the desktop app
Section titled “Adding them on the desktop app”The skills read these from your environment. Set them once and they stick. Pick your operating system:
On a Mac
Section titled “On a Mac”-
Open the Terminal app (it comes with your Mac: press ⌘-Space, type “Terminal”, press Enter).
-
Paste these lines, replacing the placeholder text with your real keys:
Terminal window echo 'export GEMINI_API_KEY="your-key-here"' >> ~/.zshrcecho 'export CREATIFY_API_ID="your-id-here"' >> ~/.zshrcecho 'export CREATIFY_API_KEY="your-key-here"' >> ~/.zshrc -
Quit and reopen the Claude Code desktop app so it picks up the new keys.
On Windows
Section titled “On Windows”-
Open PowerShell (press the Start button, type “PowerShell”, press Enter).
-
Paste these lines, replacing the placeholder text with your real keys:
Terminal window setx GEMINI_API_KEY "your-key-here"setx CREATIFY_API_ID "your-id-here"setx CREATIFY_API_KEY "your-key-here" -
Fully quit and reopen the Claude Code desktop app.
setxonly takes effect in apps opened after you run it, so the restart is required.
How you know it’s working
Section titled “How you know it’s working”Run an image skill (for example, meta-image-ad-generator). If your keys are set, it generates. If a key is missing, it stops with a plain message telling you exactly which key to add. It will never quietly ship a gray placeholder where an image should be.
Stuck? See Troubleshooting.