ガイド

Claude Code 認証の完全ガイド:ログイン方法・APIキー・チーム設定・トラブル対処まで

室谷東吾
監修者室谷東吾(@0x__tom

株式会社MYUUU 代表取締役 / 日本最大級AIコミュニティ「.AI」創設者(累計2,000名超)/ セプテーニ・ホールディングス(電通グループ)と資本業務提携 / 著書「お金を使わず、AIを働かせる『Dify』活用」(ぱる出版、3刷)/ Xフォロワー約2万人

テキトー教師
監修者テキトー教師(@tekitoo_T_cher

.AI 認定講師 / 教育×AIの専門家 / 累計300名以上にAI活用を指導 / 「テキトーに学ぶ」がモットーの実践派講師 / Xアカウント

Claude Code 認証の完全ガイド:ログイン方法・APIキー・チーム設定・トラブル対処まで

Claude Codeの認証、結局どれを選べばいいのか

室谷室谷
今回はClaude Codeの認証まわりを整理していきましょう。これ、.AI(ドットエーアイ)コミュニティでも毎週のように質問が来るんですよね。

「ログインできない」「どのアカウントで入れるの?」「APIキーと何が違うの?」って・・・
テキトー教師テキトー教師
講座でも初回に必ず出ますね。「そもそもどうやってClaude Codeにつなぐのか」が分かっていない状態で使い始めようとしている人が、思っていた以上に多いです。

認証の仕組みを理解しておくと、トラブルが起きたときの対処が全然違ってきます。
室谷室谷
まず大前提として、Claude Codeは無料プランでは使えないんですよね。これが意外と知られていない。

Claude.aiのFreeプランでClaude Codeを試そうとして「なんか使えない」ってなっている人が結構いる。
テキトー教師テキトー教師
そうなんですよ。コミュニティのメンバーさんからも「インストールしたけど認証で詰まった」って相談が来たとき、確認するとFreeプランだったってパターンが多いです。

Claude Codeを使うには、最低でもProプラン(月$20)以上のサブスクリプションが必要です。
室谷室谷
なので最初に「自分はどのアカウントで使えるのか」を確認しておくのが大事です。個人で使うのか、チームで使うのか、会社のAWSやGCPを経由するのかで、認証方法が変わってきますから。

Claude Codeが使えるプランと認証方法の全体像

Claude Code認証ドキュメントのトップページ(公式サイトより)

テキトー教師テキトー教師
まず大枠を整理しましょう。Claude Codeが使える認証方法は、大きく分けて複数パターンあります。
室谷室谷
MYUUUでもメンバーによってルートが違うので、この整理はやっておいた方がいいですね。整理するとこうなります。
認証方法対象費用の目安
Claude.ai サブスクリプション(Pro/Max/Team/Enterprise)個人・チームPro $20/月〜
Claude Console(APIキー)開発者・企業従量課金
Amazon BedrockAWS利用組織AWS経由の従量課金
Google Vertex AIGCP利用組織GCP経由の従量課金
Microsoft FoundryAzure利用組織Azure経由の従量課金
テキトー教師テキトー教師
個人で使うなら上から2番目までで十分です。ProかMax(個人サブスクリプション)でも使えますし、APIキーを直接使うこともできます。

Bedrock・Vertex・Foundryは、会社がAWS・GCP・Azureインフラを既に使っている場合の選択肢です。
室谷室谷
日本のスタートアップや中小企業だとBedrock経由が多いですよね。AWSをすでに使っているところは、そのままAWSの認証基盤に乗せられるので・・・

Claude.aiサブスクリプションでログインする方法(最も基本)

室谷室谷
個人ユーザーが最初にやることは、インストールしてからclaudeコマンドを叩くだけです。初回起動でブラウザが自動的に開いてログイン画面が出てきます。
テキトー教師テキトー教師
ここで詰まる人のパターンが2つあって。ひとつはブラウザが自動で開かない環境。

もうひとつはログインコードが途中で切れてしまうケースです。
室谷室谷
ブラウザが開かないときは、cキーを押すとログインURLがクリップボードにコピーされます。それをブラウザに貼り付けてログインすればいい。

SSH経由やリモート環境で使っているときは特にこのパターンになります。
テキトー教師テキトー教師
ログインコードが切れてしまう「OAuth error: Invalid code」エラーも多いですね。これはブラウザが開いた後に時間が経ちすぎてコードが期限切れになっているか、コピーペーストで途中が欠けてしまっているケースです。

Enterを押してやり直してすぐにログインを完了させれば解消します。

手順をまとめるとこうなります。

  1. ターミナルで claude を実行
  2. ブラウザが開くのでClaude.aiアカウントでログイン(Pro/Max/Team/Enterprise)
  3. ログインが完了するとターミナルに戻って使える状態になる
室谷室谷
ブラウザでログインコードが表示される場合(ブラウザからターミナルへのリダイレクトが効かない環境)は、そのコードをターミナルの Paste code here if prompted: というプロンプトに貼り付けます。
テキトー教師テキトー教師
ログアウトして再認証したいときは /logout コマンドです。認証が壊れたときもまずこれを試すことをすすめています。

Claude ConsoleのAPIキーで認証する方法

室谷室谷
次はAPI経由のパターン。これは従量課金でAPIを直接使いたい開発者向けです。

MYUUUのエンジニアチームはこっちを使っているメンバーもいます。
テキトー教師テキトー教師
Consoleの認証は、ブラウザログインとは別の流れになります。Anthropic Consoleでアカウントを作って、そこからAPIキーを発行して、環境変数に設定するという形です。
室谷室谷
管理者がConsoleでメンバーを招待して、招待されたメンバーが Claude Code ロールか Developer ロールをもらう。そのメンバーがAPIキーを発行してClaude Codeに設定する、という流れです。
# APIキーを環境変数に設定
export ANTHROPIC_API_KEY="sk-ant-xxxxxxxx"
テキトー教師テキトー教師
ここで重要な注意点があります。ANTHROPIC_API_KEY を設定しているとサブスクリプション(Claude.aiのPro/Max等)よりもAPIキーが優先されます。

古い会社のAPIキーが .zshrc.bashrc に残ったままになっていると、個人のProサブスクを使おうとしても「This organization has been disabled」エラーが出るんですよ。
室谷室谷
これ、.AIコミュニティでも割と多い相談です。転職した後に前職のAPIキーが残っていてつながらない、みたいなパターン。

unset ANTHROPIC_API_KEY で一時的に無効化して、/status で認証状態を確認するのが最初のデバッグステップです。
テキトー教師テキトー教師
/status コマンドで今どの認証方法がアクティブになっているか確認できます。これは覚えておくと便利ですね。

チームで使う場合の認証設計(Teams/Enterprise)

室谷室谷
ここからはチーム・組織での使い方です。Teamsプランは$20/シート/月(年間払いの場合)から使えます。

Standardシートが$20、Premiumシートが$100です( より)。
テキトー教師テキトー教師
Teamsプランの場合、管理者がダッシュボードからメンバーを招待して、招待されたメンバーが自分のClaude.aiアカウントでClaude Codeにログインするだけです。個人のProプランと認証フローは同じで、管理者が一元管理できるようになっている形です。
室谷室谷
EnterpriseプランになるとSSO(シングルサインオン)やドメインキャプチャが使えます。社員がClaude.aiにアクセスしたとき、自動的に組織アカウントに紐付けられる仕組みです。

セキュリティポリシーが厳しい大企業向けですね。
テキトー教師テキトー教師
講座の参加者さんで大企業にお勤めの方は「IT部門に申請が必要で個人では使えない」というケースが結構ありますね。会社がEnterprise契約を結んでSSOが整備されるまで使えない、ということも普通にあります。
室谷室谷
スタートアップや少人数のチームなら、Teamsから始めるのが一番シンプルです。個人のProプランを複数人で使うよりも、Teamsで一元管理した方が請求もまとまりますし・・・

Teamsプランの導入ステップをまとめるとこうなります。

  1. 管理者がTeamsプランを契約(anthropic.com/pricing
  2. 管理者ダッシュボードからメンバーを招待
  3. メンバーが招待メールからClaude.aiアカウントにログイン
  4. 各メンバーのPCで claude コマンドを叩いてブラウザ認証を完了

クラウドプロバイダー経由の認証(Bedrock・Vertex・Foundry)

Claude Code公式ドキュメントのクラウドプロバイダー認証セクション(公式サイトより)

室谷室谷
AWS・GCP・Azureを使っている組織向けのパターンです。この場合はブラウザログインが不要で、環境変数を設定するだけで認証が通ります。
テキトー教師テキトー教師
これはAWS/GCP/Azureのクレデンシャルをそのまま使う形なので、組織のIAMポリシーや権限管理をそのまま活かせます。Claude Code専用のアカウントを別途管理しなくていい、というのが企業にとっての大きなメリットです。

Amazon Bedrockで使う場合

室谷室谷
BedrockでClaude Codeを使う場合は、以下の環境変数を設定します。
# Bedrock経由で使う場合
export CLAUDE_CODE_USE_BEDROCK=1
export AWS_REGION="us-east-1"  # 使用するリージョン
テキトー教師テキトー教師
AWSの認証情報(IAMクレデンシャル)は、aws configure で設定済みのものがそのまま使われます。BedrockでClaudeモデルを有効化しておく必要もあります。

詳細はAnthropicの公式ドキュメント()で確認できます。
室谷室谷
環境変数の優先順位として、BedrockやVertex等のクラウドプロバイダー設定が最も優先されます。その後が ANTHROPIC_AUTH_TOKENANTHROPIC_API_KEYapiKeyHelper スクリプト、OAuth (Claude.aiサブスクリプション) という順番です。

Google Vertex AIで使う場合

# Vertex AI経由で使う場合
export CLAUDE_CODE_USE_VERTEX=1
export ANTHROPIC_VERTEX_PROJECT_ID="your-project-id"
export CLOUD_ML_REGION="us-east5"  # Claudeが使えるリージョン
テキトー教師テキトー教師
GCPを使っている組織はVertexが自然な選択です。GCPの認証基盤(gcloud auth)を使っているなら追加の認証設定が不要です。
室谷室谷
Microsoft FoundryはAzure経由で使う場合です。Microsoft Entra IDと連携した認証ができます。

いずれも「すでに使っているクラウドインフラにそのまま乗せる」という考え方ですね。

CIやスクリプトで使う場合の長期トークン認証

室谷室谷
少し応用的な話です。GitHub ActionsのようなCI/CDパイプラインでClaude Codeを使いたい場合、インタラクティブなブラウザログインが使えません。

そういうときの解決策が claude setup-token です。
テキトー教師テキトー教師
自動化に組み込みたいという受講生さんからよく聞かれます。claude setup-token を実行すると1年間有効なOAuthトークンが発行されます。

このトークンを CLAUDE_CODE_OAUTH_TOKEN 環境変数に設定しておくと、ブラウザログインなしで認証できます。
# 長期トークンの生成
claude setup-token

# 生成されたトークンを環境変数に設定
export CLAUDE_CODE_OAUTH_TOKEN="your-long-lived-token"
室谷室谷
このトークンはPro/Max/Team/Enterpriseのサブスクリプションが必要で、ブラウザ認証のOAuth認可フローを経由して発行されます。一度だけブラウザでの認証が必要になりますが、その後は1年間トークンで動きます。
テキトー教師テキトー教師
注意点として、このトークンは「推論専用」のスコープで発行されます。Remote Controlセッションは確立できません。

また、--bare モードで使う場合はこのトークンが読まれないので、その場合は ANTHROPIC_API_KEYapiKeyHelper で認証します。

認証の優先順位を理解する

Claude Code認証の優先順位図(高優先→低優先の順)

室谷室谷
よくあるトラブルと対処法を整理しておきましょう。「認証できない」という相談の大半はこれらで解決します。
テキトー教師テキトー教師
相談が来るパターンで一番多いのが、さっき話した「古いAPIキーが残っている」問題です。次に多いのが「403 Forbidden」エラーですね。

403 Forbiddenが出る場合

室谷室谷
ログイン後に 403 Forbidden が出る場合は以下を確認してください。
  • Pro/Maxユーザー: claude.ai/settings でサブスクリプションが有効か確認
  • Consoleユーザー: アカウントに Claude Code または Developer ロールが割り当てられているか確認
  • プロキシ経由: 企業のプロキシがAPIリクエストをブロックしている可能性がある
テキトー教師テキトー教師
プロキシの問題はIT部門に確認が必要なケースもありますね。プロキシの設定は環境変数で渡せます。
# プロキシ経由の場合
export HTTPS_PROXY="https://proxy.example.com:8080"

トークン期限切れが頻発する場合

室谷室谷
「ログインしたのにすぐ再認証を求められる」という場合、システムクロックがずれていることがあります。OAuthトークンの検証にタイムスタンプが使われているので、システム時刻が大きくずれていると期限切れと誤判断されます。
テキトー教師テキトー教師
macOSの場合、Keychainの問題が原因になることもあります。macOSはクレデンシャルをKeychainに暗号化して保存しているんですが、Keychainがロックされているとアクセスできなくなります。

claude doctor コマンドを実行するとKeychainへのアクセス状態が確認できます。Keychainがロックされている場合は security unlock-keychain ~/Library/Keychains/login.keychain-db でアンロックできます。

WSL2でのブラウザログイン問題

室谷室谷
WindowsのWSL2環境でClaude Codeを使っている場合、ブラウザベースのログインで詰まることがあります。WSLがWindowsのブラウザを自動で開けない場合があるんですよね。
# WSL2でブラウザを指定する場合
export BROWSER="wslview"
テキトー教師テキトー教師
あるいはログインプロンプトが出たときに c を押してURLをコピーして、WindowsのブラウザにそのURLを貼り付けてログインする方法もあります。WSL2でClaude Codeを使っている受講生さんには、先にこれを伝えるようにしています。

組織向けのカスタム認証(apiKeyHelper)

室谷室谷
apiKeyHelper という設定があります。これはシェルスクリプトを指定して、Claude Codeが動的にAPIキーを取得できるようにする仕組みです。
テキトー教師テキトー教師
例えばAWS Secrets ManagerやHashiCorp Vaultに短期間有効なトークンを保管していて、使うたびに新しいトークンを取得したい場合に使います。セキュリティポリシー上、長期間有効なキーを環境変数に持ちたくない組織向けですね。
// ~/.claude/settings.json または .claude/settings.json
{
  "apiKeyHelper": "/path/to/my-credential-script.sh"
}
室谷室谷
デフォルトでは5分ごと、またはHTTP 401レスポンスがあったときにこのスクリプトが呼ばれます。CLAUDE_CODE_API_KEY_HELPER_TTL_MS 環境変数でリフレッシュ間隔を変更できます。
テキトー教師テキトー教師
apiKeyHelper はターミナルのCLIセッションにのみ適用されます。Claude DesktopやリモートセッションはOAuth認証を使うので、apiKeyHelper は呼ばれません。

スクリプトの処理が10秒を超えると警告が出るので、なるべく高速に返すように作るのが大事です。

よくある質問(FAQ)

Claude Codeは無料で使えますか?

テキトー教師テキトー教師
使えません。Claude.aiの無料プランはClaude Codeへのアクセスが含まれていません。

個人で使うなら最低限Proプラン(月$20、または年間$200)が必要です。

ProとMaxでClaude Codeの機能に差はありますか?

室谷室谷
機能自体に差はありません。MaxはProより使用量が5倍または20倍多く使えるプランです。

Claude Codeをヘビーに使う場合はMax、たまに使う程度ならProで十分です。

APIキーとサブスクリプションで使い勝手の違いは?

テキトー教師テキトー教師
個人で使う分には体感は同じです。違いは課金形態で、サブスクリプションは定額制、APIキー(Console)は従量課金です。

たくさん使う個人はサブスクリプションの方がコストを読みやすいです。開発者がAPIを叩いてシステムに組み込む場合はConsole経由が一般的です。

認証情報はどこに保存されますか?

室谷室谷
macOSの場合は暗号化されたKeychainに保存されます。Linux・Windowsの場合は ~/.claude/.credentials.json に保存されます(Linuxは600パーミッション)。

CLAUDE_CONFIG_DIR 環境変数で保存場所を変えることも可能です。

まとめ:自分のユースケースに合った認証を選ぶ

室谷室谷
ここまで話してきた内容を整理すると、認証方法の選び方はシンプルです。個人なら.aiサブスクリプション、チームはTeams、クラウド組織はそのインフラ経由、CI/CDは長期トークン、という棲み分けです。
テキトー教師テキトー教師
「どの認証が有効になっているのか」を /status コマンドで確認する習慣が大事です。認証まわりのトラブルはほぼ全部、複数の認証情報が混在している状態から起きますから。
室谷室谷
ANTHROPIC_API_KEY が環境変数にあるとサブスクリプション認証より優先される、という仕組みを覚えておくだけで多くのトラブルが予防できます。MYUUUでも新しいメンバーのオンボーディング時にこれを必ず説明するようにしています。
ユースケース推奨認証方法
個人・セルフスタディClaude Pro(月$20)でブラウザログイン
小規模チームClaude Teams($20/シート/月〜)
大企業・コンプライアンス重視Claude Enterprise(SSOあり)
AWS利用組織Amazon Bedrock経由
GCP利用組織Google Vertex AI経由
Azure利用組織Microsoft Foundry経由
CI/CDパイプラインclaude setup-token で長期トークン
APIダイレクト利用Claude Console APIキー

出典

.AI TIMES一覧に戻る