Connect Claude Code to Token Factory

Corvex Token Factory exposes an Anthropic-compatible Messages API. The launcher on this page configures the Token Factory endpoint, API key, and model for Claude Code. It uses CLAUDE_CONFIG_DIR to keep Token Factory sessions and settings in ~/.claude-corvex, separate from your default Claude Code profile.

Prerequisites

A Token Factory API key (sk-corvex-...) from the dashboard. See Authentication.
A model name from the Models catalog (this guide uses zai-org/GLM-5.3 as the example).
Claude Code installed and jq available.

Store your key and endpoint in a private env file

Replace sk-corvex-... with your key from the dashboard.

mkdir -p ~/.corvex
chmod 700 ~/.corvex

cat > ~/.corvex/claude-code.env <<'EOF'
export CORVEX_API_KEY="sk-corvex-..."
export CORVEX_BASE_URL="https://api.tokenfactory.corvex.cloud"
export CORVEX_CLAUDE_MODEL="zai-org/GLM-5.3"
export CLAUDE_CODE_AUTO_COMPACT_WINDOW="200000"
export CLAUDE_AUTOCOMPACT_PCT_OVERRIDE="90"
EOF

chmod 600 ~/.corvex/claude-code.env

Create the launcher

The claude-corvex launcher sources the private environment file, selects the Token Factory profile, and passes its arguments to claude.The script installs to ~/.local/bin so you can invoke it as claude-corvex from any directory. That directory is on PATH by default on most Linux distributions; on macOS, add export PATH="${HOME}/.local/bin:${PATH}" to your shell profile (e.g. ~/.zshrc) and restart your shell.

mkdir -p ~/.local/bin
cat > ~/.local/bin/claude-corvex <<'EOF'
#!/usr/bin/env bash
set -euo pipefail

CLAUDE_CONFIG_DIR="${HOME}/.claude-corvex"
ENV_FILE="${HOME}/.corvex/claude-code.env"

if [[ ! -f "${ENV_FILE}" ]]; then
  echo "[claude-corvex] missing ${ENV_FILE}" >&2
  exit 1
fi

set -a
# shellcheck disable=SC1090
source "${ENV_FILE}"
set +a

mkdir -p "${CLAUDE_CONFIG_DIR}"

# Customizations (plugins, settings) and MCP servers are NOT mirrored on launch.
# Run claude-corvex-migrate to carry them over (see the optional section below).

MODEL="${CORVEX_CLAUDE_MODEL}"

export CLAUDE_CONFIG_DIR
export ANTHROPIC_BASE_URL="${CORVEX_BASE_URL}"
export ANTHROPIC_AUTH_TOKEN="${CORVEX_API_KEY}"
export ANTHROPIC_MODEL="${MODEL}"
export ANTHROPIC_DEFAULT_SONNET_MODEL="${MODEL}"
export ANTHROPIC_DEFAULT_OPUS_MODEL="${MODEL}"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="${MODEL}"
export CLAUDE_CODE_SUBAGENT_MODEL="${MODEL}"
export CLAUDE_CODE_AUTO_COMPACT_WINDOW="${CLAUDE_CODE_AUTO_COMPACT_WINDOW:-}"
export CLAUDE_AUTOCOMPACT_PCT_OVERRIDE="${CLAUDE_AUTOCOMPACT_PCT_OVERRIDE:-90}"

echo "[claude-corvex] ${ANTHROPIC_BASE_URL}" >&2
echo "[claude-corvex] model: ${MODEL}" >&2

claude --model "${MODEL}" "$@"
EOF

chmod 700 ~/.local/bin/claude-corvex

Verify the API key

Call the Anthropic-compatible token-counting endpoint. This validates the key and request shape without running inference.

source ~/.corvex/claude-code.env

curl -sS "${CORVEX_BASE_URL}/v1/messages/count_tokens" \
  -H "x-api-key: ${CORVEX_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-ai/DeepSeek-V4-Flash-0731",
    "messages": [{"role": "user", "content": "Hello"}]
  }' | jq .

Run Claude Code through Token Factory

cd /path/to/your/repo
claude-corvex

In Claude Code, verify the endpoint and model:

/status
/model

Context length

Claude Code does not auto-detect the context window of a model reached through a custom endpoint. It limits these sessions to 200,000 tokens, even when the model supports a larger native window. Two limits bound a session, and the compaction window must respect both:

Claude Code’s 200K session limit — CLAUDE_CODE_AUTO_COMPACT_WINDOW can never usefully exceed 200000.
The model’s context window minus the request’s output reservation. The engine enforces input + max_tokens ≤ context_window on every request, and Claude Code sends max_tokens = its max output setting (32,000 by default; CLAUDE_CODE_MAX_OUTPUT_TOKENS). Tool-heavy turns also overshoot the compaction trigger by roughly 15% before compaction runs, so size the window as (context_window − max_tokens) / 1.15, then cap it at 200000.

Model	Native window	Input room at `max_tokens=32000`	`CLAUDE_CODE_AUTO_COMPACT_WINDOW`
`zai-org/GLM-5.3`	393,216 (384K)	361,216	`200000`
`deepseek-ai/DeepSeek-V4-Flash-0731`	1,048,576 (1M)	1,016,576	`200000`

For both models, the 200K session limit binds with the default 32,000-token output reservation. If you raise CLAUDE_CODE_MAX_OUTPUT_TOKENS, recalculate the compaction window using the formula above. Set CLAUDE_AUTOCOMPACT_PCT_OVERRIDE to the percentage of the window at which compaction should begin; the example uses 90. Confirm the effective window with /context. To use the full native window, call the API directly. When you switch models, update CORVEX_CLAUDE_MODEL and re-derive the compaction window from the table or the formula above. GET /v1/models reports each model’s context_window and max_output_tokens. If a model carries an output cap below its window, the response also includes max_input_tokens (context_window − max_output_tokens): the input ceiling for a request that reserves the full output cap. Use the smaller of that value and context_window − max_tokens as the input room in the formula. If a session does hit the model’s limit anyway, the gateway returns context_length_exceeded (see Errors) — compact and retry.

Optional: migrate plugins, settings, and MCP servers

The launcher starts with a clean Token Factory profile. Run this claude-corvex-migrate script to copy your plugins, settings, CLAUDE.md, and MCP servers from your normal Claude profile into ~/.claude-corvex. Run it again after changing your default profile. A failed optional copy step warns and continues.The first part copies named paths from ~/.claude/ via an rsync include-list. It needs rsync and is skipped with a warning if rsync is absent. The second part merges only the mcpServers key from ~/.claude.json into the Token Factory profile. It needs jq. The first run may be slow if your plugin tree is large.

Review settings.json, .mcp.json, and mcpServers before copying them. They can contain environment variables, command arguments, or credentials that you do not want in the Token Factory profile.

cat > ~/.local/bin/claude-corvex-migrate <<'EOF'
#!/usr/bin/env bash
# Carry customizations and MCP servers from your normal Claude profile (~/.claude,
# ~/.claude.json) into the Token Factory profile (~/.claude-corvex). Run once before
# launching claude-corvex, or again after changing your main Claude config. Safe to
# re-run; best-effort (a missing tool or failed step warns and continues).
#
# Step 1 copies named paths from ~/.claude/ via an rsync include-list. Review the
# selected files first: settings and MCP configuration can contain secrets.
# Step 2 merges only the mcpServers key from ~/.claude.json (where MCP servers live,
# NOT under ~/.claude/), overwriting the Token Factory profile's mcpServers to
# mirror the main config and leaving all other profile state intact.
set -euo pipefail

DEFAULT_CLAUDE_CONFIG_DIR="${HOME}/.claude"
CLAUDE_CONFIG_DIR="${HOME}/.claude-corvex"

mkdir -p "${CLAUDE_CONFIG_DIR}"

# 1) Customizations under ~/.claude/ (plugins, settings, skills, ...).
if command -v rsync >/dev/null 2>&1; then
  echo "[claude-corvex] mirroring ~/.claude customizations -> ${CLAUDE_CONFIG_DIR} (first run may take a while)..." >&2
  if rsync -a --no-owner --no-group \
    --include 'settings.json' \
    --include 'CLAUDE.md' \
    --include 'plugins/***' \
    --include 'commands/***' \
    --include 'agents/***' \
    --include 'output-styles/***' \
    --include 'skills/***' \
    --include 'keybindings.json' \
    --include '.mcp.json' \
    --exclude '*' \
    "${DEFAULT_CLAUDE_CONFIG_DIR}/" "${CLAUDE_CONFIG_DIR}/"; then
    echo "[claude-corvex] mirrored ~/.claude customizations -> ${CLAUDE_CONFIG_DIR}" >&2
  else
    echo "[claude-corvex] rsync failed; skipped customizations" >&2
  fi
else
  echo "[claude-corvex] rsync not found; skipped customizations" >&2
fi

# 2) MCP servers (user scope) from ~/.claude.json. Overwrite mcpServers to mirror
#    the main config; preserve all other keys in the Token Factory .claude.json.
if ! command -v jq >/dev/null 2>&1; then
  echo "[claude-corvex] jq not found; skipped MCP (install jq to carry MCP servers)" >&2
elif [[ ! -f "${HOME}/.claude.json" ]]; then
  echo "[claude-corvex] no ~/.claude.json; skipped MCP (nothing to merge)" >&2
else
  dst="${CLAUDE_CONFIG_DIR}/.claude.json"
  tmp="${dst}.tmp"
  [[ -f "${dst}" ]] || echo '{}' > "${dst}"
  echo "[claude-corvex] merging mcpServers from ~/.claude.json -> ${dst}..." >&2
  if jq --slurpfile s "${HOME}/.claude.json" \
    '.mcpServers = ($s[0].mcpServers // {})' "${dst}" > "${tmp}"; then
    mv -f "${tmp}" "${dst}"
    echo "[claude-corvex] merged mcpServers -> ${dst}" >&2
  else
    rm -f "${tmp}"
    echo "[claude-corvex] mcpServers merge failed; ${dst} left unchanged" >&2
  fi
fi
EOF

chmod 700 ~/.local/bin/claude-corvex-migrate

Run it:

claude-corvex-migrate

Subcommands

The launcher passes arguments straight through to claude and exports CLAUDE_CONFIG_DIR, so mcp, plugin, config, and other subcommands target ~/.claude-corvex automatically.

claude-corvex mcp list
claude-corvex mcp add <name> -s user -e KEY=val -- <command>
claude-corvex plugin ...
claude-corvex config ...

claude mcp add run through this launcher writes to the Token Factory profile (~/.claude-corvex/.claude.json), not the default profile.
Use -s user (or local) for personal config. -s project writes a .mcp.json into the current project dir, which is shared across both profiles.

Compatibility notes

Prompt caching. The Messages API accepts cache_control, but Token Factory does not treat it as a request to cache content. Engine-reported cache usage is passed through; missing cache-usage fields are reported as zero. See Errors: Prompt caching for details.
Model capabilities. Choose a model whose input types and features match the Claude Code task. Unsupported inputs return a structured error; compare the available models on the Models page.

Get Started

Models & Pricing

Integrations

API Reference

Security & Compliance

Reference

Connect Claude Code to Token Factory

Prerequisites

Context length

Subcommands

Compatibility notes

​Prerequisites

​Context length

​Subcommands

​Compatibility notes

Prerequisites

Context length

Subcommands

Compatibility notes