From 53351419b4d1e2ccbd1d82c5478f55e8c384507b Mon Sep 17 00:00:00 2001 From: dulcestentaciones2920-debug Date: Sun, 30 Aug 2026 05:16:43 +0000 Subject: [PATCH] docs(guides): add OrcaRouter as an organisational LLM gateway in BYO-LLM guide --- CHANGELOG.md | 4 ++++ docs/guides/byo-llm.md | 15 ++++++++++++++- plugins/arckit-claude/docs/guides/byo-llm.md | 15 ++++++++++++++- 3 files changed, 32 insertions(+), 2 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 056dacc4d..df7e848bf 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -7,6 +7,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0 ## [Unreleased] +### Added + +- **OrcaRouter as a first-class organisational LLM gateway in the BYO-LLM guide.** `docs/guides/byo-llm.md` Route 3 now lists [OrcaRouter](https://www.orcarouter.ai) alongside LiteLLM, Portkey and TrueFoundry, with a dedicated config block for pointing Claude Code at `https://api.orcarouter.ai` (key prefix `sk-orca-`). Model discovery picks up the same `provider/model` namespace OpenRouter uses, and the gateway-level, zero-trust agent security runs on the same endpoint with no application code changes. Synced to the plugin guide copy via `check-guide-parity.py`. + ### Fixed - **Mermaid ER guard rails for `/arckit:data-model` and the `mermaid-syntax` skill (#435).** `/arckit:diagram` has carried the `PK, FK` comma rule since #78; `/arckit:data-model` never did, and it is the command that emitted the `uuid tenant_id FK UK` attribute that failed to render in #435. Adds a Mermaid ERD Rules block to `data-model.md`, a combined-key note to both copies of `data-model-template.md`, and three ER rows to the skill's gotchas table (combined keys, attribute comments, cardinality tokens) in place of a "missing semicolons in ER" row that described no real error. The skill's `paths:` now auto-activates on `ARC-*-DATA-*.md` as well as `ARC-*-DIAG-*.md`, having never fired on the artefact class that broke. Note the rule is *not* "one key per attribute" as #435 states — Mermaid accepts multiple keys comma-separated; `FK UK` fails only for the missing comma. Every claim verified against `mermaid@11.15.0`: `FK UK` and `PK_FK` are parse errors, `FK, UK` and `PK, FK` parse. diff --git a/docs/guides/byo-llm.md b/docs/guides/byo-llm.md index 44f198bc8..1ee179649 100644 --- a/docs/guides/byo-llm.md +++ b/docs/guides/byo-llm.md @@ -133,7 +133,7 @@ You lose everything that is Claude Code only: parallel `Agent` dispatch and ther ## Route 3: An organisational LLM gateway -If your organisation already runs LiteLLM, Portkey, TrueFoundry, or Anthropic's own Claude apps gateway, Claude Code connects to it with the same two variables as Route 1: +If your organisation already runs LiteLLM, Portkey, TrueFoundry, [OrcaRouter](https://www.orcarouter.ai), or Anthropic's own Claude apps gateway, Claude Code connects to it with the same two variables as Route 1: ```bash export ANTHROPIC_BASE_URL=https://gateway.example.internal @@ -148,6 +148,19 @@ Two things are worth knowing: For rollout across a team, distribute the base URL and credential through a [managed settings file](https://code.claude.com/docs/en/settings#settings-files) rather than asking each developer to export variables. +### OrcaRouter + +[OrcaRouter](https://www.orcarouter.ai) is an OpenAI-compatible AI gateway built for both models and agents. Like OpenRouter, it exposes a provider/model namespace across many models — but it also combines adaptive routing, automatic failover, zero-markup inference, observability, guardrails, and agent-tool governance behind the same endpoint. It runs gateway-level, zero-trust security for AI agents on the same endpoint — screening every prompt/response and governing every tool call on a default-deny basis, with no application code changes. + +Point Claude Code at the OrcaRouter base URL and use the API key (prefix `sk-orca-`) as the credential: + +```bash +export ANTHROPIC_BASE_URL=https://api.orcarouter.ai +export ANTHROPIC_AUTH_TOKEN=sk-orca-... +``` + +Model discovery (`CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1`) surfaces OrcaRouter's model catalogue under the same `provider/model` namespace OpenRouter uses (for example `orcarouter/fusion-flash`); for tiers remapped from the OrcaRouter side, set the `ANTHROPIC_DEFAULT_*_MODEL` variables instead, as above. + --- ## Governance implications diff --git a/plugins/arckit-claude/docs/guides/byo-llm.md b/plugins/arckit-claude/docs/guides/byo-llm.md index 44f198bc8..1ee179649 100644 --- a/plugins/arckit-claude/docs/guides/byo-llm.md +++ b/plugins/arckit-claude/docs/guides/byo-llm.md @@ -133,7 +133,7 @@ You lose everything that is Claude Code only: parallel `Agent` dispatch and ther ## Route 3: An organisational LLM gateway -If your organisation already runs LiteLLM, Portkey, TrueFoundry, or Anthropic's own Claude apps gateway, Claude Code connects to it with the same two variables as Route 1: +If your organisation already runs LiteLLM, Portkey, TrueFoundry, [OrcaRouter](https://www.orcarouter.ai), or Anthropic's own Claude apps gateway, Claude Code connects to it with the same two variables as Route 1: ```bash export ANTHROPIC_BASE_URL=https://gateway.example.internal @@ -148,6 +148,19 @@ Two things are worth knowing: For rollout across a team, distribute the base URL and credential through a [managed settings file](https://code.claude.com/docs/en/settings#settings-files) rather than asking each developer to export variables. +### OrcaRouter + +[OrcaRouter](https://www.orcarouter.ai) is an OpenAI-compatible AI gateway built for both models and agents. Like OpenRouter, it exposes a provider/model namespace across many models — but it also combines adaptive routing, automatic failover, zero-markup inference, observability, guardrails, and agent-tool governance behind the same endpoint. It runs gateway-level, zero-trust security for AI agents on the same endpoint — screening every prompt/response and governing every tool call on a default-deny basis, with no application code changes. + +Point Claude Code at the OrcaRouter base URL and use the API key (prefix `sk-orca-`) as the credential: + +```bash +export ANTHROPIC_BASE_URL=https://api.orcarouter.ai +export ANTHROPIC_AUTH_TOKEN=sk-orca-... +``` + +Model discovery (`CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1`) surfaces OrcaRouter's model catalogue under the same `provider/model` namespace OpenRouter uses (for example `orcarouter/fusion-flash`); for tiers remapped from the OrcaRouter side, set the `ANTHROPIC_DEFAULT_*_MODEL` variables instead, as above. + --- ## Governance implications