The Claw Bay Docs

macOSWindowsLinux

Copy

# 1) Install Node.js (if needed)
brew install node

# 2) Install CLI tools
npm i -g @openai/codex theclawbay

# 3) Run one-time setup
theclawbay setup

# 4) Start Codex
codex

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.THECLAWBAY_API_KEY,
  baseURL: "https://api.theclawbay.com/v1",
});

const models = await client.models.list();
const model = models.data[0]?.id ?? "gpt-5.5";

const response = await client.responses.create({
  model,
  input: "Write a short launch note for a new SaaS feature.",
  reasoning: { effort: "medium" },
});

console.log(response.output_text);

const image = await client.images.generate({
  model: "gpt-image-2",
  prompt: "A minimalist black sailboat on a white background.",
  size: "1024x1024",
  quality: "low",
});

console.log(image.data[0]?.b64_json);

const response = await client.responses.create({
  model: "gpt-5.5",
  input: "Generate a minimalist black sailboat on a white background.",
  tools: [
    {
      type: "image_generation",
      size: "1024x1024",
      quality: "low",
      background: "opaque",
    },
  ],
  tool_choice: { type: "image_generation" },
});

console.log(response.output);

const stream = await client.responses.create({
  model,
  input: "Stream a concise product update.",
  stream: true,
  reasoning: { effort: "low" },
});

for await (const event of stream) {
  if (event.type === "response.output_text.delta") {
    process.stdout.write(event.delta ?? "");
  }
}

const completion = await client.chat.completions.create({
  model,
  messages: [
    { role: "user", content: "What is the weather in Boston?" },
  ],
  tools: [
    {
      type: "function",
      function: {
        name: "get_current_weather",
        description: "Get the current weather for a city.",
        parameters: {
          type: "object",
          properties: {
            location: { type: "string" },
            unit: { type: "string", enum: ["c", "f"] },
          },
          required: ["location"],
        },
      },
    },
  ],
  tool_choice: "auto",
});

console.log(completion.choices[0]?.message?.tool_calls ?? []);

curl "https://theclawbay.com/api/codex-auth/v1/quota" \
  -H "Authorization: Bearer $THECLAWBAY_API_KEY"

curl "https://theclawbay.com/api/codex-auth/v1/quota?format=legacy_codex" \
  -H "Authorization: Bearer $THECLAWBAY_API_KEY"

HTTP/1.1 429 Too Many Requests
x-theclawbay-error-code: weekly_cost_limit_reached

{
  "error": "weekly cost limit reached for this account",
  "theclawbayError": {
    "category": "quota",
    "code": "weekly_cost_limit_reached",
    "retryable": false
  }
}