Claude Code から使う

通常はセットアップが Claude Code を接続します。このページは、接続されていなかった 場合の手順と、あとから制御する方法です。

環境変数の設定も、設定ファイルの編集も、エイリアスも必要ありません。Waired が Claude Code のマシン全体設定を書き込むことで、Claude Code が自分のモデルと話すように なります。Windows / macOS / Linux で同じ仕組みです。

claude.ai のサブスクリプションはそのままです

認証情報は一切書き込まれないため、既存の Claude Code のサインインとサブスクリプションの 扱いはこれまでどおり動きます。Waired が変えるのは「リクエストの行き先」であって、 「誰としてサインインしているか」ではありません。

接続する

1. 連携を設定します。

   waired link claude-code

2. ルーティングを有効にします。ルーティングの質問に「いいえ」と答えた、ブラウザで Claude Code をつながなかった、--skip-claude-proxy を付けてインストールした、 のいずれでもなければ セットアップ時に済んでいます。この手順は、あとから 有効化したいときのためのものです。

   macOS / Linux

   sudo waired claude enable

   Windows

   管理者プロンプトから:

   waired claude enable

3. いつもどおり Claude Code を起動します。

   claude

どの AI が答えた？

フッターに毎回表示されます。

screenshot pendingClaude Code のフッターに表示された Waired のステータス行。現在のルートと、直前の応答を返したローカルモデル名。public/img/claude-code-statusline.png

表示	意味
⚡ waired: on Waired (qwen3-8b-instruct)	自分のハードウェアが、そのモデルで応答
→ waired: Anthropic	本来の Anthropic API が応答
✕ waired: agent down	このパソコンで Waired が動いていない

クラウドにフォールバックしたターンの後には、その旨が 1 行表示されます。 黙って転送されることはありません。

ステータス行が出ない場合

プロジェクト直下の .claude/settings.json が、Waired の設定より優先されています。 プロジェクト内で waired claude status を実行すると、優先されているファイル名と、 自分のステータス行スクリプトに貼れる 1 行が表示されます。Waired がプロジェクトの ファイルを書き換えることはありません。

送り先を切り替える

セッション中に、再起動なしで切り替えられます。

/waired-route waired      # 自分の AI だけ。クラウドには送らない
/waired-route anthropic   # 本来の Anthropic API
/waired-route auto        # 既定。自分を優先し、必要ならフォールバック

次のメッセージから反映されます。ターミナルからも同じことができます。

waired claude route                               # 今の状態を表示
waired claude route anthropic --subagents waired  # 本体はクラウド、サブエージェントは自分

--subagents は知っておく価値があります。Claude Code のサブエージェントは大量の ファイル読み取りを担当するので、本体はクラウドを使いつつサブエージェントだけ自分の ハードウェアに残す、という中間案が実際に有効です （→ プライバシー）。

Waired アイコン → Claude Code からも変更でき、本体とサブエージェントを別々に 選べます。

「waired」は自分のネットワークであって、このパソコンとは限りません

実際にどのマシンが応答するかは waired worker が決めます — ほかの端末を追加するを参照してください。

よく驚かれること

Claude Code には Anthropic のモデル名が出たままです。 Opus や Sonnet などが これまでどおり選べます。Waired が処理する場合は、セッションで何が選ばれていても そのデバイスで動いているローカルモデルが応答します。Anthropic のモデル名が 意味を持つのは、実際にクラウドへ送られたときだけです。

長いセッションは要約されます。 ローカルのモデルは一度に保持できる会話量が 少ないため、Claude Code が古いターンを要約して収めます。これは失敗ではなく、 セッションが生き延びているということです （→ 長い Claude Code のセッションが要約される）。

失敗しても止まらず、クラウドに回ります。 一時停止中・ダウンロード中・非対応の リクエスト形式などで応答できないとき、Claude Code は本来の Anthropic API を使って ターンを完了させます。転送されるくらいならエラーを見たい場合は、waired ルートを 選んでください。

1 台をほかの端末と共有する

Web 画面のマシンのページで、ほかの端末からの使われ方を 調整できます。

• Serve main / subagents — 2 つのスイッチ。main を切れば、遅いマシンを サブエージェントの並列作業専用にできます。これはほかのマシンから来るリクエストに 対する設定で、そのマシン自身の Claude Code は常に動きます。
• Max concurrent requests — 同時に処理する数。並列を増やすとメモリを余分に使い、 1 件あたりも遅くなるため、推奨上限が表示され、超える前に警告が出ます。

確認と解除

waired claude status

ルーティングの有効・無効と、設定ファイルの場所を表示します。

Linux	/etc/claude-code/managed-settings.json
macOS	/Library/Application Support/ClaudeCode/managed-settings.json
Windows	C:\Program Files\ClaudeCode\managed-settings.json

Claude Code を Waired 経由にするのをやめる（Claude Code は通常動作に戻ります）:

sudo waired claude disable    # Windows は管理者プロンプトから

連携ファイルごと削除する:

waired unlink claude-code

Claude Code がクラウドを使い続ける直すための 2 つのコマンド。

OpenCode から使うOpenCode 版。