diff --git a/.env.example b/.env.example index b9aab986..d0596272 100644 --- a/.env.example +++ b/.env.example @@ -26,6 +26,17 @@ ANTHROPIC_API_KEY=your-api-key-here # OPENROUTER_API_KEY=sk-or-your-openrouter-key # ROUTER_DEFAULT=openrouter,google/gemini-3-flash-preview +# ============================================================================= +# OPTION 3: Custom Anthropic-Compatible Endpoint (no router) +# ============================================================================= +# Use any Anthropic-compatible API (Kimi K2.5, AWS Bedrock, etc.) directly +# without the router. Just set the base URL and your API key: +# +# ANTHROPIC_BASE_URL=https://your-custom-endpoint.com/v1 +# ANTHROPIC_API_KEY=your-api-key-for-custom-endpoint +# +# Then run normally: ./shannon start URL= REPO= + # ============================================================================= # Available Models # ============================================================================= diff --git a/CLAUDE.md b/CLAUDE.md index c73d3c96..529ed62b 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -268,6 +268,19 @@ The tool should only be used on systems you own or have explicit permission to t **Output:** - `audit-logs/{hostname}_{sessionId}/` - Session metrics, agent logs, deliverables +### Custom Anthropic-Compatible Endpoint + +Use any Anthropic API-compatible endpoint (Kimi K2.5, AWS Bedrock, etc.) without the router: + +```bash +# In .env: +ANTHROPIC_BASE_URL=https://api.example.com/v1 +ANTHROPIC_API_KEY=your-api-key + +# Run normally (no ROUTER=true needed): +./shannon start URL= REPO= +``` + ### Router Mode (Multi-Model Support) Shannon supports routing Claude Agent SDK requests through alternative LLM providers via [claude-code-router](https://github.com/musistudio/claude-code-router). diff --git a/README.md b/README.md index 1ec4552c..6b1bd2bc 100644 --- a/README.md +++ b/README.md @@ -258,6 +258,19 @@ rules: If your application uses two-factor authentication, simply add the TOTP secret to your config file. The AI will automatically generate the required codes during testing. +### Custom Anthropic-Compatible Endpoint + +Use any Anthropic API-compatible endpoint (Kimi K2.5, AWS Bedrock, etc.) without the router: + +```bash +# In .env: +ANTHROPIC_BASE_URL=https://api.example.com/v1 +ANTHROPIC_API_KEY=your-api-key + +# Run normally: +./shannon start URL=https://example.com REPO=/path/to/repo +``` + ### [EXPERIMENTAL - UNSUPPORTED] Router Mode (Alternative Providers) Shannon can experimentally route requests through alternative AI providers using claude-code-router. This mode is not officially supported and is intended primarily for: