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 --versionConfiguration — 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 --versionConfiguration — 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 = falseThen 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:
codexNotes:
modelmust 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.