NyxosNyxos API
Integrations

Claude CLI, Codex CLI & Codex App

Running terminal AI tools and the Codex app with Nyxos API.

Terminal CLI tools let you integrate LLM completions into CI/CD pipelines, shell scripts, and git hooks. Most of them install with Node.js — get the LTS version from nodejs.org (18 or newer) if you don't have it.


Claude CLI (Anthropic)

Installation (requires Node.js 18+):

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

Configuration — Claude CLI uses the Anthropic-native protocol, so point it at the root host (no /v1):

export ANTHROPIC_BASE_URL="https://api.nyxos.shop"
export ANTHROPIC_AUTH_TOKEN="sk-YOUR_NYXOS_KEY"

claude "Review the last git commit and summarize breaking changes"

See the full guide: Claude Code Integration.


OpenAI Codex CLI

Installation (requires Node.js 18+):

npm install -g @openai/codex
codex --version

Configuration — edit ~/.codex/config.toml, define a custom provider, and point model_provider at it:

model_provider = "nyxos"
model = "<exact-model-id>"
model_reasoning_effort = "medium"

[model_providers.nyxos]
name = "Nyxos API"
base_url = "https://api.nyxos.shop/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"
requires_openai_auth = false

Then set the environment variable that holds your key:

# Linux / macOS
export OPENAI_API_KEY="sk-YOUR_NYXOS_KEY"

# Windows PowerShell (persistent, user scope)
[System.Environment]::SetEnvironmentVariable('OPENAI_API_KEY', 'sk-YOUR_NYXOS_KEY', 'User')

Run Codex as usual:

codex

Notes:

  • model must be an exact ID from /pricing, enabled for your key's group.
  • With a custom env_key, Codex reads the key from the environment at launch — nothing is hardcoded in the config file.

Codex App

The Codex desktop app shares its configuration with the CLI: it reads the same ~/.codex/config.toml and your environment variables. Configure them once in the terminal (as above), restart the app, and it is already connected — there is no separate setup inside the app.


Generic OpenAI CLI Tools

Many OpenAI-spec tools read the standard environment variables:

export OPENAI_API_KEY="sk-YOUR_NYXOS_KEY"
export OPENAI_BASE_URL="https://api.nyxos.shop/v1"

Some tools name the base-URL variable differently (OPENAI_API_BASE, API_BASE_URL, or a config file) — check each tool's documentation, and apply the same rules: explicit /v1 for OpenAI-compatible tools, root URL for tools that build the path themselves.

On this page