Umans Code User Guide

Quick Start (Recommended)

The fastest way to get started is with the Umans CLI. It handles authentication and launches Claude Code with zero configuration.

macOS & Linux

# Install the CLI (one-time)
curl -fsSL https://api.code.umans.ai/cli/install.sh | bash

# Launch Claude Code with Umans backend
umans claude

First run: The CLI opens your browser for authentication. Log in to your Umans account, and the CLI automatically receives your API key. Claude Code launches immediately with the Umans backend configured.

Subsequent runs: umans claude launches instantly using your saved credentials.

CLI Commands

umans claude                          # Launch Claude Code (default: umans-coder)
umans claude --model umans-minimax-m2.5   # Use MiniMax M2.5 with vision/websearch handoffs
umans opencode                       # Launch OpenCode with Umans backend
umans status                         # Check authentication status
umans logout                         # Remove saved credentials
umans --help                         # Show all available commands

Manual Configuration (Alternative)

If the CLI does not work for your setup (Windows users, custom environments) or you prefer to configure tools manually, use these settings:

API Endpoint

Getting Your API Key

1. Log in to app.umans.ai/billing
2. Go to your Dashboard → API Keys
3. Generate a new key (shown only once - copy it immediately)

Tool-Specific Setup

umans claude                    # Default: umans-coder (Kimi K2.5)
umans claude --model umans-minimax-m2.5   # MiniMax M2.5 with vision/websearch

export ANTHROPIC_BASE_URL=https://api.code.umans.ai
export ANTHROPIC_AUTH_TOKEN=sk-your-umans-api-key
claude --model umans-coder

umans opencode                          # Default: umans-coder
umans opencode --model umans-kimi-k2.5  # Use native Kimi K2.5

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "umans": {
      "npm": "@ai-sdk/anthropic",
      "name": "Umans coder",
      "options": {
        "baseURL": "https://api.code.umans.ai/v1",
        "apiKey": "sk-your-umans-api-key"
      },
      "models": {
        "umans-coder": {
          "name": "Umans coder"
        }
      }
    }
  }
}

{
  "$schema": "https://charm.land/crush.json",
  "providers": {
    "umans": {
      "type": "anthropic",
      "base_url": "https://api.code.umans.ai",
      "api_key": "sk-your-umans-api-key",
      "models": [
        {
          "id": "umans-coder",
          "name": "Umans Coder",
          "default_max_tokens": 50000,
          "can_reason": true
        }
      ]
    }
  }
}

API Reference

curl -N -X POST https://api.code.umans.ai/v1/messages \
  -H "Content-Type: application/json" \
  -H "x-api-key: sk-your-umans-api-key" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "umans-coder",
    "messages": [{"role": "user", "content": "Hello!"}],
    "max_tokens": 4096,
    "stream": true
  }'

curl -N -X POST https://api.code.umans.ai/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-your-umans-api-key" \
  -d '{
    "model": "umans-coder",
    "messages": [{"role": "user", "content": "Hello!"}],
    "stream": true
  }'

Models

Available Models

* Today, umans-coder routes to Kimi K2.5. This may change as we continuously evaluate models. Read more at blog.umans.ai.

How to Choose

• Use umans-coder (default) to let us choose the best model for you. We continuously evaluate and select what works best for most coding tasks. Today this is Kimi K2.5.
• Use umans-kimi-k2.5 when you specifically want native Kimi K2.5. Overall best experience. It leads benchmarks on vision-heavy workflows and document understanding tasks.
• Use umans-minimax-m2.5 when you specifically want MiniMax M2.5. Ideal for multi-language coding. It leads SWE-Bench Multilingual performance.

Benchmark Comparison

We believe in transparency. Select a benchmark below to see how our served models compare across different capabilities. Our models excel particularly in document understanding and multimodal tasks.

Model Information API

For programmatic access to current model information, including context windows, pricing, and capabilities:

curl https://api.code.umans.ai/v1/models/info | jq

This public endpoint returns up-to-date information about all available models, their capabilities, and current pricing.

Troubleshooting

FAQ

Support

Need help?