Cost controls for Cortex Code¶

How credit limits work¶

Each parameter tracks the corresponding user’s estimated credit usage over a rolling 24-hour window. When a user’s estimated usage reaches the configured limit for a given surface, access is blocked for that surface until usage drops below the threshold.

Both parameters share the same behavior:

Each parameter can be set at the account level (applies to all users) or at the user level (applies to a specific user). A user-level setting overrides the account-level setting for that user.

Cortex Code CLI limits¶

The CORTEX_CODE_CLI_DAILY_EST_CREDIT_LIMIT_PER_USER parameter controls the daily credit limit for Cortex Code CLI usage.

-- Set the daily credit usage limit to 20 credits for all users in the account
ALTER ACCOUNT SET CORTEX_CODE_CLI_DAILY_EST_CREDIT_LIMIT_PER_USER = 20;

-- Remove the account-level limit (restores default unlimited usage)
ALTER ACCOUNT UNSET CORTEX_CODE_CLI_DAILY_EST_CREDIT_LIMIT_PER_USER;

-- Set a per-user CLI limit that overrides the account-level setting
ALTER USER jsmith SET CORTEX_CODE_CLI_DAILY_EST_CREDIT_LIMIT_PER_USER = 10;

-- Remove the user-level override (account-level setting applies instead)
ALTER USER jsmith UNSET CORTEX_CODE_CLI_DAILY_EST_CREDIT_LIMIT_PER_USER;

Cortex Code in Snowsight limits¶

The CORTEX_CODE_SNOWSIGHT_DAILY_EST_CREDIT_LIMIT_PER_USER parameter controls the daily credit limit for Cortex Code usage within the Snowsight web interface.

-- Set the daily Snowsight credit usage limit to 20 credits for all users in the account
ALTER ACCOUNT SET CORTEX_CODE_SNOWSIGHT_DAILY_EST_CREDIT_LIMIT_PER_USER = 20;

-- Remove the account-level Snowsight limit (restores default unlimited usage)
ALTER ACCOUNT UNSET CORTEX_CODE_SNOWSIGHT_DAILY_EST_CREDIT_LIMIT_PER_USER;

-- Set a per-user Snowsight limit that overrides the account-level setting
ALTER USER jsmith SET CORTEX_CODE_SNOWSIGHT_DAILY_EST_CREDIT_LIMIT_PER_USER = 10;

-- Remove the user-level Snowsight override (account-level setting applies instead)
ALTER USER jsmith UNSET CORTEX_CODE_SNOWSIGHT_DAILY_EST_CREDIT_LIMIT_PER_USER;

When a limit is reached¶

When a user’s estimated credit usage exceeds the configured limit for a surface, that surface returns an error indicating that the daily credit limit has been reached. The user cannot use that surface until sufficient time has passed for the rolling 24-hour usage to drop below the limit. Other surfaces with separate limits are not affected.

Administrators can adjust or remove the limit at any time to restore access.

Listing users with custom limits¶

The following SQL script lists all users who have a per-user credit limit override for the CLI parameter. This is useful for administrators who want to audit which users have custom limits set at the user level.

-- List all users who have a per-user CLI credit limit override
EXECUTE IMMEDIATE $$
DECLARE
  current_user STRING;
  rs_users RESULTSET;
  res      RESULTSET;
BEGIN
  CREATE OR REPLACE TEMPORARY TABLE _param_overrides (user_name STRING, param_value STRING);

  SHOW USERS;
  rs_users := (SELECT "name" FROM TABLE(RESULT_SCAN(LAST_QUERY_ID())));

  FOR record IN rs_users DO
    current_user := record."name";

    EXECUTE IMMEDIATE
      'SHOW PARAMETERS LIKE ''CORTEX_CODE_CLI_DAILY_EST_CREDIT_LIMIT_PER_USER'' IN USER "' || :current_user || '"';

    INSERT INTO _param_overrides (user_name, param_value)
      SELECT :current_user, "value"
      FROM TABLE(RESULT_SCAN(LAST_QUERY_ID()))
      WHERE "level" = 'USER';
  END FOR;

  res := (SELECT * FROM _param_overrides);
  RETURN TABLE(res);
END;
$$;

This script iterates over all users in the account, checks whether a user-level override is set for CORTEX_CODE_CLI_DAILY_EST_CREDIT_LIMIT_PER_USER, and returns a table of users with their override values. You can modify the parameter name in the SHOW PARAMETERS LIKE clause to check the Snowsight parameter instead.

Example: Configuring limits for your organization¶

The following example sets default limits for all users in the account across both surfaces, then assigns a higher limit to a power user for CLI usage:

-- Set default daily limits for all users
ALTER ACCOUNT SET CORTEX_CODE_CLI_DAILY_EST_CREDIT_LIMIT_PER_USER = 20;
ALTER ACCOUNT SET CORTEX_CODE_SNOWSIGHT_DAILY_EST_CREDIT_LIMIT_PER_USER = 20;

-- Allow a specific user a higher CLI limit
ALTER USER power_user SET CORTEX_CODE_CLI_DAILY_EST_CREDIT_LIMIT_PER_USER = 50;

-- Block a specific user from Snowsight entirely
ALTER USER restricted_user SET CORTEX_CODE_SNOWSIGHT_DAILY_EST_CREDIT_LIMIT_PER_USER = 0;