Subconscious

How to use Kodus with Subconscious

Let your AI do the setup. Paste this into Claude Code, Cursor, ChatGPT or any assistant.

Set up Kodus to use Subconscious as its model provider.

Subconscious is an inference API for agents. It serves open models through OpenAI- and Anthropic-compatible endpoints, billed per token.
- OpenAI-compatible base URL: https://api.subconscious.dev/v1
- Anthropic-compatible base URL: https://api.subconscious.dev
- Model: subconscious/glm-5.3-marathon
- API key: read it from the SUBCONSCIOUS_API_KEY environment variable. Never commit the key or paste it into project files. If it is not set, ask me to create one at https://platform.subconscious.dev.

Follow these steps. Run commands and edit files yourself. For any step in a settings screen, tell me exactly what to click and what to enter.

1. Create a Subconscious API key
Sign in at https://platform.subconscious.dev and create an API key. You will paste it into the settings screen below.

2. Open BYOK providers
Go to app.kodus.io/byok, or Settings, then BYOK on a self-hosted install, and open the Providers tab.

3. Connect Subconscious
Connect a custom OpenAI-compatible provider with these values, then click Test.
   - Base URL: https://api.subconscious.dev/v1
   - API key: Your Subconscious API key
   - Model ID: subconscious/glm-5.3-marathon

4. Route reviews to the model
In the Routing tab, assign the Subconscious model to review tasks. The Budget tab can cap spend.

Full guide: https://www.subconscious.dev/agents/platforms/kodus.md

When you are done, confirm the tool is using subconscious/glm-5.3-marathon, then summarize what you changed.

To use Kodus with Subconscious, open the BYOK page, connect a custom OpenAI-compatible provider with base URL https://api.subconscious.dev/v1, your API key and model subconscious/glm-5.3-marathon, test it, then assign the model to review tasks in the Routing tab. Kody then reviews pull requests on Subconscious.

Get an API keyRead the API docs

Last verified against the Kodus docs on

Before you start

  • A Kodus workspace (cloud or self-hosted)
  • A Subconscious account and API key

Kodus docs · Source on GitHub

Set up Kodus

  1. Step 1: Create a Subconscious API key

    Sign in at https://platform.subconscious.dev and create an API key. You will paste it into the settings screen below.

  2. Step 2: Open BYOK providers

    Go to app.kodus.io/byok, or Settings, then BYOK on a self-hosted install, and open the Providers tab.

  3. Step 3: Connect Subconscious

    Connect a custom OpenAI-compatible provider with these values, then click Test.

    Base URL
    https://api.subconscious.dev/v1
    API key
    Your Subconscious API key
    Model ID
    subconscious/glm-5.3-marathon

  4. Step 4: Route reviews to the model

    In the Routing tab, assign the Subconscious model to review tasks. The Budget tab can cap spend.

Why run Kodus on Subconscious

Lower cost on long tasks
50% to 80% lower cost on long tasks, because the runtime processes far fewer tokens. Cached input bills at a steep discount, and agentic coding sees cache hit rates above 95%.
One plan for the whole team
Token plans give a fixed monthly price for a daily token allowance, shared across models and across your team. Enterprise deployments run inside your own cloud.
Long sessions stay fast
2x faster task completion on long tasks than standard open-model inference, especially past 200k tokens of context.
Your data stays yours
Prompts, inputs and outputs are not recorded, and nothing you send is used to train a model.

Connection details

For any client that takes a custom OpenAI- or Anthropic-compatible endpoint.

OpenAI-compatible base URL
https://api.subconscious.dev/v1
Anthropic-compatible base URL
https://api.subconscious.dev
API key
From subc login or the Subconscious dashboard
Model
subconscious/glm-5.3-marathon
Multimodal, high-throughput model
subconscious/deepseek-v4.1-flash-marathon

Full reference in the Subconscious API docs.

Questions

Can Kodus use the Anthropic-compatible Subconscious API?
Yes. Choose an Anthropic-compatible custom provider with base URL https://api.subconscious.dev. Kodus normalizes paths with or without /v1.
Which Subconscious model should I use with Kodus?
Start with subconscious/glm-5.3-marathon, an open frontier coding model built for long agent runs. subconscious/deepseek-v4.1-flash-marathon is a cheaper, high-throughput alternative that also takes image input. Use the full model ID, including the subconscious/ prefix.
Is Kodus on Subconscious OpenAI- or Anthropic-compatible?
This guide connects Kodus through the OpenAI-compatible Subconscious API. Subconscious serves both formats: OpenAI Chat Completions at https://api.subconscious.dev/v1 and Anthropic Messages at https://api.subconscious.dev.
How is Kodus usage on Subconscious billed?
Per token by default, with no commitment. Heavy users can switch to a monthly token plan: a fixed price for a large daily token allowance shared across your team.

More agent platforms

See all