TokenMix CLI

TokenMix 公式 CLI — 1コマンドで任意の AI コーディングエージェントを TokenMix に接続

概要

TokenMix CLI は TokenMix 公式のコマンドラインツールです。Claude Code、Aider、OpenCode、Codex、Qwen Code、Goose、OpenHands、および 4 つの VS Code 拡張（Kilo Code、Cline、Roo Code、Continue）を、設定なしで TokenMix アカウントに接続できます。環境変数の手動設定も設定ファイルの編集も不要です。1 つの API キーで OpenAI Chat Completions、Anthropic Messages、Responses API の 3 プロトコルすべてをカバーします。

前提条件

• Node.js 18 以降。 node --version で確認し、なければ nodejs.org からインストールしてください。
• TokenMix アカウント。 tokenmix.ai でサインアップ。新規アカウントには $1 の無料クレジットが付与されます（Qwen Flash など非プレミアムモデルで利用可能）。

インストール

方法 A — グローバルインストール（日常利用に推奨）：

npm install -g tokenmix

方法 B — インストール不要で実行（npx）：

npx tokenmix <コマンド>

ログイン

tokenmix login

ブラウザが開き、TokenMix アカウントにサインインして、ターミナルに表示される短いコードを確認するだけです。ブラウザが使えない環境では：

tokenmix login --paste          # キーをペーストするインタラクティブモード
tokenmix login --key sk-tm-...  # API キーを直接指定（CI 向け）

認証情報は macOS では ~/Library/Application Support/tokenmix/config.json、Linux では ~/.config/tokenmix/config.json、Windows では %APPDATA%/tokenmix/config.json にパーミッション 0600 で保存されます。

エージェントを一発起動

初回実行時にエージェントを自動インストール（対応している場合）し、TokenMix に向けます：

npx tokenmix opencode       # OpenCode — 自動インストール
npx tokenmix claude         # Claude Code — 自動インストール
npx tokenmix aider          # Aider — pip install aider-chat が必要
npx tokenmix codex          # Codex — 自動インストール
npx tokenmix qwen           # Qwen Code — 自動インストール
npx tokenmix goose          # Goose — 先に Goose 本体のインストールが必要
npx tokenmix openhands      # OpenHands — Python 3.12+、uv tool install openhands が必要

VS Code 拡張機能の設定（スニペットを出力して拡張機能の設定に貼り付けるだけ）：

npx tokenmix kilo           # Kilo Code
npx tokenmix cline          # Cline
npx tokenmix roo            # Roo Code
npx tokenmix continue       # Continue（VS Code / JetBrains）

$1 の無料トライアルを使う

無料クレジットは非プレミアムモデルで利用できます。ゼロコストで試すには qwen-flash を指定してください：

TOKENMIX_DEFAULT_MODEL=qwen-flash npx tokenmix opencode

tokenmix models で全モデルと価格を確認できます。

動作確認

tokenmix balance   # リアルタイム残高・ギフトクレジット・総消費を表示
tokenmix doctor    # キーの有効性と各エージェントのインストール/設定状態を診断

balance で残高が表示され、doctor がエラーなしなら準備完了です。

よくある質問

tokenmix login 実行時にブラウザが開きませんでした。 サーバー、コンテナ、SSH 環境では正常な動作です。ターミナルに URL と短いコードが表示されるので、任意のデバイスで URL を開いてコードを入力してください。tokenmix login --paste でキーのペーストも可能、CI では tokenmix login --key sk-tm-... を使ってください。

デフォルトモデルを変更するには？ エージェントは claude-sonnet-4.6 をデフォルトとして使います。TOKENMIX_DEFAULT_MODEL 環境変数で上書きできます。tokenmix models で全モデルを確認してください。tokenmix claude と tokenmix codex は Claude ファミリーのモデルが必要です。他のエージェントは任意のチャットモデルに対応します。

ログアウト・アンインストールするには？ tokenmix logout で保存済みキーを削除し、CLI が変更したエージェント設定を元に戻します。グローバルインストール済みの場合は npm uninstall -g tokenmix で完全削除できます。