Documentation — Prismia API

A walk-through for installing the Claude Code client — from a clean machine to your first claude command in five short steps. Pick your OS below.

Platform: · macOS 10.15 Catalina or later
Time: · ~5 min
Updated: · Jul 2026

Step 01

Install Node.js (if you haven't already)

The Claude Code client requires Node.js 18 or newer. First, check what is installed:

node --version

If the version is below 18.0.0, install the current Node.js LTS release:

brew install node

Already on Node 18 or newer? Skip this step entirely.

Step 02

Create a Prismia API key

Open the API Keys page, select New API key, give it a memorable name, and copy the secret. You will only see it once.

Treat your API key like a password. Anyone with it can use your Prismia API credits and plan allowance.

Step 03

Install Claude Code

Install the official client globally so the command is available from any project directory.

npm install -g @anthropic-ai/claude-code

Official Claude Code installation guide

Step 04

Configure settings.json

Save the gateway configuration in ~/.claude/settings.json. Replace the placeholder with the key from step 2.

{
  "hasCompletedOnboarding": true,
  "env": {
    "ANTHROPIC_BASE_URL": "https://capi.prismia.tech",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_PRISMIA_API_KEY",
    "API_TIMEOUT_MS": "3000000",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "ANTHROPIC_MODEL": "Claude Opus",
    "ANTHROPIC_DEFAULT_FABLE_MODEL": "Claude Fable",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "Claude Opus",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "Claude Sonnet",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "Claude Haiku"
  }
}

Prismia securely routes the client through your API account. Keep the key in a protected user-level configuration or secret manager.

Step 05

Launch Claude Code

Open a real project folder and start the client. Your requests will process through your Prismia API account.

cd /path/to/your/project
claude

View usage

FAQ

Common questions

Can I use both clients?

Yes. Claude Code and Codex can use the same Prismia API account and separate API keys.

Where can I revoke a key?

Open API Keys and revoke it immediately. Any client using that key will stop authenticating.

How do I confirm the setup worked?

Send one request, then check Request logs for its model, token count, latency, cost, and status.

Why does Codex show a missing-key error?

Confirm that env_key = "PRISMIA_API_KEY" is in your user-level provider configuration and that the variable is set in the environment that launched Codex. Do not put the secret directly in config.toml.

Why does Codex warn that model metadata was not found?

Prismia exposes the standard OpenAI /v1/models response, while Codex also looks for optional Codex-specific metadata. Codex falls back to default metadata and continues; this warning does not indicate a failed request.

Which model names can I use with Codex?

Use an exact model ID returned by GET /v1/models. Do not assume an OpenAI model name is available: for example, gpt-4o is not currently advertised by Prismia.

Why does Codex say it cannot execute file edits or shell commands?

This occurs if the selected model does not support tool/function calling or fails to parse system prompt instructions. Try changing wire_api = "chat" (or "responses") in your ~/.codex/config.toml, or select a model that supports tool calling (e.g. cx/gpt-5.6-sol).