claude importが使えない「not yet available in this build」の意味と対処
「claude import is not yet available in this build」の原因を4つに切り分け、フィーチャーフラグが止まる条件と手動移行の代替手順をまとめます。
claude importが使えない原因は4つに絞れる
claude import を実行すると、次のメッセージが出てコマンドが止まることがあります。
`claude import` is not yet available in this build. Run `claude` and use /mcp or edit ~/.claude/settings.json directly.バグではありません。claude import はAnthropicから取得するフィーチャーフラグ(feature flag、機能の有効・無効を配信で切り替える仕組み)でオンになる機能で、そのフラグが手元に無いときにこの表示になります。
エラーの2つのタイプ
一時的に出る
フラグをまだ保存していない状態です。インストール直後やアップグレード直後の最初のセッションが典型で、一度 claude を起動すれば次回から使えます。
恒常的に出る
フラグを取得しない構成で動いている状態です。サードパーティプロバイダー経由、取得を止める環境変数、Claude appsゲートウェイのどれかが該当し、バージョンを上げても変わりません。
v2.1.289の claude import --help は、取り込み元として codex・gemini・cursor の3つを挙げます。
Usage: claude import [options] [source]
Import config from another AI coding agent into Claude Code
Arguments:
source Which agent to import from (codex, gemini, cursor)
Options:
--dry-run Show what would be imported without writing anything
-h, --help Display help for command
--yes Skip the interactive picker. On headless surfaces, pass
--yes=<digest> from the `/import` preview.エラーの意味 — 取り込み機能の入口がフラグ次第で閉じる
claude import はCodexやGemini CLI、Cursorなど他のコーディングエージェントの設定をClaude Codeへ取り込むサブコマンドです。v2.1.213以降で使え、Cursorからの取り込みはv2.1.265以降が条件です。対象は指示ファイル・MCPサーバー・コマンド・サブエージェント・Skillsなどです。
対話セッションの /import と同じ処理を呼ぶ入口で、--dry-run と --yes も共通です。-p を付けた非対話モードの /import は、見つかった項目の一覧と取り込みを確定するコマンドだけを出し、書き込みはしません。確定は、プレビューに出る --yes=<digest> を付けて claude import を実行する流れです。/init が他ツールの設定を見つけたときに、取り込みを提案する導線もあります。
取得したフラグはディスクに保存され、次のセッション以降も使われます。エラーが出ているのは、保存された値がまだ無いか、そもそも取得しない構成だということです。
使えるかどうかはバージョン番号ではなく、フラグの取得結果で決まります。最新版でもフラグを取得しない構成なら、同じエラーが出ます。
原因別の切り分けと対処
①保存されたフラグがまだ無い
インストール後、またはこの機能を含むバージョンへの更新後の最初のセッションでは、フラグ依存の機能が欠けていることがあります。そのセッション中にフラグを取得して保存するため、claude を通常どおり起動して一度終了すれば、次の起動から使えます。再インストールは要りません。この最初のセッションは、開始時の権限モードも後続のセッションと異なることがあります。フラグが届く前に開始モードが決まるためで、claude -p やVS Code拡張でも、フラグの取得を待たないことがあります。
claude
# セッションが立ち上がったのを確認してから終了(Ctrl+D または /exit)
claude import codex --dry-run「最初のセッション」が毎回続く構成もあります。CIコンテナのように実行のたびに保存済みフラグが消える環境がその1つです。もう1つは、ANTHROPIC_AUTH_TOKEN だけで認証し、ANTHROPIC_BASE_URL をAnthropic以外のホスト(LLMゲートウェイなど)に向けている構成です。フラグを取りに行くための資格情報が無いため、2回目以降のセッションでも保存されません。この2つでは、待っても直らないので手動移行(後述)に切り替えます。
②サードパーティプロバイダーを使っている
Amazon Bedrock、Google CloudのAgent Platform、Microsoft Foundry、Claude Platform on AWSのセッションは、フラグを取得しません。公式のコマンド一覧も、この4つでは claude import と /import が使えないと明記しています。
サードパーティプロバイダーでは、③の変数を自分で設定していなくても、取得は止まります。テレメトリも既定で無効になります。
ホスト側のプラットフォームが CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST を設定してClaude Codeを組み込んでいる場合だけは例外です。この変数が設定されていれば、サードパーティプロバイダーでもフラグを取得します。
③環境変数でネットワーク取得を止めている
DISABLE_TELEMETRY、DO_NOT_TRACK、DISABLE_GROWTHBOOK、CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC のいずれかを有効にすると、フラグの取得も止まります。CI環境やセキュリティポリシーでこれらを既定にしているチームは、意図せず対象になっていないか確認してください。CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC は、フラグ取得のほかに自動更新・エラー報告・/feedback・リリースノートの取得も止めます。
4つの変数は、値の解釈が揃っていません。環境変数リファレンスの記述を並べると、次のとおりです。
| 変数 | フラグ取得が止まる値 | 0 や false を入れたとき |
|---|---|---|
DISABLE_TELEMETRY | フラグ取得が止まる値空でない任意の値 | 0 や false を入れたとき止まる(オフにする意味ではない) |
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC | フラグ取得が止まる値空でない任意の値 | 0 や false を入れたとき止まる(同上) |
DO_NOT_TRACK | フラグ取得が止まる値1 | 0 や false を入れたとき止まらない |
DISABLE_GROWTHBOOK | フラグ取得が止まる値1 または true | 0 や false を入れたとき止まらない |
DISABLE_TELEMETRY=0 や CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=false は、無効化の取り消しになりません。取得を戻したいときは、変数ごと unset します。
④Claude appsゲートウェイ経由のセッション
Claude appsゲートウェイ越しのセッションでも、CLIはフラグの取得をスキップします。ゲートウェイのドキュメントは、claude import と /import を含むフラグ依存の機能がこの構成では使えないと書いています。
自分がどの原因に当てはまるか確認する
上から順に確かめると、絞り込みが早く済みます。
切り分けの順番
- 1
サードパーティプロバイダーか、ゲートウェイか
プロバイダー切り替えの変数が設定されていないかを見ます。ゲートウェイ経由なら、組織の接続設定を確認します。
env | grep -E "CLAUDE_CODE_USE_(BEDROCK|VERTEX|FOUNDRY|ANTHROPIC_AWS|MANTLE)"何か表示されたら②、組織の案内でゲートウェイ越しなら④です。どちらも手動移行へ進みます。
- 2
取得を止める環境変数があるか
env | grep -E "DISABLE_TELEMETRY|DO_NOT_TRACK|DISABLE_GROWTHBOOK|CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC"該当があれば③です。
.zshrcや.bashrc、CIの変数設定に紛れていることが多く、unsetしたうえで新しいシェルから再試行すると切り分けられます。 - 3
保存済みフラグが無い環境か
どれにも当てはまらなければ①です。普通にセッションを一度開いてから再実行します。CIや毎回作り直すコンテナでは毎回①に戻るので、その環境では最初から手動移行にします。
組織がmanaged settingsやシェルプロファイルの配布で同じ変数を強制している場合は、個人の環境が空でも③に当たります。/status は、設定インターフェースのStatusタブにバージョン・モデル・アカウント・接続状況を表示するコマンドです。環境変数の配布元までは分からないので、組織の管理者に配布内容を聞くのが確実です。
フラグ取得が止まると他にも使えなくなる機能がある
claude import は、フラグ取得に頼る機能の1つです。環境変数リファレンスは、取得なしのセッションで次の機能が使えなくなると列挙しています。複数の症状が同時に出ているなら、②③④のいずれかを疑う材料になります。
| 影響を受ける機能 | 取得なしのセッションで |
|---|---|
claude import / /import | 取得なしのセッションで使えない(本記事のエラー) |
| Remote Control | 取得なしのセッションで使えない(DISABLE_TELEMETRY・DO_NOT_TRACK の場合は別の条件あり) |
/auto-mode-setup | 取得なしのセッションでautoMode.environment の下書きを作れない |
| 別マシンのセッションへのメッセージ送信 | 取得なしのセッションでRemote Controlが使えないときは不可(同一マシン内は動く) |
/skill-doctor と /plugin のStatsタブのレポート | 取得なしのセッションで使えない |
| claude.aiアカウントで有効にしたSkills・プラグインの同期 | 取得なしのセッションでターミナルのセッションに届かない |
| advisorツール | 取得なしのセッションで使えない |
| Artifactのコメントの読み取り・返信 | 取得なしのセッションで使えない |
| Claudeが下書きするフィードバック | 取得なしのセッションで使えない |
このほかにも、claude.aiやConsoleのアカウントでGit Bashが入っているWindowsで、既定でPowerShellツールが使われなくなる、大きな貼り付けをタイプ入力扱いにしない処理が効かない、入力スキーマが不正なMCPツールを除外せずAPIが400を返す、といった違いが挙がっています。
開始時の権限モードにも影響があります。端末とVS Code拡張では、v2.1.283以降はフラグ取得の有無にかかわらず auto で始まります。claude -p とAgent SDKは、フラグを取得するセッションでは default で始まり、取得しないセッションではv2.1.285以降が auto です。
Bedrock・Vertex・Foundry・Claude Platform on AWSで運用しているチームは、この表の機能を最初から前提に含めない設計にしておくと混乱が減ります。導入資料に一覧を注記しておく選択肢もあります。
importを使わずに手動で移行する
フラグ取得が恒常的に止まっている環境(②③④と、毎回①に戻る環境)では、claude import の完了を待たずに手作業で置き換えます。
MCPサーバーは claude mcp add で1つずつ追加します。環境変数を渡すときは -e を -- より前に置き、サーバー本体のコマンドとフラグは -- の後ろに書きます。
claude mcp add my-server -e API_KEY=xxx -- npx -y @my/mcp-serverclaude mcp add --help は、設定範囲を -s, --scope で local・user・project から選べると表示します。既定は local です。チームで共有するなら project、自分の全プロジェクトで使うなら user を指定します。
エラーメッセージが名指しする ~/.claude/settings.json が持つ設定のうち、claude import が運ぶのは権限モード(defaultMode)だけです。MCPサーバーはこのファイルから読まれないので、定義は書きません。プロジェクトスコープの定義は .mcp.json に入ります。
指示ファイル・コマンド・Skills・サブエージェントは、元ツールの定義を見ながら手で作ります。
| 移行対象 | 手動での代替手段 |
|---|---|
| MCPサーバー設定 | 手動での代替手段claude mcp add(サーバーごとに個別実行) |
指示ファイル(AGENTS.md など) | 手動での代替手段内容を確認しながら手で CLAUDE.md を作成 |
| コマンド・Skills | 手動での代替手段元ツールの定義を見ながら .claude/skills/ 配下に再作成 |
| サブエージェント定義 | 手動での代替手段同様に .claude/agents/ 配下に再作成 |
MCPサーバーの数が多いチームでは、claude mcp add を繰り返すより .mcp.json を直接編集してJSONでまとめて書くほうが早く終わります。すでに他ツールで動いている定義を、そのまま写せます。
よくある質問
claude importとclaude mcp add-from-claude-desktopは別物か
別のコマンドです。claude mcp add-from-claude-desktop は、Claude Desktopに設定済みのMCPサーバーだけを取り込みます。--help には「Mac and WSL only」と出ます。環境変数リファレンスのフラグ依存機能の一覧にも載っていません。CodexやGemini CLIなど他のエージェントの設定を広く取り込む claude import とは対象範囲が違います。
v2.1.213より前のバージョンではどうなるか
claude import と /import はv2.1.213で追加されたコマンドで、それより前には claude import がありません。このメッセージが出るのはv2.1.222以降です。
v2.1.213からv2.1.221までは、フラグが無いと import がプロンプトとして扱われ、対話セッションが始まります。メッセージは出ないので、claude --version でバージョンを確かめ、v2.1.222以降に上げてから原因を切り分けます。
関連して確認したい設定
MCPサーバーを手で追加するときの構文はClaude Code MCP設定ガイド、環境変数の効き方はClaude Code環境変数リファレンスにまとめています。起動時のエラー全般を見比べたい場合はClaude Codeでよくあるエラー10選も参考になります。
参照した一次ソース
この記事の記述は、次の一次ソースと照合しています。更新時に参照先が変わった場合は一覧も更新します。