Skip to main content
ruoli is compatible with the API protocols of mainstream large models. As long as your tool lets you set a custom API URL and Key, it works — including tools not listed individually in these docs. You only need two things: Authentication is always: Authorization: Bearer sk-YOUR-KEY.

​
Two URL Formats (Important)

ruoli supports two access protocols, and the URL differs — using the wrong one will fail to connect:
Rule of thumb: if the tool asks for an OpenAI / OpenAI-compatible URL, use https://ruoli.dev/v1; if it asks for a native vendor URL (Anthropic, Gemini, etc.), use https://ruoli.dev (without /v1).These native SDKs build the path themselves, so an extra /v1 will break the request.

​
Universal Configuration Example

For most OpenAI-compatible tools, these three fields are all you need: Then enter the model name you want (e.g. claude-sonnet-4-20250514, gpt-4o) and you’re ready to go.

​
Verify the Connection

After configuring, run the command below to confirm you get a valid response (OpenAI-compatible format):
If you get back JSON containing a content text field, you’re connected. For common errors, see the FAQ.
Dedicated pages for popular tools: Claude Code · Codex · Cherry Studio.Need to manage connections for multiple CLI tools at once? Use the CC Switch setup helper.