サブスクリプションなしでClaude Codeを無料で使う方法

Claude Codeはデフォルトで無料ではありません。セットアップ手順のすべてと、それぞれが何を犠牲にするかを正直に説明します。

更新 2026年8月3日 · 15 分読む

AIで探索

Claude Codeのインストールは30秒ほどで終わり、プロジェクトディレクトリ内で claude を実行すると、既存のアカウントでは扉が開かないことに気づきます。ここから多くの人が無料版を探し始めますが、回答は途端に曖昧になります。「無料」の意味は、ターミナルエージェントを求めているのか、チャットUIなのか、あるいはClaude以外のモデルを下支えに使ったClaude Codeのワークフローなのかで変わってくるからです。

この記事では、費用ゼロで始められる4つのルートを、どれだけ本物に近いかの順で紹介します。前提条件は最小限です。ターミナル、対応プラットフォーム（macOS 13+、Windows 10 build 1809+、Ubuntu 20.04 または Debian 10+、RAM 4 GB）。ネイティブインストーラーは実行環境を同梱しているため、npm経由を選ばない限りNode.jsは不要です。

要点まとめ

Claude.aiの無料プランにはClaude Codeは含まれません。
新規のコンソールアカウントには、CLIアクセスを試せる一度きりのAPIクレジットが付与されます。
Claude Codeはエンドポイントを ANTHROPIC_BASE_URL から読み取るため、OpenRouterやOllamaへのルートが成り立ちます。
これら2つのルートで得られるのは、Claudeではなく別モデルを下支えにしたClaude Codeのワークフローです。
オープンソースのメンテナーは、上位プランへの6か月間のアクセスを受けられます。

Claude Codeとは？

Claude Codeは、ターミナル向けのAnthropic製エージェント型コーディングツールです。プロジェクトディレクトリ内で動作し、ファイルの読み取りや編集、コマンドの実行、複数手順のタスクの処理まで、ブラウザに何かをコピペすることなく完結できます。

有料である理由は商業的というより構造的です。実行するアクションはすべてAPI呼び出しであり、エージェントのセッションは本質的におしゃべりです。つまり、モデルはコンテキストを再読し、ツールを呼び出し、結果を確認して再試行します。大規模なリポジトリでの忙しい午後は、特に生産的に感じなくてもトークンに数ドルかかることがあります。

日々の使い方を全体像で知りたい場合は、セットアップ、リファクタリング、デバッグを実践で扱うClaude Codeチュートリアルをご覧ください。

Claude Codeは無料ですか？

率直な答えはノーです。Anthropicのセットアップドキュメントでは、Claude Codeの利用にはPro、Max、Team、Enterprise、またはConsoleアカウントが必要で、無料のClaude.aiプランには含まれないとしています。Proは月額$20（年間一括$200なら月あたり$17）からです。

代替はコンソール課金で、サブスクリプションなしにトークン単位で支払います。Claude Sonnet 5は通常、入力100万トークンあたり$3、出力100万トークンあたり$15。Claude Opus 5は$5と$25、Haiku 4.5は$1と$5です。

この2つのルートは課金ロジックがまったく異なり、相性を誤ると割高になったり、作業中にスロットリングにかかったりします。以下が両者の比較です。mpare.

	Claudeサブスク（Pro、Max、Team）	コンソールの従量課金
支払い対象	使用量枠をカバーする月額の定額料金	実際に送受信したトークンのみ
費用	Proは月$20、Maxは$100または$200、Team Premiumは席あたり$125	月額なし。Sonnet 5は100万トークンあたり$2/$10、Opus 5は$5/$25、Haiku 4.5は$1/$5
モデルのアクセス	デフォルトはSonnet 5。Pro以上でOpusが利用可能	料金表上のすべてのモデル。安価な作業向けのHaiku 4.5から最上位のFable 5まで
制限要因	ローリング5時間ウィンドウ＋週次上限。Claudeチャット、Cowork、Claude Codeで共有	メッセージ枠ではなく、利用階層（Start/Build/Scale）に紐づくレート制限
上限到達時	ウィンドウのリセット待ち、またはAPIレートで追加購入	プリペイド残高が尽きるまで止まらない。残高ゼロで課金エラーとして失敗
コストの予測性	固定。月初前から金額が分かる	変動。重いリファクタ週は静かな週の数倍になる
無料の出発点	なし。ProやMaxにトライアルはない	新規アカウントに一度きりのスタータークレジット
最適な用途	日々の安定利用。定額のほうがAPIよりトークン単価が安くなる場合	波のある利用、評価、月額契約を避けたい人

分岐点はボリュームではなく「利用の安定性」です。上限に達するまでは、サブスクのほうがAPIより実効レートがかなり良く、毎日使う人はたいていProが得になります。週ごとの波が大きいなら従量課金が有利で、静かな週は文字通りゼロ円で済みます。

では「無料」はどこから来るのか。大きく3つです。

スタータークレジット（新規APIアカウントに付与）
Claude CodeがAnthropic Messages形式で話すサーバー（ホステッドのOpenRouterやローカルのOllamaなど、無料のものも含む）と問題なく通信できること
オープンソースのメンテナー向けの助成プログラム

2つ目には前置きの注意が必要です。無料モデルを指すと、得られるのはインターフェースとエージェントループであって、Claudeそのものではありません。複数手順の推論における品質差は実在します。この点は後ほど触れます。

無料プランにClaude Codeは含まれますか？

最も多い誤解から片づけます。多くの人の夜を無駄にする原因だからです。

無料ティアには含まれません。限定版でもトライアルでもありません。Anthropicのドキュメントは明確で、無料プランはWeb、iOS、Android、デスクトップのClaudeをカバーしますが、ターミナルエージェントは対象外です。

とはいえ、無料で得られる内容は実用的です。2026年7月1日以降、無料プランのデフォルトモデルはClaude Sonnet 5になり、Web検索、ファイルアップロード、Projects、Artifactsもペイウォールの外に出ました。スタックトレースを貼って原因を尋ねる用途なら十分使えます。

開発者がまず当たる無料ティアの制限

Anthropicはメッセージ数を公表しておらず、具体的な数字を断言する人は推測に過ぎません。ProはFreeの少なくとも5倍のセッション使用量と説明されており、Freeは固定枠ではなくベースラインと捉えるべきです。実際には、5時間のローリングウィンドウで15〜40メッセージ程度の報告が多く、長文や添付があると消費は早まります。

メッセージ数より重要な制限がいくつかあります。

5時間のウィンドウは最初のメッセージ送信から回り始めます。
Claude CodeのCLIアクセスは不可。これは厳格で、回避策はありません。
サーバー負荷に応じて可変。ピーク時間帯は悪化します。
会話が長いほど、各ターンでスレッド全体を再読するため1メッセージあたりの負担が増します。

結論として、無料のチャット層は単発の質問やコードレビューには十分ですが、コードベースについて継続的にやり取りした途端に破綻します。まさにその用途こそClaude Codeの領分です。

オプション1：Anthropic APIの無料クレジット

これはあまり知られていない公式ルートで、個人的には多くの人が最初に試すべき方法だと考えます。

platform.claude.comでアカウントを作成すると platform.claude.comで一度きりのスタータークレジットが付与されます。Anthropicの料金ドキュメントでは具体額を示さず「少額の無料クレジット」とだけ説明されていますが、第三者の報告では概ね$5程度とされています。

APIクレジットはClaude CodeのCLI認証に使えます。本物のエージェントが、本物のClaudeモデルで、本物のコードベースに対して動作します。クレジットは更新されず14日で失効するため、継続利用ではなく試用と捉えてください。

APIアカウントのセットアップとクレジットの受取

コールドスタートから動作するエージェントまで約10分で到達します。時間の大半はインストーラーの待機で、5ステップに分けたのは、3番目に再起動を招く落とし穴があるからです。

ステップ1：コンソールアカウントの作成

platform.claude.com へ行き、メールアドレスでサインアップします。コンソールはclaude.aiのチャットとは別製品のため、既存のClaudeアカウントは引き継がれず、同じアドレスでも再登録が必要な場合があります。

補足として、この段階で電話番号の確認を求められる場合があります。完了すると、スタータークレジットはプロモコード入力ではなく自動で適用されます。

ステップ2：クレジット残高の確認

コンソールのBillingセクションを開きます。開始残高が表示され、支払い方法の追加オプションも見えますが、今は不要です。

何より先にこれを確認してください。残高がゼロだと、その後いくら設定が正しくてもセッションは動きません。

ステップ3：APIキーの作成

Settings > API Keys で新しいキーを作成します。数か月後に見ても分かる名前を付けてください。複数持つ人が多いからです。

キーの完全な値はこの一度だけ表示されます。ダイアログを閉じる前にパスワードマネージャーへ必ずコピーしてください。閉じるとキーは失われ、この手順をやり直すことになります。

ステップ4：キーをエクスポートしてClaude Codeをインストール

シェルで環境変数としてキーをエクスポートし、CLIをインストールします。Anthropicの推奨はネイティブインストーラーで、実行環境を同梱し、Node.jsは不要です。

export ANTHROPIC_API_KEY="sk-ant-your-key-here"
curl -fsSL https://claude.ai/install.sh | bash

Windows PowerShellではインストーラーは irm https://claude.ai/install.ps1 | iex です。npmを好む場合、Claude Code v2.1.198時点ではパッケージにNode.js 22以降が必要で、旧ガイドにあるNode.js 18以上から変更されています。

npm install -g @anthropic-ai/claude-code

新しいターミナルでもキーが有効になるように、export の行を ~/.zshrc や ~/.bashrc に追加してください。インストールを確認します。

claude --version

ステップ5：初回セッションを実行

プロジェクトディレクトリに移動してエージェントを起動します。ホームディレクトリで claude を実行しても技術的には動きますが、コードベースがないと有用性は低いです。

cd ~/projects/my-app
claude

ANTHROPIC_API_KEY を設定した初回起動では、ブラウザでのOAuthではなくキーの承認を一度だけ求められます。承認すると、作業ディレクトリが下部に表示されたウェルカム画面に入ります。

インストールだけでなく課金ルートも確認するには、セッション内で /status を実行します。 API key の行に ANTHROPIC_API_KEY が表示されていれば、保存済みのclaude.aiログインではなくConsoleクレジットを使用しています。

何かおかしいと感じたら、claude doctor を実行すると、セッションを開始せずにインストールと設定の診断を表示します。エラーメッセージ検索より早道です。

無料クレジットでどれくらい使える？

概算を、現行のSonnet 5のイントロ価格で。実リポジトリでの15往復を想定し、各ターンで約30,000トークンのコンテキストを送り、約1,500トークンの出力を得るとします。初回は入力が満額、以降の14ターンは主にプロンプトキャッシュでその1割の価格になります。

内訳	計算	費用
初回ターン（未キャッシュの入力）	30,000トークン × $2/MTok	$0.06
その後14ターン（キャッシュ読み出し）	420,000トークン × $0.20/MTok	$0.08
15ターンすべての出力合計	22,500トークン × $10/MTok	$0.23
セッション合計		$0.37
キャッシュなしの同一セッション	入力45万トークンが満額	$1.13

これは目安であり見積ではありません。上記はフラットなコンテキストを仮定し、書き込みキャッシュのプレミアム（5分キャッシュで基礎入力価格の1.25倍）を無視しています。実際のセッションはこれを挟む形で着地します。

最後の2行の差は押さえておくべき要点です。キャッシュは請求額をおおむね4分の3削減します。これが、素朴なトークン数見積よりClaude Codeのセッションが安く済む理由であり、キャッシュを壊す行為（リポジトリ間の行き来、頻繁なセッション再起動、セッション中のモデル切替）が、知らぬ間に費用を3倍にする理由です。きちんと見積もりたい場合はAnthropicの料金ドキュメントの乗数表をご覧ください。

モデルごとのレート差

モデル選択は、制御可能な要素の中で数字を最も動かします。同じ15往復セッションをラインナップ全体で回すと：

モデル	入力/出力（100万トークンあたり）	セッション単価	$5あたりのセッション数
Haiku 4.5	$1 / $5	$0.18	約27
Sonnet 5（イントロ、〜2026/8/31）	$2 / $10	$0.37	約13
Sonnet 5（標準、2026/9/1〜）	$3 / $15	$0.55	約9
Opus 5	$5 / $25	$0.92	約5
Fable 5	$10 / $50	$1.85	3未満

つまり、$5の残高で買えるのは、どのモデルに向けるかによって、5〜27セッションまで大きく変わります。評価用途ならSonnet 5が妥当なデフォルトです。

その残高は実務的な課題に使ってください。所有しているモジュールのリファクタリングや、3ファイルにまたがるバグ調査などです。そうしてはじめて、このツールが週次のワークフローに値するか判断できます。

残高がゼロになったら、フォールバックはありません。コンソール課金は完全従量制で、Claude Codeの無料ティアが下に待っているわけではありません。

オプション2：OpenRouterの無料モデル

OpenRouterは数百のモデルの前段にあるAPIゲートウェイで、入れ替わりで一部のモデルは無料で呼び出せます。クレジットカードも月額も不要です。

これがClaude Codeと結びつく理由は、CLIがエンドポイントを環境変数から読むためです。変数を変えれば送信先も変わります。OpenRouterは「Anthropic Skin」と呼ぶエンドポイントを提供し、Anthropic Messages形式を受け付け、thinkingブロックやネイティブなツール呼び出しも素通しします。ローカルプロキシは不要です。

何を得るのかは明確にしておきましょう。これはClaudeモデルではありません。Claude Codeのインターフェース、エージェントループ、ファイル編集、スラッシュコマンドは維持しつつ、推論はQwenやLlama系が担当します。

OpenRouterのドキュメント自体が、Claude CodeはAnthropicのファーストパーティプロバイダでのみ動作保証があり、「他のプロバイダでは正しく動作しない場合がある」と警告しています。この点は事実として引用しておきます。

リダイレクトの仕組み

3つの変数で動きます。

ANTHROPIC_BASE_URL をAnthropicではなく https://openrouter.ai/api に向ける。
ANTHROPIC_AUTH_TOKEN にOpenRouterのキーを設定し、Authorization: Bearer ヘッダーとして送る。
ANTHROPIC_API_KEY は明示的に空文字に設定。そうしないとClaude CodeがAnthropicで認証し直す場合があります。

これらはシェルプロファイルかClaude Codeの設定ファイルに置けます。避けるべきこと：プロジェクトの .env は使えません。ネイティブインストーラーは標準の .env を読みません。

json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://openrouter.ai/api",
    "ANTHROPIC_AUTH_TOKEN": "sk-or-v1-your-openrouter-key",
    "ANTHROPIC_API_KEY": ""
  }
}

ファイルの置き場所は見た目以上に重要です。グローバル設定なら ~/.claude/settings.json、単一プロジェクトなら .claude/settings.local.json を使ってください。後者はgitignoreに自動追加されます。

プロジェクトの .claude/settings.json に認証情報を書かないでください。このファイルはコミットされ、リポジトリのクローンを取る全員に共有されます。

OpenRouterでのClaude Code設定

Claude Codeをインストール（まだならネイティブインストーラーで）。
無料アカウントを作成し、openrouter.ai の Settings > Keys でキーを発行。無料モデルのみならカード不要です。
設定を書き込み、上記ブロックを ~/.claude/settings.json に入れるか、シェルプロファイルで3変数をエクスポート。
過去にAnthropicアカウントでClaude Codeにログインしたことがある場合は、CLI内で /logout を実行し、終了して再起動。キャッシュされたセッションが変数を上書きし、model-not-found系の混乱を招きます。
claude を起動し、送信先を確認します。

> /status
Auth token: ANTHROPIC_AUTH_TOKEN
Anthropic base URL: https://openrouter.ai/api

数秒以内にOpenRouterのアクティビティダッシュボードにもリクエストが現れるはずです。リダイレクト確認の最短ルートです。

OpenRouterで無料モデルを選ぶ

無料モデルのIDは末尾が :free。提供者の追加・引き上げ・再価格設定により常に入れ替わります。 OpenRouterの無料モデル一覧で現時点の無償モデルを確認できます。 openrouter/free は無料モデル用のオートルータで、利用可能かつリクエストに合うものを選びます。個別モデルのローテーション後も設定が生き続けるので手軽ですが、品質はばらつきます。

OpenRouterの価格、クレジット、無料モデルの顔ぶれは毎月のペースで変わり、この原稿中にも変化がありました。ここにある数字を前提に計画する前に、Anthropicの料金ページとOpenRouterの無料フィルタを確認してください。

そしてモデル選び以上に響くのがレート制限です。無料モデルはアカウントに関わらず毎分20リクエスト、クレジット未購入だと1日50リクエストに制限されます。一度だけ$10分のクレジットを購入すると、日次上限は1,000に上がり、残高が再びゼロになっても維持されます。

一日50リクエストは一見いけそうですが、エージェントのセッションはおしゃべりな同僚のようにリクエストを消費します。そこそこ込み入ったタスク1つで日次上限の3分の1を使い切ることも。失敗した試行もカウントされるため、やみくもな再試行は悪化要因です。

役割ごとにモデルを振り分けるには、Claude Codeが各ティア用の変数を公開しています。

bash
export ANTHROPIC_DEFAULT_SONNET_MODEL="cohere/north-mini-code:free"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="cohere/north-mini-code:free"
export CLAUDE_CODE_SUBAGENT_MODEL="cohere/north-mini-code:free"

単純なリファクタや単一ファイルの編集、解説系タスクは良好です。一方で、長い多段作業は目に見えて劣化し、失敗パターンは生コードの品質というよりツール呼び出しです。誤ったツール選択、結果の読み違い、ループなどが起こりがちです。

タスク別にモデルを意図的に混ぜるアプローチに興味があれば、Claude Code Routerガイドで複数モデルのルーティングを詳説しています。

オプション3：Ollamaのローカルモデル

Ollamaはオープンモデルをローカルマシンで実行します。APIキーもレート制限も不要で、重みを取得した後はインターネット接続も不要です。

2026年1月、Ollama v0.14.0でAnthropic Messages API互換が追加され、このワークフローが現実的になりました。それ以前は途中に変換プロキシが必要でしたが、いまはClaude Codeが直接 localhost と話します。

コストは消えるのではなく、ハードウェア、なかでもメモリの帯域へと移ります。

Apple Siliconではユニファイドメモリが要。16 GBで約14Bモデル（gpt-oss:20b）は動きますが、使う価値のある30B級のコーディングモデルは、32Kコンテキストを加えると32 GB以上を要求します。
Windows/Linuxでは見るべきはGPUのVRAMで、システムRAMではありません。RAMに収まってもCPU実行では遅すぎ、エージェント的作業（多数のコールを発火）が成立しません。

OllamaとClaude Codeの設定

Ollamaをインストール。macOS/Linuxは curl -fsSL https://ollama.com/install.sh | sh、Windowsはollama.comからインストーラーを取得して実行。
コーディングモデルを取得。現行のClaudeには及ばないものの、Qwen3-Coderは妥当： ollama pull qwen3-coder。
モデルの存在を確認（ollama list）。
コンテキスト長を引き上げ。ここを忘れてモデルのせいにするケースが頻発。Claude Codeには少なくとも32KトークンをOllamaが推奨。
ローカルエンドポイントを指し、モデルを指定。

bash
export OLLAMA_CONTEXT_LENGTH=32768
export ANTHROPIC_AUTH_TOKEN=ollama
export ANTHROPIC_BASE_URL=http://localhost:11434

claude --model qwen3-coder

認証トークンはプロトコル上必須ですがOllama側では無視されるため、値は任意です。恒久化したい場合は同じ3つのキーを ~/.claude/settings.json の env ブロックに入れてください。

評価前に知っておくべきギャップが2つあります。

Anthropicのプロンプトキャッシュは適用外。各リクエストでシステムプロンプトと会話履歴を最初から再処理します。ここでは高くはつきませんが遅くなります。
Ollamaの互換レイヤーは tool_choice を無視。Claude Codeが特定ツールの強制呼び出しに使うことがあり、その場合に誤ツール選択やループの原因になります。

このセットアップの詳細な解説は、OllamaローカルモデルでClaude Codeを使う専用チュートリアルのほか、Qwen 3やDeepSeek R1をローカルで動かすガイドもあります。

ハードウェア現実チェック

ユニファイドメモリ / VRAM	動くもの	正直な所感
8 GB	7Bモデルのみ	複数ファイルの推論は厳しい。単一関数の質問は可、エージェント作業はストレス。
16 GB	7B〜14Bは余裕。`gpt-oss:20b`は入るが、32Kコンテキストで余裕は減る	32Kコンテキストで単純な編集・解説は実用的。
24 GB	`gpt-oss:20b`に余裕。30Bの `qwen3-coder` は中程度のコンテキストで	エージェントコーディングの実用下限。単一24 GBカード（RTX 3090/4090）や24 GBのMacが該当。
32 GB+	30B級コーディングモデルを32Kコンテキストで	ローカルが妥協ではなく、無料クラウドに対抗できる感触に。

大半の開発者にとっては、32 GB以上のユニファイドメモリ/VRAMがある、オフライン必須、もしくはコードを外に出したくないといった要件がない限り、OllamaよりOpenRouterが有利です。最後の要件は十分に正当で、性能だけでこのルートを切り捨てるべきではありません。

オプション4：Claude for Open Sourceプログラム

多くのガイドは3つで終わりますが、実は本物の製品を最高ティアで半年使える選択肢があります。

Anthropicは2026年2月にClaude for Open Sourceを立ち上げ、7月に拡張しました。要件を満たすメンテナーやコントリビューターは、月$200のClaude Max 20xを6か月間、無償で利用できます。Claude Codeも含まれ、消費上限はコンシューマ最上位帯です。

公表されている適格トラックは想像より広いです。

依存リポジトリ500以上、依存パッケージ100以上、またはnpm/PyPI/crates.io/RubyGems等で月間合計ダウンロード20万以上のパッケージのメンテナー。
CPython、Rustチーム、Node.js TSC、Apache PMC、CNCF、Kubernetes、Linuxカーネル、Django、Railsなど、認定団体や言語プロジェクトのコミッターとして掲載されている人。
過去12か月で、自分の所有でないリポジトリに100件以上のマージ済みPRを作成した人。
過去1年で、外部の一意のコントリビューターが20人以上マージ済みPRを送ったリポジトリのコミュニティビルダー。
OpenSSFのクリティカリティスコア0.4以上のプロジェクトのメンテナー。

Anthropicのページは、グレーゾーンのケースも歓迎しており、エコシステムが密かに依存している点を説明するよう促しています。上限は1万人、ローリングで審査。申請は claude.com/contact-sales/claude-for-ossから。

注意点がひとつ。対象はサブスクリプションでありAPIクレジットではありません。ANTHROPIC_API_KEY の利用は別課金のままです。CIパイプライン向けではなく、個人のプランと捉えてください。

自分に合う無料オプションの選び方

ポイントは2つ。Claude Codeで何をしたいのか、設定にどれだけ時間を割けるか。

比較表

オプション	本物のClaudeモデル？	Claude Code CLI	制限	最適な用途	設定の手間
Claude.ai無料ティア（Claude Codeではない）	はい（Sonnet 5）	いいえ	5時間あたり約15〜40メッセージ、可変	ときどきのコーディング質問やコードレビュー	なし
API無料クレジット	はい（任意モデル）	はい	一度きりのスタータークレジット（約$5）	Claude Codeの本格評価	低
OpenRouter無料モデル	いいえ（Qwen、Llama、GPT-OSS）	はい	20 req/分、50/日（$10一度購入で1,000/日に）	ローカル環境不要の継続的な無料利用	中
Ollamaローカルモデル	いいえ（ローカルのオープンモデル）	はい	ハードウェア制約、レート制限なし	オフライン、プライバシー、トークン費ゼロ	高
Claude for Open Source	はい（Max 20x）	はい	6か月、定員あり、適格性要件	該当するOSSメンテナー	低（申請が必要）

どれを選ぶべき？

Claude Codeを使ったことがなく月$20の価値があるか知りたいなら、APIのスタータークレジットを。唯一、本物の製品を体験でき、十数セッションで十分判断できます。
無料で継続利用したいがClaudeにこだわらないなら、OpenRouterが品質と手間のバランスで最良。初回セットアップに一晩あて、日次上限には早めに達する前提で。
オフラインが必要、またはソースコードの移動に制約があるなら、ハードウェア費がかかってもOllama。ユニファイドメモリ/VRAM 16 GB未満ならおすすめしません。
他者が依存する何かをメンテしているなら、まずOSS助成を確認。最上位で6か月なら、悩みは消えます。

リダイレクト系セットアップのトラブルシューティング

オプション3と4は似た失敗領域を持ち、原因の大半は同じです。Anthropicもゲートウェイ提供側も、個々の組み合わせはデバッグできません。まずは以下を確認してください。

Claude Codeがログインを求め続ける。CLI自体は認証情報を持ちません。到達可能なベースURLだけでは不十分です。プロジェクトの .claude/settings.json のenvブロックは初回ウィザード後にのみ適用されるため、ANTHROPIC_AUTH_TOKEN はより早く読まれる場所（シェルのexportや ~/.claude/settings.json）に設定します。
起動時の警告で2つの認証源が示される。ゲートウェイの資格情報と保存ログインが同時に有効です。/logout で保存ログインを消すか、変数をunsetして以前のログインに戻します。
認識されないフィールドに関する400エラー。Claude CodeはAnthropic形式のエンドポイントに、一部の上流が拒否するフィールドを送ります。CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1 を設定すると大半のプレリリース項目を抑止し、切り分けやすくなります。
thinkingやadaptiveに関する400エラー。上流モデルがアダプティブ推論を受け付けません。Claude Codeは最近のClaudeモデルに対してこれを要求します。多くの場合、クライアント側ではなくゲートウェイの上流更新が必要です。
リモートコントロールと音声ディクテーションが動かない。いずれもclaude.aiのアイデンティティに依存し、ゲートウェイの資格情報が設定されている間は利用不可です。v2.1.196以降、ANTHROPIC_BASE_URL がAnthropic以外を指す場合もリモートコントロールは無効化されます。

不具合があり、どのレイヤーが原因か掴めないときは、セッション内で /status を実行すると、実際に使われているベースURLと認証源が分かります。この一発で、変数の出し入れより多くの問題が解決します。

最後に

Claude Codeを無料で使う4つのルート。それぞれ完璧ではなく、肝心なのはトレードオフです。

個人的な推奨はシンプルです。欲しいのがチャットではなくClaude CodeのCLIエージェントなら、まずAPIクレジットで始めてください。代替品を一晩かけて設定するより、本物で1回の実務セッションから得られる学びのほうが大きい。ワークフローに定着するなら月$20は十分に正当化できます。そうでなければ失うものはなく、理由も分かります。

長期的には、OpenRouterが最も持続可能な無料選択肢で、プライバシーやオフラインを譲れないならOllamaが勝ちます。

便利なセッションと苛立つセッションを分ける習慣については、Claude Codeベストプラクティスで、計画、コンテキスト移送、実プロジェクトでのテスト駆動開発を扱っています。ゼロからなら、Claude Code 101が、初回インストールから動くワークフローまで、双方向の構造化レッスンで基礎を教えます。