Connect Agents & Harnesses

Anything that lets you set a custom API base URL can talk to kotoba.cloud. Copy-paste setup for popular finished tools.

Two rules that apply to every tool

1. Model names are always qwen3.8-flash-next-whitehacker (catalog: /v1/models)

2. Whether the base URL keeps /v1 depends on the protocol: OpenAI-compatible tools → https://api.kotoba.cloud/v1 (with /v1). Anthropic-protocol-compatible tools → https://api.kotoba.cloud (no /v1 — the tool appends the path itself).

# list every available model id
curl https://api.kotoba.cloud/v1/models \
  -H "Authorization: Bearer $KOTOBA_API_TOKEN"

Per-tool pages

• Claude Code Caveat

  Anthropic's terminal coding agent. Anthropic protocol (base URL without /v1).

  Open the setup
• Codex CLI Verified

  OpenAI's terminal coding agent. OpenAI-compatible.

  Open the setup
• Cline Should work

  VS Code extension. Set API Provider to "OpenAI Compatible" in settings.

  Open the setup
• Kilo Code Verified

  VS Code extension. Connect via its Custom provider.

  Open the setup
• OpenCode Caveat

  Open-source terminal agent. Configured via opencode.json.

  Open the setup
• Aider Should work

  Treats any OpenAI-compatible endpoint as its openai/ provider.

  Open the setup
• Hermes Agent Verified

  Nous Research's terminal agent (Linux/macOS/WSL2). Endpoint in config.yaml, key in .env.

  Open the setup
• Open WebUI Should work

  Self-hosted chat UI. Launch with the connection prefilled via environment variables.

  Open the setup
• Cursor Caveat

  Override the OpenAI base URL in settings (requires Cursor Pro).

  Open the setup
• Any OpenAI SDK Verified

  Any OpenAI SDK works with a one-line base-URL swap.

  Open the setup