# openclaude | Gitlawb | Knowledge Base | Instagit

runs anywhere. uses anything

GitHub Stars: 32k

Repository: https://github.com/Gitlawb/openclaude

---

## Articles

### [How OpenClaude Converts SSE Streams for Different AI Providers](/Gitlawb/openclaude/how-does-openclaude-convert-sse-streams-for-different-providers)

Discover how OpenClaude unifies SSE streams from OpenAI, Anthropic, and Gemini into a single Anthropic-compatible format. Learn more about its OpenAI shim layer.

- Tags: how-to-guide
- Published: 2026-09-08

### [How OpenClaude Manages Agent Colors in the UI: Theme-Driven Color Architecture](/Gitlawb/openclaude/how-does-openclaude-manage-agent-colors-in-ui)

Discover how OpenClaude manages agent colors using a theme-driven architecture. Learn how identifiers map to distinct UI colors via getAgentColor() for a visually organized interface.

- Tags: architecture
- Published: 2026-09-08

### [How OpenClaude Executes Sub-Agents in Separate Processes: Complete Fork Architecture Guide](/Gitlawb/openclaude/how-are-sub-agents-executed-in-separate-processes-in-openclaude)

Discover how OpenClaude executes sub-agents in separate processes using a complete fork architecture. Learn about Node.js child_process and inter-process communication.

- Tags: architecture
- Published: 2026-09-08

### [How to Spawn Sub-Agents Using AgentTool in OpenClaude](/Gitlawb/openclaude/how-to-spawn-sub-agents-using-agenttool-in-openclaude)

Learn how to spawn sub-agents using AgentTool in OpenClaude. Launch isolated agents for specialized tasks synchronously or in the background.

- Tags: how-to-guide
- Published: 2026-09-08

### [How to Change Permission Modes in OpenClaude at Runtime](/Gitlawb/openclaude/how-to-change-permission-modes-in-openclaude-at-runtime)

Learn how to change permission modes in OpenClaude at runtime. Easily update SDK settings or initialize with custom permission options for enhanced control and security.

- Tags: how-to-guide
- Published: 2026-09-08

### [How OpenClaude's Permission System Controls Tool Execution: A Deep Dive into the SDK Architecture](/Gitlawb/openclaude/how-does-openclaude-permission-system-control-tool-execution)

Explore OpenClaude's SDK architecture and its permission system. Learn how it controls tool execution with user-defined modes and secures approval for automatic clearance.

- Tags: deep-dive
- Published: 2026-09-08

### [How OpenClaude Handles Concurrent Tool Execution: Architecture and Safety Mechanisms](/Gitlawb/openclaude/how-does-openclaude-handle-tool-execution-concurrency)

Discover how OpenClaude handles concurrent tool execution with its three-layer architecture. Learn about parallelism bounding, result deduplication, and failure loop prevention for robust performance.

- Tags: architecture
- Published: 2026-09-08

### [How the OpenClaude OpenAI Shim Layer Normalizes API Calls for Multi-Provider Support](/Gitlawb/openclaude/how-does-openai-shim-layer-normalize-api-calls)

Discover how the OpenClaude OpenAI shim layer normalizes API calls via request planning, message conversion, and schema normalization for seamless multi-provider support. Ensure compatibility and simplify integrations.

- Tags: how-to-guide
- Published: 2026-09-08

### [How OpenClaude Handles Lazy Loading of Model Integrations](/Gitlawb/openclaude/how-does-openclaude-handle-lazy-loading-of-model-integrations)

Discover how OpenClaude implements lazy loading for model integrations using lazySchema and a caching factory pattern. Learn to reduce startup time and memory usage.

- Tags: internals
- Published: 2026-09-08

### [How Are Tools Assembled in OpenClaude: The Tool Pool Architecture](/Gitlawb/openclaude/how-are-tools-assembled-in-openclaude)

Discover how OpenClaude assembles toolsets via a six-stage pipeline, aggregating built-in, MCP, and discovered tools, then filtering and deduplicating them for API requests.

- Tags: architecture
- Published: 2026-09-08

### [How OpenClaude's Feature Flag System Works: A Deep Dive Into Local Flag Resolution](/Gitlawb/openclaude/how-does-openclaude-feature-flag-system-work)

Discover how OpenClaude's feature flag system works. Learn about local flag resolution using JSON files, environment variables, and default overrides for efficient development.

- Tags: deep-dive
- Published: 2026-09-08

### [OpenClaude Build Requirements: Node.js Version, Bun, and TypeScript Setup](/Gitlawb/openclaude/what-are-the-build-requirements-for-openclaude)

Build OpenClaude easily by understanding its requirements. Learn about the Node.js version, Bun setup, and TypeScript configuration needed for successful compilation.

- Tags: getting-started
- Published: 2026-09-08

### [How to Use Slash Commands with OpenClaude: Complete Guide with Examples](/Gitlawb/openclaude/how-to-use-slash-commands-with-openclaude)

Master OpenClaude slash commands to streamline your workflow. Learn how to trigger built-in functions like Git operations directly from the chat UI with this complete guide and examples.

- Tags: how-to-guide
- Published: 2026-09-08

### [Headless gRPC Server in OpenClaude: Architecture, Purpose, and Integration Guide](/Gitlawb/openclaude/what-is-the-purpose-of-the-headless-grpc-server-in-openclaude)

Discover the purpose of the headless gRPC server in OpenClaude. This guide explains how it makes the agent a network-accessible service with bidirectional streaming.

- Tags: architecture
- Published: 2026-09-08

### [How to Enable Streaming Output in OpenClaude: A Complete Guide](/Gitlawb/openclaude/how-to-enable-streaming-output-in-openclaude)

Learn how to enable streaming output in OpenClaude. Follow this guide to set up headless mode, output formats, and verbose flags for seamless results.

- Tags: how-to-guide
- Published: 2026-09-08

### [Key Benefits of Using OpenClaude's CLI: A Unified AI Coding Assistant](/Gitlawb/openclaude/what-are-the-benefits-of-using-openclaude-cli)

Unlock the benefits of OpenClaude's CLI for unified AI coding. Access multi-provider AI, manage workflows, and handle sessions seamlessly without switching tools.

- Tags: best-practices
- Published: 2026-09-08

### [How to Configure Anthropic Models with OpenClaude: A Complete Guide](/Gitlawb/openclaude/how-to-configure-anthropic-models-with-openclaude)

Easily configure Anthropic models with OpenClaude. Follow our guide to set your API key and model parameters for seamless integration. Get started now.

- Tags: how-to-guide
- Published: 2026-09-08

### [How OpenClaude Handles OpenAI-Compatible APIs: A Deep Dive into Provider Profiles and Request Routing](/Gitlawb/openclaude/how-does-openclaude-handle-openai-compatible-apis)

Discover how OpenClaude manages OpenAI-compatible APIs using provider profiles. Learn about seamless integration with services like OpenRouter, Groq, and custom endpoints.

- Tags: deep-dive
- Published: 2026-09-08

### [Supported LLM Providers in OpenClaude: Complete Provider List and Configuration Guide](/Gitlawb/openclaude/what-are-the-supported-llm-providers-for-openclaude)

Explore OpenClaude's supported LLM providers including Anthropic, Bedrock, Vertex AI, OpenAI, and more. Get the complete list and easy configuration guide for Gitlawb/openclaude.

- Tags: api-reference
- Published: 2026-09-08

### [How to Set Up OpenClaude with Different LLM Providers: The Complete Configuration Guide](/Gitlawb/openclaude/how-to-set-up-openclaude-with-different-llm-providers)

Master OpenClaude setup with our guide. Learn to configure different LLM providers using IDs, environment variables, and interactive commands for seamless integration.

- Tags: how-to-guide
- Published: 2026-09-08

### [How to Set Up Ollama with OpenClaude Using OpenAI Compatibility: Complete Local LLM Guide](/Gitlawb/openclaude/how-to-quickly-set-up-ollama-with-openclaude-using-openai-compatibility)

Quickly set up Ollama with OpenClaude for local LLM deployment. Enjoy OpenAI compatibility without API keys or cloud credentials. Get your local LLM running fast.

- Tags: how-to-guide
- Published: 2026-09-06

### [How to Verify Ollama Context Length with OpenClaude](/Gitlawb/openclaude/how-to-verify-ollama-context-length-with-openclaude)

Discover how to verify Ollama context length using OpenClaude. Learn how OpenClaude automatically checks for a 32768 token context window and warns you if it's insufficient.

- Tags: how-to-guide
- Published: 2026-09-06

### [How to Set the Context Length for Ollama with OpenClaude](/Gitlawb/openclaude/how-to-set-the-context-length-for-ollama-with-openclaude)

Learn how to set the context length for Ollama with OpenClaude by configuring environment variables or Ollama yaml. Meet OpenClaude's token requirements easily.

- Tags: how-to-guide
- Published: 2026-09-06

### [How to Toggle Smart Routing in OpenClaude: A Complete Guide to the /smartroute Command](/Gitlawb/openclaude/how-to-toggle-smart-routing-in-openclaude)

Toggle smart routing in OpenClaude effortlessly with the /smartroute command. Learn to enable disable or set model keys for optimal AI routing in this complete guide.

- Tags: how-to-guide
- Published: 2026-09-06

### [How to Configure Smart Routing in OpenClaude: A Complete Guide](/Gitlawb/openclaude/how-to-configure-smart-routing-in-openclaude)

Configure smart routing in OpenClaude by enabling it in your settings and defining models for efficient input handling. Optimize your AI for speed and accuracy.

- Tags: how-to-guide
- Published: 2026-09-06

### [How OpenClaude Smart Auto-Routing Optimizes API Costs](/Gitlawb/openclaude/how-does-openclaude-smart-auto-routing-work-for-cost-optimization)

Discover how OpenClaude Smart Auto-Routing cuts API costs by sending simple requests to low-cost models and complex ones to powerful ones, maintaining quality while saving you money.

- Tags: deep-dive
- Published: 2026-09-06

### [What Is Permissive Mode in OpenClaude Safety Settings?](/Gitlawb/openclaude/what-is-permissive-mode-in-openclaude-safety-settings)

Discover OpenClaude's permissive mode. It optimizes automated workflows by relaxing safety checks and reducing false positives while keeping essential file system security.

- Tags: deep-dive
- Published: 2026-09-06

### [How to Configure OpenClaude Safety Strictness: Environment Variables and Code Implementation](/Gitlawb/openclaude/how-to-configure-openclaude-safety-strictness)

Learn how to configure OpenClaude safety strictness using environment variables like OPENCLAUDE_SAFETY_LEVEL for permissive balanced or strict settings. Control safety heuristics easily.

- Tags: how-to-guide
- Published: 2026-09-06

### [OpenClaude Safety Strictness Levels: A Complete Guide to Strict, Balanced, and Permissive Modes](/Gitlawb/openclaude/what-are-the-openclaude-safety-strictness-levels)

Explore OpenClaude safety strictness levels: strict, balanced, and permissive. Understand how these modes control content filtering via the OPENCLAUDE_SAFETY_LEVEL environment variable.

- Tags: deep-dive
- Published: 2026-09-06

### [What Programming Languages Does OpenClaude Repo-Map Support?](/Gitlawb/openclaude/what-programming-languages-does-openclaude-repo-map-support)

Discover which programming languages OpenClaude repo-map supports including TypeScript, JavaScript, TSX, and Python. Learn how the repo-map feature works.

- Tags: getting-started
- Published: 2026-09-06

### [How to Boost Specific Paths in OpenClaude Repo Map: Complete Guide with Examples](/Gitlawb/openclaude/how-to-boost-specific-paths-in-openclaude-repo-map)

Boost specific paths in OpenClaude repo map using focus_files or focus_symbols parameters. This guide provides examples to enhance your repository analysis with OpenClaude.

- Tags: how-to-guide
- Published: 2026-09-06

### [How to Increase the Token Budget for OpenClaude Repo Map: 3 Configuration Methods](/Gitlawb/openclaude/how-to-increase-the-token-budget-for-openclaude-repo-map)

Boost your OpenClaude repo map token budget with 3 simple configuration methods. Learn to use CLI flags, environment variables, or config files for expanded capacity.

- Tags: how-to-guide
- Published: 2026-09-06

### [How to Enable Auto-Injection of the Repo Map in OpenClaude: 3 Configuration Methods](/Gitlawb/openclaude/how-to-enable-auto-injection-of-the-repo-map-in-openclaude)

Learn 3 easy ways to enable auto-injection of the repo map in OpenClaude. Configure via JSON, CLI flag, or environment variable for seamless integration.

- Tags: how-to-guide
- Published: 2026-09-06

### [Where Is the OpenClaude Repo Map Cache Stored?](/Gitlawb/openclaude/where-is-the-openclaude-repo-map-cache-stored)

Discover where the OpenClaude repo map cache is stored. Find the exact path in the Gitlawb/openclaude repository to manage your cache effectively.

- Tags: internals
- Published: 2026-09-06

### [How OpenClaude Builds a Repo Map for Codebase Awareness](/Gitlawb/openclaude/how-does-openclaude-build-the-repo-map-for-codebase-awareness)

Discover how OpenClaude builds a repo map for codebase awareness. Learn about its seven-stage pipeline, from parsing with Tree-sitter to rendering a summary of key definitions.

- Tags: architecture
- Published: 2026-09-06

### [Understanding the OpenClaude Repo Map: Architecture and Navigation](/Gitlawb/openclaude/what-is-the-openclaude-repo-map-and-how-does-it-work)

Explore the OpenClaude repo map, a directory blueprint in AGENTS.md, organizing commands components services and utilities for streamlined CLI development and maintenance.

- Tags: architecture
- Published: 2026-09-06

### [How to Kill an OpenClaude Background Session: CLI and Manual Methods](/Gitlawb/openclaude/how-to-kill-an-openclaude-background-session)

Learn how to kill an OpenClaude background session using the CLI command claude kill or the tmux fallback method. Safely manage your sessions.

- Tags: how-to-guide
- Published: 2026-09-06

### [How to List Background Sessions in OpenClaude: Using the Built-in `ps` Command](/Gitlawb/openclaude/how-to-list-background-sessions-in-openclaude)

Easily list background OpenClaude sessions using the claude ps command. View IDs, types, start times, and statuses. Filter by status and details for efficient session management.

- Tags: how-to-guide
- Published: 2026-09-06

### [How to Run Long Non‑Interactive Prompts in OpenClaude: Headless and Background Modes](/Gitlawb/openclaude/how-to-run-long-non-interactive-prompts-in-openclaude)

Learn to run long non-interactive prompts in OpenClaude using headless and background modes. Execute lengthy commands without keeping your terminal open.

- Tags: how-to-guide
- Published: 2026-09-06

### [How to Switch Between OpenClaude Provider Profiles: 3 Methods Explained](/Gitlawb/openclaude/how-to-switch-between-openclaude-provider-profiles)

Learn how to switch OpenClaude provider profiles easily. Discover 3 methods to manage API credentials and endpoint configurations for your sessions. Get started now.

- Tags: how-to-guide
- Published: 2026-09-06

### [Where Are OpenClaude Provider Profiles Stored? A Complete Guide to Configuration Persistence](/Gitlawb/openclaude/where-are-openclaude-provider-profiles-stored)

Discover where OpenClaude provider profiles are stored. Learn about configuration persistence in this complete guide to the .openclaude-profile.json file and its directory.

- Tags: how-to-guide
- Published: 2026-09-06

### [How to Configure Agent Routing in OpenClaude: A Complete Guide to Model Selection](/Gitlawb/openclaude/how-to-configure-agent-routing-in-openclaude)

Master agent routing in OpenClaude. Learn to define routes and map agents in settings.json for efficient model selection and enhanced AI workflows.

- Tags: how-to-guide
- Published: 2026-09-06

### [How to Configure Microsoft Foundry / Azure OpenAI with the OpenClaude VS Code Extension](/Gitlawb/openclaude/configure-azure-openai-openclaude-vscode-extension)

Configure Azure OpenAI with OpenClaude VS Code extension effortlessly. This guide details using the wizard to store endpoints and secrets securely for seamless terminal integration.

- Tags: how-to-guide
- Published: 2026-09-05

### [What Features Does the VS Code Extension for OpenClaude Offer? A Complete Technical Guide](/Gitlawb/openclaude/features-vscode-extension-openclaude)

Explore the VS Code extension for OpenClaude and unlock AI-assisted coding. Discover features like chat, inline generation, multi-model support, and LSP diagnostics. Enhance your development workflow.

- Tags: how-to-guide
- Published: 2026-09-05

### [How to Integrate OpenClaude into CI/CD Pipelines Using Its gRPC Service](/Gitlawb/openclaude/integrate-openclaude-cicd-grpc-service)

Integrate OpenClaude into CI/CD pipelines using its gRPC service. Automate prompt execution, stream results, and manage conversational state for seamless workflows.

- Tags: how-to-guide
- Published: 2026-09-05

### [Where to Find the gRPC Proto Definition for OpenClaude: Complete File Guide](/Gitlawb/openclaude/grpc-proto-definition-location-openclaude)

Locate the OpenClaude gRPC proto definition at src/proto/openclaude.proto. Discover the AgentService interface and Chat RPC for real-time agent communication.

- Tags: api-reference
- Published: 2026-09-05

### [How to Run OpenClaude as a Headless gRPC Service: Complete Implementation Guide](/Gitlawb/openclaude/how-to-run-openclaude-headless-grpc-service)

Learn to run OpenClaude as a headless gRPC service with this implementation guide. Expose AgentService for bidirectional streaming of messages, tool executions, and permission prompts.

- Tags: how-to-guide
- Published: 2026-09-05

### [How to Attach to a Background Session in OpenClaude](/Gitlawb/openclaude/how-to-attach-to-background-session-openclaude)

Easily attach to a background OpenClaude session using tmux attach-session or the openclaude attach CLI. Reconnect to your interactive work seamlessly.

- Tags: how-to-guide
- Published: 2026-09-05

### [Where Are Background Session Logs Stored in OpenClaude? Storage Paths and Access Methods](/Gitlawb/openclaude/background-session-logs-storage-access-openclaude)

Discover where OpenClaude background session logs are stored locally and in the cloud. Learn to access logs via file reads, CLI commands, or the VS Code interface.

- Tags: how-to-guide
- Published: 2026-09-05

### [How Background Sessions Work in OpenClaude for Long Prompts](/Gitlawb/openclaude/how-background-sessions-work-openclaude-long-prompts)

Discover how OpenClaude efficiently handles long prompts using background sessions and detached child processes. Learn about bgRouting bgRegistry and sdkEventQueue for a responsive REPL.

- Tags: internals
- Published: 2026-09-05

### [How to Manage Step Limits for Agents in OpenClaude: A Complete Guide](/Gitlawb/openclaude/manage-step-limits-agents-openclaude)

Learn how to manage agent step limits in OpenClaude. Configure maxSteps to enforce limits and generate summaries automatically for efficient agent control.

- Tags: how-to-guide
- Published: 2026-09-05

### [Built-in Agents in OpenClaude: Complete Guide to Types and Requirements](/Gitlawb/openclaude/built-in-agents-requirements-openclaude)

Explore OpenClaude's nine built-in agents including helper, filesystem, and code-reviewer. Understand their requirements, tools, and model preferences in this comprehensive guide.

- Tags: tutorial
- Published: 2026-09-05

### [How to Configure Agent Routing and Model Overrides in OpenClaude](/Gitlawb/openclaude/configure-agent-routing-model-overrides-openclaude)

Master agent routing and model overrides in OpenClaude. Learn to use settings.json and environment variables for static or dynamic agent selection and customization.

- Tags: how-to-guide
- Published: 2026-09-05

### [How to Use OpenClaude's CLI Fast-Path Optimizations for Version Checks and Background Commands](/Gitlawb/openclaude/openclaude-cli-fast-path-optimizations-version-check-background)

Learn how to use OpenClaude's CLI fast-path optimizations to speed up version checks and background commands. Bypass initialization for faster execution and reduced latency.

- Tags: how-to-guide
- Published: 2026-09-05

### [How Gateway Routing Works in OpenClaude Based on transportConfig.kind](/Gitlawb/openclaude/gateway-routing-transportconfig-kind-openclaude)

Understand how OpenClaude gateway routing works by inspecting transportConfig.kind. Direct traffic to OpenAI-compatible gateways or local providers with this guide.

- Tags: internals
- Published: 2026-09-05

### [What Is the Purpose of the Registry and Runtime Metadata in OpenClaude Integrations?](/Gitlawb/openclaude/purpose-registry-runtime-metadata-openclaude-integrations)

Discover how OpenClaude integrations use registry and runtime metadata. Learn about static blueprints and dynamic capabilities for configuration validation and adaptive behavior.

- Tags: deep-dive
- Published: 2026-09-05

### [How to Define Custom Provider Descriptors for OpenClaude](/Gitlawb/openclaude/how-to-define-custom-provider-descriptors-openclaude)

Define custom provider descriptors for OpenClaude by exporting environment variables like PROVIDER_BASE_URL and PROVIDER_API_KEY. Integrate your unique services seamlessly.

- Tags: how-to-guide
- Published: 2026-09-05

### [How OpenClaude Implements Feature-Gated and Conditional Tools](/Gitlawb/openclaude/openclaude-feature-gated-conditional-tools)

Discover how OpenClaude uses compile-time flags, environment variables, and whitelists to implement feature-gated and conditional tools. Learn about its three-layer strategy.

- Tags: internals
- Published: 2026-09-05

### [OpenClaude Built-in Tools: Complete Reference for 2024](/Gitlawb/openclaude/available-built-in-tools-openclaude)

Explore OpenClaude's 40+ built-in tools for web search, file operations, code analysis, and more. Discover how LLMs leverage this comprehensive toolset for advanced tasks.

- Tags: api-reference
- Published: 2026-09-05

### [How Tools Are Registered and Loaded in OpenClaude: A Complete Developer Guide](/Gitlawb/openclaude/how-tools-are-registered-loaded-openclaude)

Discover how OpenClaude dynamically registers and loads tools from src/tools/ at startup. Learn about the ToolRegistry and result association for developers.

- Tags: developer-guide
- Published: 2026-09-05

### [QueryEngine in OpenClaude: The Core of the Agent Loop Explained](/Gitlawb/openclaude/role-of-queryengine-in-openclaude-agent-loop)

Discover how the QueryEngine orchestrates OpenClaude's agent loop, handling user input to structured output for seamless conversations. Learn its core role in the Gitlawb/openclaude repository.

- Tags: internals
- Published: 2026-09-05

### [OpenClaude CLI Entrypoint and Fast-Path Optimization Explained](/Gitlawb/openclaude/cli-entrypoint-fast-path-optimization-openclaude)

Discover the OpenClaude CLI entrypoint at src/entrypoints/cli.tsx and learn how it optimizes for speed by parsing arguments instantly, bypassing full initialization for quick commands.

- Tags: deep-dive
- Published: 2026-09-05

### [How to Use OpenClaude's React/Ink Terminal UI: A Developer's Guide](/Gitlawb/openclaude/how-to-use-openclaude-react-ink-terminal-ui)

Learn to build terminal UIs with React Ink and OpenClaude. Use React components to create interactive command-line experiences with ANSI-styled text. Get started today.

- Tags: how-to-guide
- Published: 2026-09-05

### [What Is the Descriptor-First Provider System in OpenClaude?](/Gitlawb/openclaude/what-is-descriptor-first-provider-system-openclaude)

Explore OpenClaude's descriptor-first provider system. Add new AI vendors easily by replacing hard-coded logic with declarative metadata, avoiding code modifications.

- Tags: deep-dive
- Published: 2026-09-05

### [How to Configure OpenClaude for OpenAI, Anthropic, or Gemini: Complete Provider Setup Guide](/Gitlawb/openclaude/how-to-configure-openclaude-for-model-providers)

Learn how to configure OpenClaude for OpenAI, Anthropic, or Gemini. This guide covers complete provider setup using profiles for seamless AI model switching.

- Tags: how-to-guide
- Published: 2026-09-05

### [How OpenClaude Handles Out‑of‑Process Teammate Routing During Startup](/Gitlawb/openclaude/openclaude-teammate-routing-startup)

Discover how OpenClaude manages out-of-process teammate routing at startup. Learn about its efficient flag parsing and environment variable detection for early provider setup.

- Tags: internals
- Published: 2026-09-02

### [How the `--provider` Flag Affects OpenClaude's Startup: A Deep Dive into CLI Initialization](/Gitlawb/openclaude/openclaude-provider-flag-startup-effect)

Discover how the --provider flag impacts OpenClaude startup by setting environment variables, defaults, and AI service precedence. Optimize your CLI initialization.

- Tags: deep-dive
- Published: 2026-09-02

### [How OpenClaude Loads Provider Environment Files at Startup](/Gitlawb/openclaude/openclaude-provider-env-file-loading)

Learn how OpenClaude loads provider environment files at startup. Discover the process of reading .env files, sanitizing variables, and caching configurations for your CLI session.

- Tags: internals
- Published: 2026-09-02

### [OpenClaude CLI Startup Sequence: From Shell Command to Interactive REPL](/Gitlawb/openclaude/openclaude-cli-startup-sequence)

Discover the OpenClaude CLI startup sequence from shell command to interactive REPL. Explore the initialization flow via bin openclaude, src commands ts, and src main ts.

- Tags: internals
- Published: 2026-09-02

### [How OpenClaude Manages Conversation Recovery Across Different Transports](/Gitlawb/openclaude/openclaude-conversation-recovery-handling)

Discover how OpenClaude handles conversation recovery across various transports by saving and replaying messages through JSON file persistence, ensuring seamless continuity.

- Tags: internals
- Published: 2026-09-02

### [DeepSeek and Moonshot Request Shaping Requirements in OpenClaude](/Gitlawb/openclaude/openclaude-deepseek-moonshot-shaping)

Learn OpenClaude's specific request shaping requirements for DeepSeek and Moonshot including URL overrides, model defaults, and token cap enforcement.

- Tags: deep-dive
- Published: 2026-09-02

### [How OpenClaude Handles Gemini Credential Handling and Thought‑Signature Behavior](/Gitlawb/openclaude/openclaude-gemini-credential-handling)

Discover how OpenClaude manages Gemini credential handling and preserves thought-signature behavior through its innovative auth-resolution layer and tool-use ID encoding.

- Tags: deep-dive
- Published: 2026-09-02

### [How to Configure Azure OpenAI with OpenClaude Using `OPENAI_AZURE_STYLE=1`](/Gitlawb/openclaude/configure-azure-openai-openclaude)

Learn to configure Azure OpenAI with OpenClaude using OPENAI_AZURE_STYLE=1. Set OPENAI_BASE_URL, OPENAI_DEPLOYMENT_ID, and AZURE_OPENAI_API_KEY for seamless Azure OpenAI integration.

- Tags: how-to-guide
- Published: 2026-09-02

### [Configuring Mistral for OpenClaude: Required Environment Variables and Setup](/Gitlawb/openclaude/openclaude-mistral-configuration)

Configure Mistral with OpenClaude by setting environment variables CLAUDE_CODE_USE_MISTRAL and MISTRAL_API_KEY. Learn optional overrides for MISTRAL_MODEL and MISTRAL_BASE_URL for seamless integration.

- Tags: how-to-guide
- Published: 2026-09-02

### [How OpenClaude Handles the GitHub Dual-Mode Provider Exception](/Gitlawb/openclaude/openclaude-github-dual-mode-route-handling)

Discover how OpenClaude manages the GitHub dual-mode provider exception by intelligently detecting environment variables and selecting the correct API endpoint for seamless integration.

- Tags: internals
- Published: 2026-09-02

### [How OpenClaude Resolves Provider Profiles with Descriptor Routes](/Gitlawb/openclaude/openclaude-provider-profile-descriptor-route-resolution)

Discover how OpenClaude resolves provider profiles using descriptor routes. Learn about mapping route IDs to compiled RouteDescriptors for runtime behavior.

- Tags: internals
- Published: 2026-09-02

### [How OpenClaude Handles Legacy Provider Names: 6 Compatibility Layers Explained](/Gitlawb/openclaude/openclaude-compatibility-layers-legacy-providers)

Discover the 6 compatibility layers in OpenClaude that translate legacy provider names into modern IDs. Learn how OpenClaude ensures seamless integration with older systems.

- Tags: deep-dive
- Published: 2026-09-02

### [How OpenClaude Handles Different Transport Kinds: WebSocket, SSE, Hybrid, and Local](/Gitlawb/openclaude/openclaude-transport-kind-handling)

Explore how OpenClaude manages diverse transport kinds like WebSocket, SSE, hybrid, and local. Discover the unified Transport interface simplifying model-server communication.

- Tags: how-to-guide
- Published: 2026-09-02

### [What Is the Authoritative Routing Contract for Gateway Descriptors in OpenClaude?](/Gitlawb/openclaude/openclaude-gateway-descriptor-routing-contract)

Understand the authoritative routing contract for gateway descriptors in OpenClaude. Discover the GatewayDescriptor interface and its essential routes array for mapping endpoints to handlers.

- Tags: api-reference
- Published: 2026-09-02

### [How to Author a New Gateway Descriptor for OpenClaude: A Complete Implementation Guide](/Gitlawb/openclaude/how-to-author-gateway-descriptor-openclaude)

Learn to author a new gateway descriptor for OpenClaude with this complete implementation guide. Create a TypeScript file, define configuration with defineGateway(), and register it.

- Tags: how-to-guide
- Published: 2026-09-02

### [How OpenClaude Derives Runtime Metadata for LLM Requests: Environment-to-Request Pipeline](/Gitlawb/openclaude/openclaude-runtime-metadata-derivation)

Discover how OpenClaude derives runtime metadata for LLM requests. Learn about the four-step pipeline that aggregates environment variables, routing, catalog entries, and provider settings.

- Tags: internals
- Published: 2026-09-02

### [Understanding Route Metadata in OpenClaude: The Central Configuration System](/Gitlawb/openclaude/openclaude-route-metadata-role)

Discover how OpenClaude route metadata centralizes AI provider configuration, enabling dynamic endpoint, auth, and model handling without hard-coding logic. Learn more today.

- Tags: deep-dive
- Published: 2026-09-02

### [Where Are OpenClaude Provider Integrations Defined? The Complete Technical Guide](/Gitlawb/openclaude/openclaude-provider-integrations-location)

Discover where OpenClaude provider integrations are defined in the Gitlawb/openclaude repository. Explore the src/integrations directory for gateway implementations, vendor wrappers, and registry system details.

- Tags: deep-dive
- Published: 2026-09-02

### [What Is the Descriptor-First Architecture in OpenClaude?](/Gitlawb/openclaude/openclaude-descriptor-first-architecture)

Discover OpenClaude's descriptor-first architecture. Centralize model and provider configurations into declarative metadata objects for efficient routing, capability checks, and validation.

- Tags: architecture
- Published: 2026-09-02