programs.codex.settings

Configuration written to CODEX_HOME/config.toml (0.2.0+) or ~/.codex/config.yaml (<0.2.0). Per default CODEX_HOME defaults to ~/.codex. See https://github.com/openai/codex/blob/main/codex-rs/config.md for supported values.

Type

null or TOML value

Default

{ }

Example

{
  model = "gemma3:latest";
  model_provider = "ollama";
  model_providers = {
    ollama = {
      name = "Ollama";
      baseURL = "http://localhost:11434/v1";
      envKey = "OLLAMA_API_KEY";
    };
  };
  mcp_servers = {
    context7 = {
      command = "npx";
      args = [
        "-y"
        "@upstash/context7-mcp"
      ];
    };
  };
}

Declared

<home-manager/modules/programs/codex.nix>