Compatible Tools
Osiris works with any tool that supports the OpenAI or Anthropic API. Point it to https://ai.osiris-code.com with your sk-osiris- key.
Claude Code
Anthropic's AI coding CLI — agentic coding in your terminal
Option 1: Environment variables (simplest)
# Add to ~/.bashrc or ~/.zshrc
export ANTHROPIC_API_KEY="sk-osiris-YOUR_KEY"
export ANTHROPIC_BASE_URL="https://ai.osiris-code.com"
# Optional: disable telemetry
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1"
# Then run Claude Code
claudeOption 2: Settings file (persistent, no shell config needed)
// ~/.claude/settings.json
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "sk-osiris-YOUR_KEY",
"ANTHROPIC_BASE_URL": "https://ai.osiris-code.com",
"CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-5",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-6"
},
"model": "opus"
}The settings file maps Claude Code's model tiers (haiku/sonnet/opus) to Osiris models. Set "model": "opus" to use Opus by default, or "sonnet" / "haiku" for cheaper options. Add to your ~/.bashrc or ~/.zshrc if using env vars.
OpenCode
Open-source AI coding assistant with multi-provider support
Add Osiris as a custom provider in your config:
// ~/.opencode/opencode.json
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"osiris": {
"name": "Osiris",
"npm": "@ai-sdk/openai-compatible",
"options": {
"baseURL": "https://ai.osiris-code.com/v1",
"apiKey": "sk-osiris-YOUR_KEY"
},
"models": {
"claude-opus-4.6": {
"name": "Claude Opus 4.6",
"limit": { "context": 1000000, "output": 128000 }
},
"claude-sonnet-4.5": {
"name": "Claude Sonnet 4.5",
"limit": { "context": 200000, "output": 64000 }
},
"claude-haiku-4.5": {
"name": "Claude Haiku 4.5",
"limit": { "context": 200000, "output": 64000 }
},
"gpt-5.4": {
"name": "GPT-5.4",
"limit": { "context": 272000, "output": 64000 }
},
"gpt-5.3-codex": {
"name": "GPT-5.3 Codex",
"limit": { "context": 272000, "output": 64000 }
},
"gemini-3.1-pro": {
"name": "Gemini 3.1 Pro",
"limit": { "context": 1048576, "output": 65536 }
},
"kimi-k2.5": {
"name": "Kimi K2.5",
"limit": { "context": 131072, "output": 8192 }
},
"minimax-m2.5": {
"name": "MiniMax M2.5",
"limit": { "context": 1000000, "output": 16384 }
},
"qwen3-coder-next": {
"name": "Qwen3 Coder Next",
"limit": { "context": 131072, "output": 8192 }
}
}
}
}
}Uses @ai-sdk/openai-compatible package. Add any model from the Osiris model list.
OpenClaw
AI coding agent with multi-provider support
Add Osiris as a provider in your OpenClaw config:
// ~/.openclaw/openclaw.json
{
"models": {
"providers": {
"osiris": {
"baseUrl": "https://ai.osiris-code.com/v1",
"apiKey": "sk-osiris-YOUR_KEY",
"api": "openai-completions",
"models": [
{ "id": "claude-sonnet-4.5", "contextWindow": 200000, "maxTokens": 16384 },
{ "id": "claude-opus-4.6", "contextWindow": 1000000, "maxTokens": 32768 },
{ "id": "gpt-5.4", "contextWindow": 272000, "maxTokens": 16384 }
]
}
}
},
"agents": {
"defaults": {
"model": {
"primary": "osiris/claude-sonnet-4.5"
}
}
}
}Use model format osiris/model-name (e.g. osiris/claude-sonnet-4.5).
Hermes Agent
Nous Research's open-source AI agent framework
Use the setup wizard or configure manually:
# Install hermes-agent
npm install -g hermes-agent
# Run setup wizard and select "your own endpoint"
hermes setup
# Or set manually:
hermes config set provider custom
hermes config set baseURL https://ai.osiris-code.com/v1
hermes config set apiKey sk-osiris-YOUR_KEY
hermes config set model claude-sonnet-4.5
# Run
hermesZed Editor
High-performance code editor with built-in AI assistant
Open Zed settings (JSON) and add the Anthropic provider:
// Zed > Settings > Open Settings (JSON)
{
"language_models": {
"anthropic": {
"api_url": "https://ai.osiris-code.com",
"api_key": "sk-osiris-YOUR_KEY",
"available_models": [
{
"name": "claude-sonnet-4.5",
"display_name": "Claude Sonnet 4.5",
"max_tokens": 200000,
"max_output_tokens": 16384
},
{
"name": "claude-opus-4.6",
"display_name": "Claude Opus 4.6",
"max_tokens": 1000000,
"max_output_tokens": 32768
}
]
}
},
"assistant": {
"default_model": {
"provider": "anthropic",
"model": "claude-sonnet-4.5"
}
}
}After saving, select your model in the Zed AI panel.
REST API
Direct HTTP requests — curl, Python, Node.js, any language
curl — OpenAI format
curl https://ai.osiris-code.com/v1/chat/completions \
-H "Authorization: Bearer sk-osiris-YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-4.5",
"messages": [{"role": "user", "content": "Hello!"}]
}'curl — Anthropic format
curl https://ai.osiris-code.com/v1/messages \
-H "x-api-key: sk-osiris-YOUR_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-4.5",
"max_tokens": 1024,
"messages": [{"role": "user", "content": "Hello!"}]
}'Python — OpenAI SDK
from openai import OpenAI
client = OpenAI(
api_key="sk-osiris-YOUR_KEY",
base_url="https://ai.osiris-code.com/v1"
)
response = client.chat.completions.create(
model="claude-sonnet-4.5",
messages=[{"role": "user", "content": "Hello!"}]
)
print(response.choices[0].message.content)Python — Anthropic SDK
from anthropic import Anthropic
client = Anthropic(
api_key="sk-osiris-YOUR_KEY",
base_url="https://ai.osiris-code.com"
)
message = client.messages.create(
model="claude-sonnet-4.5",
max_tokens=1024,
messages=[{"role": "user", "content": "Hello!"}]
)
print(message.content[0].text)Node.js — OpenAI SDK
import OpenAI from "openai";
const client = new OpenAI({
apiKey: "sk-osiris-YOUR_KEY",
baseURL: "https://ai.osiris-code.com/v1",
});
const response = await client.chat.completions.create({
model: "claude-sonnet-4.5",
messages: [{ role: "user", content: "Hello!" }],
});
console.log(response.choices[0].message.content);Works with any OpenAI/Anthropic-compatible tool
Any tool that lets you set a custom base_url and api_key will work with Osiris. Just point it to https://ai.osiris-code.com (or https://ai.osiris-code.com/v1 for OpenAI SDK).