ドキュメント

インストール、ショートカット、同期、クリップボード、ポート、AI 利用量、アップデート。

インストール

いちばん手早い方法（どのディストリビューションでも）：

curl -fsSL https://quickdesk.click/install.sh | bash

お使いのシステムに合った .deb、.rpm、AppImage を選び、SHA-256 を確認してインストールします（スクリプトを読む）。またはダウンロードページからパッケージを取得し、ダウンロードしたファイルを次のようにインストールします：

  • Ubuntu、Debian、Mint、Pop!_OS： sudo apt install ~/Downloads/QuickDesk_<version>_amd64.deb
  • Fedora、openSUSE： sudo dnf install ~/Downloads/QuickDesk-<version>-1.x86_64.rpm
  • その他： AppImage に実行権限を付けて起動します。FUSE 2（libfuse2、Ubuntu 24.04 では libfuse2t64）が必要です。

QuickDesk にはここ数年の x86_64 システム（glibc 2.34 以降）が必要です。GNOME で最もよく動き、Wayland と X11 のどちらにも対応します。

Windows 10 と 11（64 ビット）： PowerShell で irm https://quickdesk.click/install.ps1 | iex を実行するか、ダウンロードページからインストーラーを入手します。管理者権限なしで、ご自分のユーザーにのみインストールされます。インストーラーにはまだ署名がないため、Windows が「PC が保護されました」と表示することがあります。詳細情報 → 実行を選んでください。Windows でのショートカットは Win Alt N / V / P で、QuickDesk はタスクトレイに常駐し、自動貼り付けは設定不要です。Runtimes タブは mise、rustup、uv を通じて動きます（言語のバージョンを参照）。

初回起動時にはようこそ画面がショートカットを案内し、2 つのオプションを提示します：ログイン時に起動（クリップボード履歴と AI リングを常に動かすのに必要）と即時貼り付け（自動貼り付けを参照）。その後、QuickDesk はトップバーに常駐します。

macOS

まだ開発中です。Mac 版は使えますが、まだ新しいため、すべての Mac ですべてを試せてはいません。自動貼り付けとショートカットは改良を続けています。うまく動かないことがあればお知らせください。

QuickDesk は Apple シリコン（M1 以降）の macOS 11 以降で動きます。ターミナルで curl -fsSL https://quickdesk.click/install.sh | bash を実行すると、QuickDesk.app を「アプリケーション」に置いて起動します。またはダウンロードページから .dmg を入手し、QuickDesk を「アプリケーション」へドラッグします。

初めて開くとき。QuickDesk はまだ Apple の公証を受けていないため、.dmg をブラウザでダウンロードした場合、macOS は初回起動時に「マルウェアが含まれていないことを Apple は検証できません」と表示して止めます。アプリには何の問題もありません。次のどちらかを一度行ってください（コマンドでインストールした場合は警告は出ません）：

  1. 「アプリケーション」から QuickDesk を開き、macOS が警告したら完了をクリックします。次に「システム設定 → プライバシーとセキュリティ」を開いて「セキュリティ」までスクロールし、「Mac を保護するために “QuickDesk” がブロックされました」の横のこのまま開くをクリックし、パスワードまたは Touch ID で確認して開くをクリックします。macOS 14 以前では、QuickDesk を Control キーを押しながらクリック → 開く → 開く でも開けます。
  2. またはターミナルで xattr -dr com.apple.quarantine /Applications/QuickDesk.app を実行してから、いつもどおり QuickDesk を開きます。

ダウンロードページにも同じ手順があります。

  • QuickDesk はメニューバーに常駐し、Dock にアイコンは出ません。ポップアップは今いる操作スペースに開き、フルスクリーンのアプリの上にも表示されます。
  • ショートカットは ⌃ ⌥ N / V / P（Control + Option）です。⌘⌥V と ⌘⌥N は Finder が使っています。
  • 自動貼り付けは使っていたアプリで ⌘V を押します。macOS がこれを許すのは、「システム設定 → プライバシーとセキュリティ → アクセシビリティ」に QuickDesk を追加したあとだけです。初めて項目を選ぶときに macOS が尋ねます。それまでは項目がコピーされるので、ご自分で ⌘V を押してください。許可の状態は Settings → Auto-paste で確認できます。
  • 新しい macOS では、他のアプリがコピーした内容を QuickDesk が読み取ってよいか尋ねられることがあります。「許可」を選ばないと、クリップボード履歴は空のままです。
  • Claude の利用量：Mac では Claude Code がログイン情報をキーチェーンに保存します。AI タブがそこから読み取ることを提案し、macOS が一度だけ尋ねます（常に許可を選びます）。他の OS と同じく、ログイン情報は読み取るだけで、api.anthropic.com にのみ送られます。
  • アプリはアドホック署名のため、アップデート後に macOS がアクセシビリティとキーチェーンの許可を再び求めることがあります。自動貼り付けが動かなくなったら、アクセシビリティの一覧から QuickDesk を削除して追加し直してください。
  • Runtimes タブは Linux と同じように、ログインシェル（zsh：~/.zshrc）で動きます。Homebrew でインストールしたものは表示されますが、変更はしません。

アンインストール：メニューバーから QuickDesk を終了し、「アプリケーション」からゴミ箱へ移動します。データは ~/Library/Application Support/click.quickdesk に、そのフォルダーを削除するまで残ります。

ショートカット

ショートカット開くもの
Super Alt Nメモ
Super Alt Vクリップボード履歴のポップアップ
Super Alt Pポート
未設定クイックメモのポップアップ（Settings で設定）

ウィンドウが開いているときにもう一度ショートカットを押すと閉じます。どれも Settings → Hotkeys で変更でき、組み合わせがすでに使われていれば QuickDesk が警告します。

GNOME ではショートカットが設定 → キーボード → カスタムショートカットに追加され、QuickDesk の終了時に削除されるので、Wayland でも動きます。他のデスクトップでは、キーボード設定で quickdesk toggle notes、quickdesk toggle clipboard、quickdesk toggle ports、quickdesk toggle quick-note をキーに割り当ててください。

なぜ Super + Alt？Unikey や Bamboo などのベトナム語入力メソッドは、テキスト欄で入力中に Super + Shift + 文字を横取りしてしまいますが、Alt を使った組み合わせは影響を受けません。

メモ

メモはリッチエディター付きの Markdown です：見出し、太字と斜体、リスト、チェックリスト、引用、コードブロック。Ctrl N で新しいメモ、Ctrl S で保存、Ctrl F で検索します。検索はアクセント記号を区別しないので、tieng viet で「tiếng Việt」が見つかります。

星を付けるとメモが上に固定されます。削除の前には確認があり、数秒間は元に戻せます。

コンピューター間でメモを同期

メモは QuickDesk Cloud を通じて同期されます。アカウントやメールは不要です。1 台のコンピューターが同期コードを受け取り、他のコンピューターはそれで参加します。同期されるのはメモだけで、クリップボード履歴と設定はそれぞれのコンピューターに残ります。

設定する

  1. 1 台目のコンピューターで：Settings → Sync → Turn on sync を選び、パスフレーズ（8 文字以上）を決めます。
  2. QuickDesk が同期コード（QD1-…）と復旧キーを表示します。復旧キーは安全な場所に保管してください。表示されるのは一度だけです。
  3. 他のすべてのコンピューターで：Settings → Sync → I have a sync code を選び、コードと同じパスフレーズ（または復旧キー）を入力します。

同期コードは、Settings → Sync の Show sync code でいつでも再表示できます。

同期のタイミング

  • メモを編集した数秒後と、QuickDesk のウィンドウを開いたとき。
  • それ以外は、ウィンドウが開いている間は 1 分ごと、トレイにあるときは 5 分ごとに変更を確認します。確認は小さなリクエスト 1 つだけで、メモが送られるのは何かが変わったときだけです。
  • Sync now ですぐに確認します。オフラインでの編集は、オンラインに戻ったときに送られます。
  • 同じメモを 2 台で同時に変更した場合は両方のバージョンが残ります。新しい方がそのまま残り、もう一方はその隣にコピーとして置かれます。削除より編集が優先されます。

プライバシーと鍵

  • メモはアップロード前にコンピューター上で暗号化されます（XChaCha20-Poly1305、鍵はパスフレーズから Argon2id で導出）。QuickDesk Cloud はランダムなアカウント ID のもとに暗号文を保持するだけで、メモを読むことはできません。
  • データにたどり着くための同期コードと、復号するためのパスフレーズの両方が必要です。同期コードはパスワードと同じように扱ってください。同期コードだけでも、同期済みのメモを削除されるおそれがあります。
  • パスフレーズを忘れたら、代わりに復旧キーを入力します。どちらもなければ QuickDesk Cloud のコピーは開けませんが、各コンピューター上のメモはそのままです。
  • QuickDesk が Unlock sync を求めたら（たとえばシステムのキーリングがリセットされたあと）、もう一度パスフレーズを入力してください。

同期をオフにする

Turn off sync… はそのコンピューターでの同期を止め、メモはそのまま残します。Also delete my notes from QuickDesk Cloud にチェックを入れると、すべてのコンピューターの同期済みコピーを削除します。

同期コードごとの上限：256 MB と 20,000 個の保存オブジェクト。メモには十分すぎる量です。

クリップボード履歴

コピーしたものはすべて保存されます：テキスト、画像（スクリーンショット）、ファイルマネージャーでコピーしたファイル。Super Alt V でポップアップを開き、入力して検索し、テキスト・画像・ファイルで絞り込み、Enter で使っていたアプリに貼り付けます。Ctrl Enter はコピーのみ、Ctrl P はピン留め、Del は削除です。

  • 履歴はこのコンピューターに残り、同期はされません。
  • パスワードマネージャーが秘密として印を付けたコピーは保存されません。機密情報をコピーする前に、保存を一時停止できます（15 分、1 時間、またはオンに戻すまで。Clipboard タブかトレイメニューから）。
  • QuickDesk は最新の 1,000 件を保持し、ピン留めしたものは永久に保持します。テキストは 1 MB まで、画像は 1 枚 10 MB、合計 200 MB までです。
  • Clipboard タブの Clear… は、ピン留めした項目以外をすべて削除します。

自動貼り付け

項目を選ぶと、QuickDesk は使っていたアプリに戻って Shift Insert を押します。これはターミナルでも動きます。方法は Settings → Auto-paste で選べます：

  • Desktop portal（デフォルト）：GNOME が一度だけ許可を求め、貼り付け中はリモート操作のインジケーターを表示します。
  • Instant (virtual keyboard)：確認もインジケーターもありません。有効にするときに一度だけ管理者パスワードを入力し、あなたの権限で動くプログラムが仮想キーボードを作れるようにします（Steam がコントローラーに使うのと同じ権限です）。

Clipboard タブで自動貼り付けをオフにするとコピーだけになるので、ご自分で Ctrl V を押してください。

ポート

Super Alt P で、待ち受け中のすべての TCP ポート（IPv4 と IPv6）を、プロセス、完全なコマンドライン、ユーザーとともに一覧表示し、2 秒ごとに更新します。ポート、PID、プロセス名、コンテナ名で絞り込めます。

  • Open はブラウザで http://localhost:<port> を開きます。Copy PID と Copy cmd はそれぞれをコピーします。
  • Kill はまず確認し、プロセスを穏やかに停止します。終了しないときだけ強制終了を提案します。
  • Docker が公開しているポートにはコンテナとイメージが表示され、Stop は docker-proxy を強制終了する代わりにコンテナを停止します。
  • 他のユーザー（システムサービス）のプロセスは非表示として示されます。詳しく見るには root 権限が必要です。

言語のバージョン（Runtimes）

Runtimes タブでは、このコンピューターのプログラミング言語（Node.js、Python、Rust、Go、Java、Ruby、Deno、Bun、PHP）のバージョンを管理します。新しいターミナルで動くバージョンと、その出どころを表示します。QuickDesk はログインシェルに問い合わせるので、表示されるのはデスクトップから見えるものではなく、~/.bashrc や ~/.zshrc を読み込んだあとの結果です。

  • nvm（Node.js）、rustup（Rust）、uv（Python）、mise（Go、Java、Ruby、Deno、Bun、PHP など）でインストールした言語は変更できます。Install version… はツールが提供するバージョンから選び（rustup は入力したチャンネルかバージョン）、Make default は新しいターミナルで使うものを設定し、Uninstall はバージョンを削除して容量を空けます。デフォルトは削除できないので、先に別のものをデフォルトにしてください。
  • インストールは進捗バー付きでバックグラウンドで実行され、キャンセルもできます。一度に実行される変更は 1 つだけです。バージョン一覧はデフォルトで各系列の最新リリースを表示します。LTS やすべてに切り替えたり、入力して絞り込んだりできます。
  • インストール済みの系列に新しいリリースが出ると（22.23.3 に対する Node 22.24.1、3.13.7 に対する Python 3.13.9）、そのバージョンに ↑ 22.24.1 が表示されます。クリックひとつでインストールし、古い方がデフォルトだった場合は新しい方をデフォルトにします。古いバージョンはアンインストールするまで残ります。Rust のチャンネルはその場で更新されます。rustup に新しい stable があると stable に ↑ 1.93.0 が表示され、クリックで rustup update stable を実行します。
  • Apply right away in open terminals（タブの上部）を使うと、変更がすでに開いているターミナルにも次のプロンプトから反映されます。QuickDesk はシェルファイルに 1 行追加し、小さなプロンプトフック（~/.config/quickdesk/shell/hook.sh）を読み込みます。このフックは、QuickDesk がバージョンを変えたあとにシェルがコマンドを探し直すようにし、プロジェクトに cd したときに Node がいちばん近い .nvmrc に従うようにします（なければ選んだデフォルトに。手動の nvm use はフォルダーかデフォルトを変えるまで有効です）。これを使わない場合でも Rust の変更はすぐに反映され、Python と mise の変更は新しいターミナル（または開いているターミナルで hash -r のあと）に、nvm の変更は新しいターミナルにだけ反映されます。
  • Set for a project… は、選んだフォルダーにツール自身のファイルを書き込みます：.nvmrc、rust-toolchain.toml、.python-version、mise.toml（mise は記載済みの他のツールを残します）。
  • バージョンマネージャーのない言語（たとえば apt で入れた Go）には Install mise… が表示されます。QuickDesk は最新の mise を github.com/jdx/mise からダウンロードし、リリースの SHA-256 と照合して ~/.local/bin に置きます。バージョンをデフォルトにしたあと、Fix PATH… がシェルで mise を有効にする行を提案します。
  • 新しいターミナルがデフォルトとは別のものを実行してしまう場合（たとえばシステムの python3 が PATH で先に来る場合）、カードがその理由を示し、Fix PATH… が追加する行をそのまま表示します。あなたが同意したときだけ、QuickDesk はそれを印の付いたブロックとしてシェルファイルの末尾に追加し、隣にバックアップを残します。ブロックは同じ場所から削除できます。
  • PATH の修正とプロンプトフックは bash（~/.bashrc）と zsh（~/.zshrc）向けです。fish にはまだ対応していません。
  • まだコンピューターにない言語は Add a language に一覧されます。選ぶと、必要なら mise をインストールしてからバージョンを選べます。
  • Windows：QuickDesk は新しいターミナルで何が動くかを PowerShell に問い合わせ、mise（%LOCALAPPDATA%\mise\bin にインストール）、rustup、uv を通じて動きます。nvm-windows と fnm は表示されますが変更はせず、ストアの python.exe のプレースホルダーは無視します。Fix PATH… は、ツールのフォルダー（mise の場合は shims）を、管理者権限なしでアカウントの PATH（設定 → 環境変数 にあるもの）の先頭に追加します。以前の値は ~\.config\quickdesk\path に保存され、同じパネルからフォルダーを再び取り除けます。新しいターミナルがそれを読み込み、以後はデフォルトの変更がすぐに反映されます。Windows では「Apply right away」は不要なので表示されません。
  • システムがインストールしたもの（apt、dnf）は変更も削除もしません。QuickDesk が sudo を実行することはありません。対応していないツール（fnm、volta、pyenv、SDKMAN…）で管理されている言語は読み取り専用で表示します。

AI 利用量

トップバーのリングが、AI の利用上限をどれだけ使ったかを緑・琥珀・赤で示します。そのメニューには追跡中のツールが表示され、上限ごとのバーとリセット時刻が並びます。AI タブにはすべてのツールが表示されます。

  • Claude Code：QuickDesk は Claude Code がこのコンピューターに保存済みのログイン情報を読み取り、最大 5 分に 1 回、Anthropic に利用量を問い合わせます。トークンは読み取るだけで、保存も更新もせず、Anthropic 以外のどこにも送りません。
  • Codex：Codex が ~/.codex に残すセッションログから読み取ります。
  • Gemini（Antigravity）：割合を報告しないため、QuickDesk はそのログから最後に割り当てを使い切った時刻を表示します。

追跡するツールと上限は Track で選べます。リングは AI タブで非表示にできます。

アップデート

QuickDesk は起動 30 秒後に新しいバージョンを確認し、その後は 6 時間ごとに確認します。新しいバージョンが出ると、メインウィンドウのバナーとトレイメニューの先頭の項目が What’s New とともに知らせます。Update Now をクリックするまで何もインストールされません。

アップデートはインストール前に必ず QuickDesk の署名鍵で検証されます。.deb や .rpm は管理者パスワードを求め、AppImage は自分自身を置き換えます。その後 QuickDesk が再起動し、変更点を表示します。自動確認をオフにしたり手動で確認したりするには Settings → Updates を使います。

アンインストール

  1. Settings で Start QuickDesk when I log in をオフにし、トレイから終了します。
  2. パッケージを削除します：sudo apt remove quick-desk（Debian/Ubuntu）または sudo dnf remove QuickDesk（Fedora）、または AppImage を削除します。
  3. データは ~/.local/share/click.quickdesk に、そのフォルダーを削除するまで残ります。

Windows：設定 → アプリ → インストールされているアプリ → QuickDesk → アンインストール。データは %APPDATA%\click.quickdesk に、そのフォルダーを削除するまで残ります。

パッケージを削除すると、有効にしていた即時貼り付けの権限も取り除かれます。

トラブルシューティング

  • ショートカットが反応しない：設定 → キーボード → カスタムショートカットで衝突がないか確認するか、Settings → Hotkeys で別の組み合わせを選びます。
  • 自動貼り付けで何も入力されない：使っていたアプリにまだフォーカスがあるか確認し、Settings → Auto-paste で方法を切り替えます。項目は必ずコピーされるので、Ctrl V で貼り付けられます。
  • ログ：~/.local/share/click.quickdesk/logs/。問題を報告するときに添付してください。

まだ解決しませんか？ GitHub で質問する · プライバシー