Struct MatrixConfig 

pub struct MatrixConfig {

    pub provider: Option<String>,
    pub api_key: Option<String>,
    pub base_url: Option<String>,
    pub model: Option<String>,
    pub think: bool,
    pub markdown: bool,
    pub max_tokens: u32,
    pub context_size: Option<u32>,
    pub multi_model: Option<bool>,
    pub plan_model: Option<String>,
    pub compress_model: Option<String>,
    pub fast_model: Option<String>,
    pub approve_mode: Option<String>,
    pub extra_headers: Option<HashMap<String, String>>,
    pub mcp_servers: Option<HashMap<String, McpServerConfig>>,
    pub lsp_servers: Option<HashMap<String, LspServerConfig>>,
    pub enable_lsp: bool,
    pub verify_strategy: Option<String>,
}

Matrixcode configuration file structure. Uses universal naming (no ANTHROPIC_ prefix).

Fields

provider: Option<String>

LLM provider: “anthropic” or “openai”

api_key: Option<String>

API key (universal naming, also supports ANTHROPIC_AUTH_TOKEN alias)

base_url: Option<String>

Base URL for API endpoint

model: Option<String>

Main model name

think: bool

Enable extended thinking

markdown: bool

Enable markdown rendering

max_tokens: u32

Maximum output tokens

context_size: Option<u32>

Context size

multi_model: Option<bool>

Multi-model configuration

plan_model: Option<String>

Plan/reasoning model

compress_model: Option<String>

Compress/haiku model

fast_model: Option<String>

Fast model

approve_mode: Option<String>

Approve mode: “ask”, “auto”, “strict”

extra_headers: Option<HashMap<String, String>>

Extra HTTP headers to add to API requests Format: {“Header-Name”: “header-value”}

mcp_servers: Option<HashMap<String, McpServerConfig>>

MCP servers configuration Format: {“server_name”: McpServerConfig}

lsp_servers: Option<HashMap<String, LspServerConfig>>

LSP servers configuration Format: {“server_name”: LspServerConfig}

enable_lsp: bool

Enable LSP tools globally If false, LSP servers won’t be loaded and LSP tools won’t be available

verify_strategy: Option<String>

Code verification strategy for write operations Options: “none” (no verification), “post” (verify after write, default), “pre” (verify before write, block if errors), “pre-quick” (quick syntax check before, full check after) When “pre” is enabled, invalid code will be blocked and errors returned to AI for automatic correction.

Implementations

impl MatrixConfig

pub fn matrix_config_path() -> Option<PathBuf>

Path to matrixcode config file.

pub fn claude_settings_path() -> Option<PathBuf>

Path to Claude Code settings file.

pub fn load() -> Self

Load configuration with fallback chain. Priority: env vars > ~/.matrix/config.json > ~/.claude/settings.json > defaults

pub fn get_api_key(&self, provider: &str) -> Option<String>

Get API key, with fallback to environment variable. Universal env var: API_KEY (also supports ANTHROPIC_AUTH_TOKEN for compatibility)

pub fn get_model(&self, provider: &str) -> String

Get model name, with fallback to environment variable. Universal env var: MODEL (also supports ANTHROPIC_MODEL for compatibility)

pub fn get_base_url(&self, provider: &str) -> String

Get base URL, with fallback to environment variable. Universal env var: BASE_URL (also supports ANTHROPIC_BASE_URL for compatibility)

pub fn save(&self) -> Result<()>

Save configuration to ~/.matrix/config.json.

pub fn is_api_configured(&self) -> bool

Check if API is configured.

pub fn resolve_api_key(&self) -> Option<String>

Get API key with fallback chain (public for subagent use)

pub fn resolve_base_url(&self) -> Option<String>

Get base URL with fallback chain (public for subagent use)

pub fn resolve_provider_type(&self, model: &str) -> ProviderType

Resolve provider type from config or infer from model (public for subagent use)

pub fn create_provider_from_env() -> Result<Arc<dyn Provider>>

Create a Provider instance from configuration. Useful for tools that need AI capabilities but don’t have an injected provider.

Trait Implementations

impl Clone for MatrixConfig

fn clone(&self) -> MatrixConfig

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for MatrixConfig

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for MatrixConfig

fn default() -> MatrixConfig

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for MatrixConfig

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for MatrixConfig

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.