Pi Agent 認証とモデル設定

Pi Agent は、サブスクリプションログインとAPI Keyの2つの認証方式をサポートしています。この章では、Pi Agent をAIモデルに接続するための設定方法を詳しく説明します。

認証方式の概要

認証方式	操作方法	適用シーン
サブスクリプションログイン（OAuth）	pi を起動して /login を実行	Claude Pro/Max、ChatGPT Plus/Pro、GitHub Copilot などのサブスクリプションを既にお持ちの場合
API Key環境変数	環境変数を設定して pi を起動	API Keyを持っており、シェル設定に永続化したい場合
API Key資格情報ファイル	/login でAPI Keyプロバイダーを選択して保存	API Keyを持っており、Pi Agent で一元管理したい場合

方法1：サブスクリプションログイン（推奨）

すでに Claude Pro/Max、ChatGPT Plus/Pro、GitHub Copilot のいずれかにサブスクリプションを登録している場合、これが最も便利な方法です。

Pi Agent を起動したら、次のコマンドを入力します：

/login

表示されたメニューからサブスクリプションプロバイダーを選択します：

プロバイダー	要件	説明
Claude Pro/Max	Anthropic サブスクリプションアカウント	追加使用量で課金され、プランの利用枠を消費しません
ChatGPT Plus/Pro (Codex)	OpenAI Plus または Pro サブスクリプション	OpenAI 公式認定の Codex for OSS
GitHub Copilot	GitHub Copilot サブスクリプション	github.com およびエンタープライズサーバーに対応
xAI (Grok)	X Premium サブスクリプション	Grok モデルを使用
OpenRouter	OpenRouter アカウント	OAuth でAPI Keyを作成し、残高から課金

Claude Pro/Max サブスクリプション認証モードでは、Pi Agent は追加使用量（extra usage）を使用し、トークン単位で課金され、Claude プランの利用枠を消費しません。確認はClaude 使用量設定で確認できます。

ログインが完了すると、資格情報は~/.pi/agent/auth.jsonに保存され、以降 Pi Agent を起動すると自動的に使用されます。

ログアウトする場合は、次を使用します：

/logout

方法2：API Key環境変数

API Keyをお持ちの場合は、Pi Agent を起動する前に環境変数を設定できます：

# 设置 Anthropic API Key
export ANTHROPIC_API_KEY=sk-ant-api03-your-key-here

# 启动 Pi Agent
pi

Pi Agent は、以下の主要プロバイダーのAPI Key環境変数をサポートしています：

プロバイダー	環境変数	auth.json のキー名
Anthropic	ANTHROPIC_API_KEY	anthropic
OpenAI	OPENAI_API_KEY	openai
Google Gemini	GEMINI_API_KEY	google
DeepSeek	DEEPSEEK_API_KEY	deepseek
Groq	GROQ_API_KEY	groq
Mistral	MISTRAL_API_KEY	mistral
xAI	XAI_API_KEY	xai
OpenRouter	OPENROUTER_API_KEY	openrouter

DeepSeekプロバイダーの設定

Pi は models.json を通じてカスタムプロバイダーをサポートしています。設定ファイルの場所：

Linux / macOS：~/.pi/agent/models.json
Windows：%USERPROFILE%\.pi\agent\models.json

まず DeepSeek オープンプラットフォームで API Key を取得します：https://platform.deepseek.com/api_keys。

{
  "providers": {
    "deepseek": {
      "baseUrl": "https://api.deepseek.com",
      "api": "openai-completions",
      "apiKey": "$DEEPSEEK_API_KEY",
      "models": [
        {
          "id": "deepseek-v4-pro",
          "name": "DeepSeek V4 Pro",
          "contextWindow": 1000000,
          "maxTokens": 384000,
          "input": ["text"],
          "reasoning": true,
          "cost": {
            "input": 1.74,
            "output": 3.48,
            "cacheRead": 0.145,
            "cacheWrite": 0
          },
          "compat": {
            "requiresReasoningContentOnAssistantMessages": true,
            "thinkingFormat": "deepseek",
            "reasoningEffortMap": {
              "minimal": "high",
              "low": "high",
              "medium": "high",
              "high": "high",
              "xhigh": "max"
            }
          }
        },
        {
          "id": "deepseek-v4-flash",
          "name": "DeepSeek V4 Flash",
          "contextWindow": 1000000,
          "maxTokens": 384000,
          "input": ["text"],
          "reasoning": true,
          "cost": {
            "input": 0.14,
            "output": 0.28,
            "cacheRead": 0.028,
            "cacheWrite": 0
          },
          "compat": {
            "requiresReasoningContentOnAssistantMessages": true,
            "thinkingFormat": "deepseek",
            "reasoningEffortMap": {
              "minimal": "high",
              "low": "high",
              "medium": "high",
              "high": "high",
              "xhigh": "max"
            }
          }
        }
      ]
    }
  }
}

環境変数を設定します：

Linux / Mac ユーザー：

export DEEPSEEK_API_KEY="<你的 DeepSeek API Key>"

Windows ユーザー：

$env:DEEPSEEK_API_KEY="<你的 DeepSeek API Key>"

プロジェクトディレクトリに移動して pi コマンドを実行します：

cd /path/to/my-project
pi

毎回手動で環境変数を設定したくない場合は、export コマンドをシェル設定ファイル（~/.zshrc や ~/.bashrc など）に書き込んで、永続的に有効にすることができます。

方法3：API Key資格情報ファイル

/login コマンドでAPI Keyプロバイダーを選択して資格情報を保存することもできます。

保存場所は次のとおりです：~/.pi/agent/auth.json形式は以下のとおりです：

{
  "anthropic": { "type": "api_key", "key": "sk-ant-api03-your-key" },
  "openai": { "type": "api_key", "key": "sk-your-openai-key" },
  "deepseek": { "type": "api_key", "key": "sk-your-deepseek-key" }
}

資格情報ファイルは自動的に次の権限に設定されます：0600（ユーザーのみ読み書き可能）となり、基本的な安全性が確保されます。

資格情報の解析順序

Pi Agent がAPI Keyを取得する必要がある場合、以下の優先順位で検索します：

CLI引数 --api-key（最優先）
auth.json ファイル内の資格情報
環境変数
models.json 内のカスタムプロバイダーのKey

Pi Agent 凭证解析优先级链

つまり、環境変数と auth.json の両方を設定している場合は、auth.json の値が優先されます。

auth.json の高度な機能

auth.json はプレーンテキストのKeyを保存するだけでなく、以下の高度な使い方もサポートしています：

コマンドラインからKeyを取得

使用!プレフィックスを付けてコマンドを実行してKeyを取得します。パスワードマネージャーから読み取る場合に適しています：

{
  "anthropic": {
    "type": "api_key",
    "key": "!security find-generic-password -ws 'anthropic-api-key'"
  },
  "openai": {
    "type": "api_key",
    "key": "!op read 'op://vault/item/credential'"
  }
}

上記の例は、macOS Keychain と 1Password CLI からKeyを取得する方法を示しています。

環境変数の補間

使用$プレフィックスを付けて環境変数を参照します：

{
  "anthropic": {
    "type": "api_key",
    "key": "$MY_ANTHROPIC_KEY"
  }
}

モデルの切り替え

認証を設定すると、使用するAIモデルをいつでも切り替えることができます：

インタラクティブモードでは、/modelコマンド、またはCtrl+Lモデルセレクターを開きます。

使用Ctrl+P / Shift+Ctrl+P設定済みのモデル間で循環して切り替えます。

コマンドラインでモデルを指定する：

# 指定提供商和模型
$ pi --provider anthropic --model claude-sonnet-4-20250514

# 使用 provider/model 格式
$ pi --model openai/gpt-4o "帮我重构这段代码"

# 指定推理等级（thinking level）
$ pi --model sonnet:high "解决这个复杂问题"

推論レベル（Thinking Level）は、モデルが回答する前にどれだけ深く考えるかを制御します。レベルは off（オフ）から max（最大）まであり、推論が深いほど回答品質は高くなる可能性がありますが、消費するトークンも多くなります。

推論レベル	説明	適用シーン
off	推論プロセスを表示しない	簡単なQA、コードフォーマット
minimal	最小限の推論	基本的なコーディングタスク
low	低度の推論	一般的なプログラミングの問題
medium	中度の推論（デフォルト推奨）	日常の開発タスク
high	高度な推論	複雑なアーキテクチャ設計、デバッグ
xhigh	超高度の推論	難しいアルゴリズム問題
max	最大の推論	極めて複雑な論理分析

エディターの枠線の色は推論レベルに応じて変化し、現在の推論の深さを直感的に確認できます。

その他の拡張

参考・お気に入り