# コンソール（ダッシュボード）利用ガイド

[qcode.cc](https://qcode.cc) にログインし、コンソール [qcode.cc/dashboard](https://qcode.cc/dashboard)
を開きます。コンソールは自分をひと言で *“Manage your API keys, top-up and usage”*（API Key・チャージ・
使用量の管理）と説明しているとおり、**1 ページだけ**で、Key・残高・プラン・使用量・紹介報酬・サポートが
すべてそこにあります。

> QCode の Key と Claude / ChatGPT サブスクの違いがまだ曖昧なら、まず
> [Subscriptions vs API Keys vs QCode Keys](/docs/reference/subscription-vs-api-key) をどうぞ。
> 中国本土以外の方なら [中国本土以外ユーザーのはじめ方](/docs/getting-started/international-users) へ。

## コンソールに何があるか

| ブロック | ここですること |
|---|---|
| ユーザーバー（右上） | ログインメールアドレスと `ID: …`、2 通貨の残高、**Recharge** / **Buy Plan** ボタンを確認 |
| API Access Address | `ANTHROPIC_BASE_URL` / `base_url` に入れるアドレスをコピー |
| API Key Management | Key の作成、値の表示とコピー、契約更新、失効した Key の展開 |
| One-Click Setup（各 Key カード内） | Claude Code / Codex のインストールコマンドをコピー |
| Open API | Key の期限と使用量をプログラムから読むためのアクセストークン管理 |
| Usage Statistics | 有効な Key のクォータ消費と、月次の合計 |
| Docs & Resources | IDE 連携とよく読むチュートリアル |
| Service Guide / Referral Rewards / Quick Links | 運用ルール、紹介リンク、報酬の受取、ヘルプ記事、エラーコード、サポート時間 |

## API Access Address

このブロックのタイトルはそのまま **API Access Address** で、アドレスの行ごとにコピーボタンが付いています。
**どの行が「推奨」としてハイライトされるかは、ログインしているコンソールの表示言語次第**です：

- **中国語インターフェース** — `https://asia.qcode.cc/api` が推奨行としてハイライトされ、その下に
  *“Mainland China users should use the accelerated address; others use the global address. Both offer
  identical performance”*（中国本土は加速アドレス、それ以外はグローバルアドレス、性能は同じ）という
  注記が出ます。
- **中国語以外のインターフェース**（現在 英語・日本語・ロシア語）— `https://api.qcode.cc` が推奨に
  ハイライトされ、その下の行は **Backup** 表示（米国 `https://us.qcode.cc/api`、アジア
  `https://asia.qcode.cc/api`）になります。

コピーしたアドレスには、使うツールに応じた**パスプレフィックス**がまだ必要です。
[エンドポイントと API パス](/docs/getting-started/endpoints-and-api-paths) を参照してください。
Claude Code ならこの 2 行です：

```bash
export ANTHROPIC_BASE_URL="https://api.qcode.cc/api"
export ANTHROPIC_AUTH_TOKEN="cr_your_key"
```

## API Key：作成・表示・コピー

**Create Key & Activate Service** ボタンがあるブロックが **API Key Management** です。Key がまだない場合、
空状態の画面が操作順をはっきり示します：**Top Up Balance** → **Buy a Plan** → **Start Using**。

1. まず [qcode.cc/recharge](https://qcode.cc/recharge) でチャージ（
  [支払い方法の概要](/docs/reference/payment-methods)）。
2. [qcode.cc/subscribe](https://qcode.cc/subscribe) でプランを選ぶ — **Recommended Plans** か
   **Custom Configuration** — 確認すれば完了。購入成功時には
   *“Subscription Activated — Your API Key is created and ready to use”* と出ます。Key はコピーボタン付きで
   表示され、**Go to Dashboard** リンクもあります。
3. コンソールに戻ると、Key の値は**デフォルトでは表示されません**：行は *Loading…* となり、目アイコンで
   初表示、その後 **Copy**。値が来る前にコピーすると、空文字列を渡す代わりにコンソールが教えてくれます。

同じブロックにあるもの：

- 立て続けた注文の Key は *“API key is being activated, we will process it as soon as possible”* を
  オンラインサポートへのリンクとともに表示することがあります。
- 既存の Key には **Renew** ボタンが付くことがあり、残高から簡単に契約更新できます。
- 使い切った Key は折りたたまれた **Expired keys** の中にあり、*Key expired or disabled* と表示されます。
- 各カードは、1 つの Key がカバーする 3 クライアント（Claude・Codex・Gemini）へのリンクを持っています。

## ワンクリック インストールコマンド

有効な Key カードには **One-Click Setup (Recommended)** ブロックがあり、**macOS / Linux** と **Windows**
のタブ、Claude Code と Codex それ 1 行のコマンド、行ごとの **Copy** ボタンが並んでいます：

```bash
curl -fsSL https://qcode.cc/install/claude-code.sh | bash
curl -fsSL https://qcode.cc/install/codex.sh | bash
```

ブロックの下のコンソール表記はそのまま *“Paste your key above when the script prompts for it.”*。
Windows タブでは `irm … | iex` 形式になり、その下には折りたたみ欄として、`irm` が使えない・実行ポリシーに
ブロックされるマシン向けの CMD ワンライナーとダブルクリック起動スクリプトが用意されています。詳しい流れと
スクリプトの表示言語の強制方法は [ワンクリック設定スクリプト](/docs/getting-started/one-click-install) に。

## Usage Statistics

**Usage Statistics** ブロックは有効な Key 単位（*“Quota usage for current active key”*）で、自動更新
（Off / 5 / 10 / 30 / 60 分）か **Refresh** での手動更新ができます。

| 節 | 内容 |
|---|---|
| Daily Cost Limit | 1 日あたりの最大利用額。北京時間の深夜 0 時にリセット、上限に達すると API が止まり翌日に復旧 |
| Time Window Limit | 4 時間ローリング窓のリクエスト数と金額。個人プランは *“removed the 4h rate window entirely in July 2026 — only the daily limit remains”* なので、ここが *No window limit* になり得ます |
| Opus Weekly Limit | Opus ティア専用の週間限度額で、月曜（北京時間）にリセット。Opus を含まないプランはその旨を表示 |
| Monthly Usage Overview | Total Tokens・Total Requests・Total Cost —— Key 作成日から集計 |
| Today's Model Calls | 当日のモデル別、入力 / 出力 / キャッシュ書込 / キャッシュ読取トークン |
| Booster | ブースターパックの有無。下記参照 |

パネル自体の免責：*“Data shown here may have slight variations, actual limits are based on Claude Code
responses.”* セッションのざっくりした費用は Claude Code の `/cost`、課金の計算ロジックは
[課金説明](/docs/reference/billing) に。

## チャージ、プラン、ブースター、アップグレード

- **残高は通貨ごとに別です。** *“CNY and USD balances are separate. Recharge amount will be added to the
  corresponding currency balance.”* ユーザーバーには 2 つの数値が並びます。
- **チャージ上限・下限**は recharge ページに：CNY は **¥100** から、USD は **$1** 以上 **$2,000** 以下。
  チャネル固有の 1 回上限もあり、超えると *“Due to the payment channel's per-transaction limit … Please split
  it into several smaller recharges.”* のように表示されます。
- **チャージ後に戻ると**：コンソールに *“Balance received — You can activate a plan now.”* バナーと
  **Choose a plan** ボタン。**余った残高は無駄になりません**：*“Any balance left after your top-up isn't
  wasted: use it later toward an upgrade or a booster pack.”*
- **複数か月まとめ買い**は割引：*“Subscribe for 3+ months for up to 25% off (12 months).”*
- **ブースターパック**（*Self-service Booster Pack*）はコンソールで残高から即購入でき、その場で上限を
  拡大。北京時間 午前 2 時（UTC+8）にリセットされます。
- **アップグレード**はコンソールのボタンではありません：上位プランを先に買い、
  [hi@qcode.cc](mailto:hi@qcode.cc) へメールして旧プランを閉じ、未使用分を残高に返してもらいます。

## サブキーとチーム機能

個人コンソールは**プランにつき 1 つのメイン Key**で、セルフサービスのサブキー画面は**ありません**。
サブキーはチーム向け製品の一部です：

- **エンタープライズ チーム版**のページには *Sub-API Key Management Center* があり、
  *“fine-grained configuration and management for each team member”*、プラン比較表には**サブキーは無制限、それぞれに独立したクォータ**とあります。同じページに
  **Bank Transfer Supported**、**Official Invoices Available**、**Custom Service Agreements** も。
  手順は [エンタープライズ チームガイド](/docs/reference/enterprise-guide)。
- 購読ページのチームカードは *“Flexible quota & sub-key mgmt”* と書き、
  [hi@qcode.cc](mailto:hi@qcode.cc) への連絡を案内します。
- コンソール側はチームへの**入り口**だけ：ウェルカムダイアログの **Team / Enterprise** と、
  Max X20 チーム版の *Team Features* ダイアログ（“Multi-account management for team collaboration”、
  “Customized service…”、“Dedicated technical support…”）。
- **リセラー**は別途 Partner Dashboard でサブキーを発行できます。
  [Partner Open API Guide](/docs/reference/partner-api) をどうぞ。

## Open API アクセストークン

**Open API** カードの説明：*“Use an access token to query your API keys' expiry and daily usage
programmatically.”* **Manage token** で `/dashboard/openapi-token` を開くと、生成・リセット・取消ができます：

```bash
curl -H "Authorization: Bearer qot_..." \
  https://qcode.cc/api/v1/openapi/keys
```

- そのページには読み取り専用 2 エンドポイント：有効な全 Key の期限と使用量、アカウント単位の使用量サマリ。
- トークンは**一度だけ**表示：*“Your new token (shown only once) — copy it now”*、そして *“We store only a
  hash — if you lose it, reset to get a new one (the old token stops working immediately).”*
- リセットも取消も確認付き。取消後は新しいトークンを作るまで Open API アクセスは無効です。

## サポートと注文まわり

- コンソールの **Support** 表記：*“Weekdays 10:00 - 21:00 (UTC+8) online response”*、時間外は
  *“checked intermittently, replies may be delayed”*、そして *“Email available anytime: hi@qcode.cc”*。
- ライブサポートは右下の **Contact Us** ボタン（Telegram またはメール）。
- **Request Urgent Processing** は待ち理由を説明しています：上流アカウントの新規開設は申請と設定に
  1〜2 時間かかります。
- Quick Links には **Usage Help**（ナレッジベース）と **Common Error Codes** も。症状別の対処は
  [トラブルシューティングガイド](/docs/reference/troubleshooting)、
  [エラーコードリファレンス](/docs/reference/errors) へ。

## 関連ページ

- [支払い方法の概要](/docs/reference/payment-methods) —— recharge ページのチャネル一覧
- [課金説明](/docs/reference/billing) —— 使用額がどう請求になるか
- [エンドポイントと API パス](/docs/getting-started/endpoints-and-api-paths) —— アドレスとパスプレフィックス
- [環境変数](/docs/getting-started/environment) —— どこに設定するか
- [ワンクリック設定スクリプト](/docs/getting-started/one-click-install) —— コンソールのコマンドの実態
- [Subscriptions vs API Keys vs QCode Keys](/docs/reference/subscription-vs-api-key)
- [エンタープライズ チームガイド](/docs/reference/enterprise-guide) —— サブキーと請求書
- [Partner Open API Guide](/docs/reference/partner-api)
- [FAQ](/docs/reference/faq)