TOKENOPENTOKENOPEN
User GuideAPI ReferenceHelp & Support
AI Apps

Configure AI Apps with tokenopen-config

Use tokenopen-config to quickly configure Claude Code, Codex, OpenClaw, Hermes, and other AI apps

tokenopen-config is a one-click AI CLI setup tool that quickly connects Claude Code, Codex, OpenClaw, Hermes, and other clients to TOKENOPEN, reducing the need to edit config files manually.

If Node.js is already installed on your machine, npm is usually available as well, so you can install tokenopen-config directly.


1. Introduction

  • One-click setup for mainstream AI CLI tools to connect to TOKENOPEN
  • Reduces the cost of manually editing config files, environment variables, and model endpoints
  • Suitable for managing Claude Code, Codex, OpenClaw, Hermes, and other tools at the same time

2. Download tokenopen-config

First, confirm that npm is installed:

npm --version

Install tokenopen-config:

npm install -g tokenopen-config

Check the version:

tokenopen-config --version

If you do not want to install it globally, you can also run:

npx -y tokenopen-config --version

3. Prepare an API Key

Log in to the TOKENOPEN Console, open API Keys, then create or copy a key.


4. Usage Guide

First, view the help information:

tokenopen-config --help

Output:

tokenopen-config v0.1.1

One-click TokenOpen setup for Claude Code, Codex, OpenClaw, and Hermes.

Usage:
  tokenopen-config -k sk-your-token --only claude
  tokenopen-config -k sk-your-token --only codex
  tokenopen-config -k sk-your-token --only openclaw
  tokenopen-config -k sk-your-token --only hermes
  tokenopen-config -k sk-your-token --only all
  tokenopen-config -k sk-your-token --only claude,codex
  tokenopen-config -k sk-your-token --only all --model gpt-5.4

npx:
  npx -y tokenopen-config
  npx -y tokenopen-config -k sk-xxx
  npx -y tokenopen-config -k sk-xxx --only claude,codex
  npx -y tokenopen-config -k sk-xxx --only all --model gpt-5.4

Options:
  -k, --api-key <key>     TokenOpen API key; sk- prefix is optional
      --only <value>      claude | codex | openclaw | hermes | all
      --base-url <url>    Override host; default https://www.tokenopen.ai
  -M, --model <model>     Model for Codex/OpenClaw/Hermes
      --skip-verify       Skip GET /v1/models verification
  -v, --verbose           Show subprocess output
  -h, --help              Show help
  -V, --version           Show version

Common usage:

tokenopen-config -k sk-your-token --only claude
tokenopen-config -k sk-your-token --only codex
tokenopen-config -k sk-your-token --only openclaw
tokenopen-config -k sk-your-token --only hermes

Configure all supported clients at once:

tokenopen-config -k sk-your-token --only all

Specify a model:

tokenopen-config -k sk-your-token --only codex --model gpt-5.4

tokenopen-config modifies configuration files on the user's local machine after execution. It does not change source files in your repository.

Based on the current implementation, it writes to the following locations:

  • claude: modifies ~/.claude/config.json, also updates ~/.claude/settings.json through zcf, and writes shell config files such as ~/.bashrc, ~/.zshrc, or ~/.config/fish/config.fish
  • codex: updates ~/.codex/config.toml and ~/.codex/auth.json through zcf
  • openclaw: calls openclaw onboard, targeting ~/.openclaw/openclaw.json
  • hermes: writes ~/.hermes/config.yaml and ~/.hermes/.env; if HERMES_HOME is set, it writes to that directory instead

Last updated on