Qwen Code を CheapTokens に接続する: 環境変数と settings.json

Qwen Code はカスタムの OpenAI 互換エンドポイントに接続できるため、CheapTokens に接続するには3つの値が必要です。ベース URL https://api.cheaptokens.dev/v1、API キー、そして deepseek-ai/DeepSeek-V4-Flash-0731 のような完全なモデル ID です。これらを OPENAI_API_KEY、OPENAI_BASE_URL、OPENAI_MODEL としてエクスポートするか、~/.qwen/settings.json に記述します。どちらの方法も Qwen Code の認証ドキュメント（最終更新日 2026年10月22日）に基づいています。

長いセッションを想像してみてください。エージェントは十数個のファイルを読み、3つを編集し、テストを再実行します。各ステップでコンテキストが再送されるため、入力に対して何度も支払いが発生します。だからこそ、トークン残高制の安価なモデルがターミナルエージェントに適しており、以下のセットアップに10分かける価値があるのです。

Qwen Code をインストールする#

Qwen Code には Node.js 22 以降が必要です。プロジェクトの README（github.com/QwenLM/qwen-code）にはいくつかのインストール方法が記載されています。そのうち2つを紹介します:

npm install -g @qwen-code/qwen-code@latest

brew install qwen-code

qwen で起動します。ドキュメントには、プロキシや未対応のプロバイダーを手動で接続するための /auth → Custom Provider についても記載されています。以下の2つの方法は1行ずつ書き出しているので、どちらかから始めてください。

方法 1: 3つの環境変数#

最も手早い方法です。プロジェクトでターミナルを開き、次を実行します:

export OPENAI_API_KEY="sk-your-api-key"
export OPENAI_BASE_URL="https://api.cheaptokens.dev/v1"
export OPENAI_MODEL="deepseek-ai/DeepSeek-V4-Flash-0731"
qwen

キーはプレースホルダーです。CheapTokens ダッシュボードから自分のキーを貼り付けてください。OPENAI_API_KEY をエクスポートすることは、環境変数ですべてを設定する場合に Qwen Code へ OpenAI 互換認証を使うよう指示する役割も果たします。OPENAI_MODEL にはエイリアス QWEN_MODEL があります。

多くの人がつまずく点が1つあります。モデル ID です。CheapTokens のドキュメントにある完全な ID を使用してください。価格の横に表示される短い名前 deepseek-v4-flash-0731 は API では受け付けられず、ID はプロバイダー間で異なります。

どの変数が何をするのか？対応させてみましょう:

エクスポートはターミナルを閉じるまで有効です。設定を保持するには、次の方法を使用してください。

方法 2: settings.json と git の外に置くキー#

リポジトリをチームで共有していて、誰も設定ファイルにキーを置きたくないとします。その場合は ~/.qwen/settings.json でモデルを記述し、キーは別のファイルに保管します。

{
  "modelProviders": {
    "openai": [
      {
        "id": "deepseek-ai/DeepSeek-V4-Flash-0731",
        "name": "DeepSeek-V4-Flash (CheapTokens)",
        "baseUrl": "https://api.cheaptokens.dev/v1",
        "description": "DeepSeek-V4-Flash through CheapTokens",
        "envKey": "CHEAPTOKENS_API_KEY"
      }
    ]
  },
  "security": { "auth": { "selectedType": "openai" } },
  "model": { "name": "deepseek-ai/DeepSeek-V4-Flash-0731" }
}

重要なのは4つのフィールドです:

• id は API に送信されるモデル ID なので、完全な ID でなければなりません。
• model.name は id の値のいずれかと一致する必要があります。そうでなければ Qwen Code が選択できません。
• security.auth.selectedType を "openai" に設定すると、OpenAI 互換の経路が選択されます。
• envKey はキーを保持する変数名を指定します。省略可能で、デフォルトは OPENAI_API_KEY です。

キー自体は .qwen/.env に記述します。ドキュメントではシークレット用として推奨されており、このファイルは git の管理外に保たれます:

CHEAPTOKENS_API_KEY=sk-your-api-key

settings.json の env ブロックよりこれを好む理由があります。env の値は優先度が最も低く、キーを含むファイルは誤ってコミットしやすいからです。キーを安全に保つ方法については API キーを安全に保管する をご覧ください。

起動後、/model で設定済みのモデルが表示され、切り替えられます。特定のモデルで開始するには、qwen --model "deepseek-ai/DeepSeek-V4-Flash-0731" を実行します。

コーディングセッションのコスト#

ターミナルエージェントは入力が多くなります。各ステップで、それまでに収集したファイルと履歴が送信されます。40ステップのタスクで、1ステップあたり入力 30,000 トークン、出力 1,000 トークンと仮定します。すると 40 × 30,000 = 1,200,000 入力トークン、40 × 1,000 = 40,000 出力トークンになります。実際の価格でタスク全体を計算すると:

入力と出力を合計すると、表の各モデルで CheapTokens は OpenRouter より安価です。この種のループには DeepSeek-V4-Flash がよく合います。380K のコンテキスト、1回の回答で最大 32,768 出力トークン、時間帯を問わず一律の価格、すべてのモデルで1つの残高です。実際の数値は異なるので、スライダーを動かしてみてください:

価格は料金ページにあります。別のエージェントでの使用量を確認したい場合は、Cline のコストで同じ計算を解説しています。

試すべき他のモデル#

切り替えは ID を変えるだけです。モデルページまたは GET /v1/models から取得してください:

• zai-org/GLM-5.3-Flash: 390K コンテキスト、1回の回答で最大 8,192 出力トークン、OpenRouter より低い合計価格。
• MiniMaxAI/MiniMax-M2.7: 180K コンテキスト、1回の回答で最大 8,192 出力トークン、OpenRouter より低い合計価格。

OPENAI_MODEL を変更するか、modelProviders.openai に2つ目のエントリを追加して /model で切り替えてください。

Qwen Code が接続しない場合#

• 認証タイプが選択されていない。 環境変数のみの場合、OPENAI_API_KEY をエクスポートする必要があります。settings.json の場合は、selectedType が "openai" であることを確認してください。
• モデルが見つからない。 model.name は id と文字単位で一致する必要があり、ID は完全なゲートウェイ ID でなければなりません。
• 401。 キーが欠落しているか誤っています。envKey を使用する場合は、その変数が .qwen/.env またはシェルに実際に存在することを確認してください。
• 404。 ベース URL が /v1 で終わっていること、ID に誤字がないことを確認してください。詳細な手順は API 401 または 404: キー、ベース URL、モデル ID の誤り にあります。
• 変数が無視されているように見える。 settings.json 内の env の値は優先度が最も低いため、他の場所で設定された変数が優先されます。

他のターミナルエージェントの設定も同じパターンに従います。例えば OpenCode や Aider です。キーから最初のリクエストまで、その他すべては CheapTokens ドキュメントにあります。