Selected models are free to useView free models
Documentation / WorkBuddy

WorkBuddy Integration Guide

From your first API key to a custom model, connect WorkBuddy to LanoX step by step.

Already have an API Key? Configure now
00

The LanoX Platform

Open the LanoX console to create an account, add credit, and prepare your API key.

LanoX Consolelanox.ai
01

Create an API Key

Use your LanoX API key for this setup, not a key from the upstream model provider.

  1. 01

    Create Your Account

    Register with your email and password, verify your email, or sign in to an existing account.

    Create account
  2. 02

    Add Account Credit

    Add credit or redeem a code in the LanoX console.

    Open console
  3. 03

    Create an API Key

    Open API Keys, create a key, and keep it somewhere secure.

    Create API key

Treat your API key as a secret. Never publish it, commit it, or include it in screenshots.

02

Install WorkBuddy

Download the official client, install it, and sign in. Configure models directly in the app; CC Switch is not required.

WorkBuddy for macOS

Select the installer that matches your Mac processor.

Official download
  1. Download and open the desktop installer, then follow the installation prompts.
  2. Open WorkBuddy and sign in to your client account.
  3. Open Settings, then add a custom model under "Models" to connect LanoX.
Official installation guide

Signing in to WorkBuddy and authenticating with LanoX are separate steps. Third-party model requests are billed to your LanoX account.

03

WorkBuddy Configuration

Connect WorkBuddy using a custom API URL, your LanoX API key, and an exact model ID.

Connection Details

Client installedAPI key readyAccount funded
Provider
Custom
API URL
https://api.lanox.ai/v1/chat/completions
API Key
Paste your LanoX API key
Model name
YOUR_MODEL_ID
Tool calling
Enable for a model that supports tools
Custom protocol
Off; use the standard Chat Completions path

Used only to update the command example below; no request is sent. Use a model ID from LanoX, not its display name.

Use the full /v1/chat/completions URL. Keep "Custom protocol" off to use standard path handling. Configure capability options according to the model you select.

Setup Walkthrough

Custom API
Step 1 / 4

Open Model Settings

Open WorkBuddy Settings and select "Models". Find the add button in the custom model section.

Setup screenshot
Official screenshot: the model settings page. Choose "Add model" to begin.

Official model guide

04

Verify the Connection

Verify a short conversation, test tool calling, then review the request logs.

  1. Start a new session and send a short prompt. Confirm that you receive an actual reply.
  2. Test tool calling in a trusted test folder and review the client's permissions.
  3. Check the model, usage, and request logs in the LanoX console.
Optional: test the API directly

Set LANOX_API_KEY in your local environment first. These commands are for copying only; this page sends no requests. Running them can incur model usage charges.

Terminal
curl --fail-with-body 'https://api.lanox.ai/v1/chat/completions' \
  -H "Authorization: Bearer $LANOX_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "model": "YOUR_MODEL_ID",
  "messages": [
    {
      "role": "user",
      "content": "Reply with OK."
    }
  ],
  "stream": false
}'
05

Help & Support

Check these common issues first, then contact support if needed.

Settings Saved, but No Reply?

Check the key, balance, model ID, and protocol. A 401/403 often concerns authentication or permissions; inspect paths and model IDs for 404, and rate or quota limits for 429. The returned error message is authoritative.

Custom Model Disabled?

Complete the API URL and key, save, and select the model again. WorkBuddy disables incomplete custom models. Update the client if its visual model settings are unavailable.

Should the URL Include /chat/completions?

This guide uses the full URL https://api.lanox.ai/v1/chat/completions with standard protocol handling. Enable custom protocol only when your endpoint needs a nonstandard path sent exactly as entered.

Chat Works, but Tools Do Not?

Confirm that the model supports tools, the gateway supports its protocol, and the client has workspace and tool permissions. Text replies alone do not imply full agent support.

Restart or Install CC Switch?

CC Switch is not required. Save the model in WorkBuddy settings and select it in a new task.

Support Tickets

Need help with your account, requests, or setup? Submit a ticket to the LanoX support team.

Submit a ticket

Include your OS, client version, protocol, and error screenshot. Redact your API key.

Steps checked on November 4, 2026. Screenshots are unmodified official examples. Model availability and API access depend on your LanoX account.