Configuration

/prism:setup writes everything you need to ~/.prism/config.json. This page explains the three settings inside that file and how to change them.

Config file

{
  "apiKey": "gck_your_key_here",
  "prismThreshold": 4,
  "enableGateway": true
}

Field	Type	Default	Description
apiKey	string	—	Your gck_* API key (required)
prismThreshold	number	4	Minimum prompt grade (0–10). Prompts below this trigger a rewrite suggestion
enableGateway	boolean	true	Route Claude API requests through the Optra gateway

The file is created with 600 permissions (owner read-write only). Edit it directly or use the commands below.

API key

Your gck_* key authenticates the plugin with Optra Prism. Get one from your dashboard — it appears on the setup page after sign-in.

/prism:setup gck_YOUR_API_KEY

Re-run /prism:setup any time you need to rotate the key.

Gateway routing

Gateway routing controls whether your Claude API requests go through the Optra gateway:

• Enabled (default) — requests pass through the gateway, enabling budget enforcement, guardrails, and usage tracking.
• Disabled — requests go directly to Anthropic. Telemetry and session scoring still work either way.

To switch modes, run /prism:status and ask it to toggle gateway routing. Restart Claude Code after the change.

Prompt grade threshold

The threshold sets when the prompt advisor speaks up. Any prompt graded below prismThreshold (default 4) gets a rewrite suggestion with coaching tips; anything at or above passes silently.

Tune it in ~/.prism/config.json:

{
  "prismThreshold": 5
}

• Higher value → more interventions (the advisor catches more prompts)
• Lower value → only the worst prompts are flagged

Restart Claude Code to apply the change.