Claude Code Integration¶

Claude Code can use MoE Sovereign as an Anthropic backend. All requests from Claude Code are then routed through the MoE pipeline.

Basic Configuration (.bashrc)¶

# ~/.bashrc or ~/.zshrc
export ANTHROPIC_BASE_URL=https://api.moe-sovereign.org
export ANTHROPIC_API_KEY=<YOUR-API-KEY>

After setting the variables: source ~/.bashrc, then start claude.

Claude Code Profiles (CC Profiles)¶

CC profiles can be configured in the portal (portal.moe-sovereign.org) to control Claude Code behavior.

Profile Fields¶

Field	Description	Example value
`name`	Profile name	`dev-assistant`
`model`	Base model ID	`moe-orchestrator-agent-orchestrated`
`moe_mode`	MoE routing mode	`full` / `fast` / `code`
`expert_hints`	Preferred experts	`["code_reviewer", "technical_support"]`
`max_tokens`	Token limit per request	`4096`
`temperature`	Creativity (0.0–1.0)	`0.2`

moe_mode Options¶

Mode	Behavior	Recommended for
`full`	Full MoE fanout with all relevant experts	Complex architecture questions
`fast`	Complexity routing (trivial → 1 expert)	Interactive code completion
`code`	Code experts only (code_reviewer, technical_support)	Code-focused work
`research`	Experts + SearXNG research	Technology comparisons

Recommended Setup for Claude Code¶

# Optimal setup for code work
export ANTHROPIC_BASE_URL=https://api.moe-sovereign.org
export ANTHROPIC_API_KEY=<YOUR-API-KEY>

# Model for Claude Code (agent-orchestrated = full MoE fanout)
# Use this model in claude --model=... or in Claude Code Settings

Select the model within Claude Code:

/model moe-orchestrator-agent-orchestrated

CLAUDE.md Integration¶

Add to your project's CLAUDE.md which experts should be preferred:

# Project-specific AI instructions

Prefer:
- code_reviewer for all security reviews
- technical_support for Docker/Kubernetes questions
- math for performance calculations

Troubleshooting¶

"Invalid API Key"¶

# Check the key
curl https://api.moe-sovereign.org/v1/models \
  -H "Authorization: Bearer $ANTHROPIC_API_KEY"

Very slow responses¶

Use model moe-orchestrator-concise for faster responses
Or configure moe_mode: fast in the portal profile

Claude Code won't start / connection error¶

# Test connection
curl https://api.moe-sovereign.org/health

# Check variables
echo $ANTHROPIC_BASE_URL
echo ${ANTHROPIC_API_KEY:0:10}...

Model not found¶

# List available models
curl https://api.moe-sovereign.org/v1/models \
  -H "Authorization: Bearer $ANTHROPIC_API_KEY" | jq '.data[].id'