Error 401 Unauthorized

401 Unauthorizedエラーの意味

401 Unauthorizedは、リクエストがAPIエンドポイントへ到達したものの、そのエンドポイントがリクエストを認証できなかったことを示します。

AI API中継サービスでは通常、キー、トークン、ヘッダー形式、プロバイダープロファイルのいずれかが、リクエストを受け取ったベースURLと一致していません。

主な原因

1. APIキーが未設定、空、余分な空白を含む、無効化または期限切れになっている、あるいは別のサービスのアカウントに属している。
2. OpenAI互換APIでBearerプレフィックスが欠けている、Anthropic互換APIに誤ったヘッダーを使用しているなど、Authorizationヘッダーの形式が正しくない。
3. APIキーの発行元とは別のサービスをベースURLに設定している。たとえば、AnthropicのキーをOpenAI互換中継サービスのプロファイルで使用している。
4. Claude Code、Codex、Cursor、シェルの環境変数、config.tomlのいずれかが、編集した新しいキーではなく古いキーを読み込んでいる。
5. 中継サービスのアカウントが無効、未有効化、選択したモデルを利用できない、または別のプロジェクト、組織、ワークスペース設定が必要になっている。

解決方法

1. ツールが使用する有効な環境変数と設定ファイルを表示または確認します。特にOPENAI_API_KEY、ANTHROPIC_API_KEY、ANTHROPIC_AUTH_TOKEN、サービス固有のキーを確認してください。
2. ベースURLとAPIキーが同じプロバイダープロファイルのものか確認します。サービスがその形式を明示していない限り、OpenAI公式、Anthropic公式、第三者中継サービスのキーを混在させないでください。
3. リクエストヘッダーの形式を確認します。OpenAI互換エンドポイントでは通常Authorization: Bearer YOUR_KEYを使用し、Anthropic互換エンドポイントではサービス固有の認証ヘッダーを使用する場合があります。
4. サービスのダッシュボードで新しいキーを作成し、Claude Code、Codex、Cursor、CC Switchの複雑なプロファイルを変更する前に、最小リクエストを1回テストします。
5. 同じキーがcurlでは動作してCLIで失敗する場合は、ターミナルまたはアプリを再起動し、別の設定ファイルが想定したキーを上書きしていないか確認します。

AI API中継サービス利用時の確認事項

失敗したツールと同じベースURL、APIキー、モデル名でテストしてください。別のキーやエンドポイントでリクエストが成功しても、問題のプロファイルが有効だとは確認できません。

新しいキーがcurlでは動作してCLIで失敗する場合、CLIが古い環境変数、以前のプロファイル、別の設定ファイルを読み込んでいる可能性があります。

サービスを変更するタイミング

現在のキーが無効化されている、サービスが必要な認証方式に対応していない、またはアカウントで対象モデルを利用できないと確認できた場合に限り、サービスを変更してください。401エラーの多くはローカル設定の問題です。