Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.clearmaas.com/llms.txt

Use this file to discover all available pages before exploring further.

TRAE IDE is an AI-powered code editor by ByteDance. It supports custom third-party model providers through its AI settings. Add ClearMaas to access 570+ models from a single configuration.

​
Prerequisites

  • TRAE IDE installed (trae.ai)
  • A ClearMaas API key starting with sk-

​
Setup via AI Settings

TRAE supports two protocol paths for custom providers:

​
OpenAI-compatible setup

  1. Open Settings �?AI (or Trae AI)
  2. Navigate to Models or Custom Providers
  3. Add a new provider:
FieldValue
ProviderOpenAI Compatible
API Keysk-...
Base URLhttps://api.clearmaas.com/v1

​
Anthropic-compatible setup

FieldValue
ProviderAnthropic Compatible
API Keysk-...
Base URLhttps://api.clearmaas.com
The Anthropic path uses the bare host URL �?TRAE’s SDK appends /v1/messages automatically.

​
Model naming format

When selecting models in TRAE, use ClearMaas’s provider/model format:
ProviderModel ID example
Anthropic modelsanthropic/claude-sonnet-4.6
OpenAI modelsopenai/gpt-4o-mini
Google modelsgoogle/gemini-2.5-pro
DeepSeek modelsdeepseek/deepseek-chat
Grok modelsgrok/grok-4-fast-reasoning
Qwen modelsqwen/qwen3.6-plus
Kimi modelskimi/kimi-k2.6

​
Selecting a model

After adding the provider:
  1. Open the AI chat or Builder panel
  2. Open the model selector
  3. Choose ClearMaas (or the provider name you configured)
  4. Pick any available model
To set a default, look for a Default Model or Preferred Model option in Settings > AI.

​
Project-level configuration

For team consistency, you can add model configuration to a project file (if TRAE supports project-scoped AI settings): 
// .trae/ai-settings.json (if supported)
{
  "provider": "openai-compatible",
  "api_key": "sk-...",
  "base_url": "https://api.clearmaas.com/v1",
  "default_model": "anthropic/claude-sonnet-4.6"
}

​
Environment variable fallback

If TRAE reads standard environment variables, you can set them before launching: 
export OPENAI_API_KEY="sk-..."
export OPENAI_BASE_URL="https://api.clearmaas.com/v1"
# or for Anthropic path:
export ANTHROPIC_API_KEY="sk-..."
export ANTHROPIC_BASE_URL="https://api.clearmaas.com"
trae .

​
Verification

  1. After adding ClearMaas as a provider, select a ClearMaas model
  2. Ask a question in the AI chat
  3. Check your ClearMaas dashboard to confirm the request was routed

​
See also