Claude Code Remote Controlが突然使えなくなった!原因はたった1つの環境変数だった
ニュース(事実)
Claude Code の Remote Control 機能を使おうとしたら、こんなエラーが出た。
Error: Remote Control is not yet enabled for your account.
Max プランなのに「お前のアカウントではまだ使えないよ」と言われる。
前まで普通に使えてたのに…。
これはつまり、環境変数ひとつで大事な機能が丸ごと消えちゃうという落とし穴の話
3行まとめ
- 本質:
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFICがRemote Controlの通信まで止めてしまう(筆者の実環境で確認) - 構造: Remote ControlはAnthropicサーバーとの常時通信が必要で、この通信が「非必須」扱いになっている可能性が高い
- これから:
/configで全セッション自動有効化すれば、もう毎回コマンドを打つ必要なし
初心者向け:まずここだけ読めばOK
「Remote Control is not yet enabled for your account」と表示されて困っている人は、ターミナルで以下を実行してみてください。
grep -r "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC" ~/.claude/settings.json ~/.zshrc ~/.bashrc 2>/dev/null
ヒットしたら、それが原因の可能性が高い。該当行を削除すれば直る。
詳しい手順は「解決方法」セクションを参照。
用語の整理
- Remote Control: ローカルPCで動いているClaude Codeを、スマホやiPad・別のPCのブラウザから操作できる機能。コードはクラウドに行かず、手元で動き続ける。執筆時点(2026年3月)ではMaxプランで利用可能、Proプランは近日対応予定とされている
- CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC: Claude Codeの「必須でない通信」を全部止める環境変数。自動アップデート確認やテレメトリを止めたいときに使う。ただし、何が「非必須」に分類されるかは公式に詳細が公開されていない
詳細
そもそも何が起きたのか
ある日、いつも通り claude remote-control を実行したら突然エラー。
claude auth status で確認すると Max プランで正しくログインしている。
バージョンも v2.1.63 で最新。
GitHubのIssueを調べてみたら、同じ症状の報告が見つかった。
そちらでは「Maxプランなのに Claude API と表示される認識不全」が疑われていたけど、根本原因は特定されていなかった。
犯人は settings.json の中にいた
/config を開いてみたら、こんな表示が。
Auto-update channel disabled
(CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC set)
あっ、これだ (´ ˘ `)
以前、テレメトリや自動アップデートチェックを止めたくて settings.json にこの環境変数を入れていた。
{
"env": {
"CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
}
}
Remote Control は Anthropic のサーバーに「セッションを登録する」通信を行う。
公式ドキュメントには明記されていないが、筆者の環境ではこの環境変数を削除した直後に Remote Control が復活した。
この通信が「非必須トラフィック」に含まれている可能性が極めて高い。
解決方法
やることは2つだけ。
1. 環境変数を削除する
~/.claude/settings.json を開いて、env の中に CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC があれば、その行を削除する(編集前にファイルのバックアップを取っておくと安心)。
削除前:
{
"env": {
"CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
"他の設定": "..."
}
}
削除後:
{
"env": {
"他の設定": "..."
}
}
settings.json 以外にも、.zshrc や .bashrc に export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1 と書いている場合がある。心当たりがあればそちらも確認してほしい。
これだけで /remote-control が復活する :)
2. 全セッションで自動有効化する(任意だけどおすすめ)
環境変数を削除した状態で Claude Code を起動し直し、チャット欄に /config と入力する。
設定一覧の中に「Enable Remote Control for all sessions」という項目が出現するので、これを true に設定する。
こうしておけば、毎回 /remote-control を打たなくても全セッションで自動的にRemote Controlが有効になる。
Enable Remote Control for all sessions true
Remote Control vs Remote Environment、何が違う?
Claude Code には似た名前の機能が2つある。混乱しやすいのでサクッと整理。
| 機能 | 実行場所 | 用途 |
|---|---|---|
Remote Control (/remote-control) |
ローカルPC | 手元のセッションをスマホ・iPadから操作 |
Remote Environment (/remote-env, --remote) |
Anthropicクラウド | クラウド上でタスクを実行 |
Remote Control はローカルの環境(ファイルシステム、MCPサーバー、ツール)をそのまま使える。
Remote Environment はクラウド上にリポジトリをクローンして実行するので、ローカルの設定は使えない。
「iPadからいつものセッションを操作したい」→ Remote Control
「外出先からタスクを投げたい」→ Remote Environment
影響:誰に効くか
Claude Code のパワーユーザー
settings.json をカスタマイズしている人ほど、この罠にハマりやすい。
特に CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC はプライバシー意識の高いユーザーが設定しがちなので、Remote Control を使いたい人と層がかぶる。
Agent Teams を使っている人
tmux モードで Agent Teams を動かしつつ、外出先からモニタリングしたい場面はけっこうある。
Remote Control が使えないとターミナルの前に張り付くしかないので、地味に大きい問題だった。
今日の1アクション
~/.claude/settings.json に CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC が入っていないか、今すぐチェックしてみてください。
入っていて Remote Control も使いたいなら、その行を消すだけで世界が変わります :)
関連記事
- Claude Code Remote Control 公式ドキュメント
- Claude Code on the web 公式ドキュメント
- Issue #29764: Remote Control unavailable
筆者コメント
これ、実際にハマってめちゃくちゃ焦ったんですよね。
Max プランなのに「not yet enabled」って言われると「え、機能なくなった?」ってなるじゃないですか。
原因がわかってみれば「あぁ、そこブロックしちゃうんだ…」って話なんですけど、エラーメッセージがミスリーディングすぎる。
「DISABLE_NONESSENTIAL_TRAFFIC が Remote Control をブロックしています」って教えてくれたらいいのに…って思いました。