Pi Coding Agent

​

概要

​

始める前に

​

1.Pi コーディング エージェント CLI をインストールする

• カールスクリプト
• npm

curl -fsSL https://pi.dev/install.sh | bash

npm install -g --ignore-scripts @earendil-works/pi-coding-agent

インストール中に npm warn deprecated node-domexception@1.0.0 などの 非推奨の警告 が表示された場合は、無視しても問題ありません。これは上流の依存関係に由来するものであり、インストールや使用には影響しません。最後に added N packages が表示され、pi --version がバージョン番号を出力する限り、インストールは成功しています。公式のインストール コマンドには、--ignore-scripts が含まれています (インストール中に依存関係のライフサイクル スクリプトをスキップします。Pi の通常のインストールではそれらは必要ありません)。最初の実行時に、Pi は必要に応じて ripgrep や fd などのネイティブ ツールを自動的にダウンロードします。パッケージ名 @earendil-works/pi-coding-agent が正しいことを確認してください。npm には、同じ名前のフォーク @oh-my-pi/pi-coding-agent (別のバージョン ライン) と非推奨の @mariozechner/pi-coding-agent (メンテナーは、earendil-works バージョンに切り替える必要があると指摘しています) もあります。間違ったものをインストールしないでください。

pi --version

​

2. EvoLink API キーを取得する

• EvoLink コンソール にログインします。
• コンソールで API キーを見つけて、[新しいキーの作成] ボタンをクリックし、生成されたキーをコピーします。
• API キーは通常、sk- で始まります。大切に保管してください。

​

ステップ 1: EvoLink プロバイダーを構成する

mkdir -p ~/.pi/agent && nano ~/.pi/agent/models.json

mkdir -Force "$HOME\.pi\agent"; notepad "$HOME\.pi\agent\models.json"

{
  "providers": {
    "evolink": {
      "name": "EvoLink Direct",
      "baseUrl": "https://direct.evolink.ai",
      "apiKey": "$EVOLINK_API_KEY",
      "authHeader": true,
      "api": "anthropic-messages",
      "models": [
        { "id": "claude-fable-5",            "reasoning": true,  "contextWindow": 1000000, "maxTokens": 128000,
          "cost": {"input": 9.0, "output": 45.0, "cacheRead": 0.9, "cacheWrite": 11.25} },
        { "id": "claude-sonnet-5",           "reasoning": false, "contextWindow": 1000000, "maxTokens": 64000,
          "cost": {"input": 2.7, "output": 13.5, "cacheRead": 0.27, "cacheWrite": 3.375} },
        { "id": "claude-haiku-4-5-20251001", "reasoning": false, "contextWindow": 200000,  "maxTokens": 64000,
          "cost": {"input": 0.9, "output": 4.5, "cacheRead": 0.09, "cacheWrite": 1.125} }
      ]
    }
  }
}

• api: "anthropic-messages" — EvoLink の Anthropic メッセージ互換ルートを使用するため、Pi はクロードのネイティブ tool_use / tool_result プロトコルを使用します。
• baseUrl をドメイン ルートにのみ設定します https://direct.evolink.ai — /v1 または /v1/messages を手動で追加しないでください**。 Pi は /v1/messages を自動的に追加します。手動で追加するとパスが複製され、404 Invalid URL が発生します。
• authHeader: true は必須です。 Pi の Anthropic SDK はデフォルトで x-api-key を使用しますが、EvoLink の /v1/messages は Authorization: Bearer <your-key> を想定しています。このフィールドにより、Pi は正しいベアラー認証ヘッダーを送信します。
• apiKey には 2 つの形式があります - 1 つを選択してください:
  • オプション 1 · キーを直接貼り付けます (最も簡単で、ローカルでの個人使用に適しています): 設定内の "$EVOLINK_API_KEY" を実際のキーに置き換えます。 "apiKey": "sk-your-real-key"。ワンステップで完了し、環境変数は必要ありません。欠点は、キーが構成ファイル内のプレーンテキストに存在するため、このファイルを共有したり、Git にコミットしたりしないでください。
  • オプション 2 · 環境変数の補間 (より安全、推奨): "$EVOLINK_API_KEY" をそのままにして、実際のキーを環境変数に置きます (下記の「API キー環境変数の設定」を参照)。これにより、プレーンテキストのキーが構成ファイルに保存されなくなります。
  • (上級) Pi の apiKey は、${EVOLINK_API_KEY} (同等。変数名の直後にリテラル テキストが続く場合は中括弧を使用して曖昧さをなくす) および !command (先頭の ! がコマンドを実行し、その出力をキーとして使用します。たとえば、パスワード マネージャーからの読み取り: "!op read 'op://vault/item/credential'") もサポートします。値にリテラルの **(上級)** Pi の apiKey は、${EVOLINK_API_KEY}` (同等。変数名の直後にリテラル テキストが続く場合は中括弧を使用して曖昧さをなくす) および `!command` (先頭の `!` がコマンドを実行し、その出力をキーとして使用します。たとえば、パスワード マネージャーからの読み取り: `"!op read 'op://vault/item/credential'"`) もサポートします。値にリテラルの または `!` が必要な場合は、`$および$!` としてエスケープします。

​

API キー環境変数を設定する

export EVOLINK_API_KEY=your_EvoLink_API_Key

# If you use zsh (the default on modern macOS)
echo 'export EVOLINK_API_KEY=your_EvoLink_API_Key' >> ~/.zshrc
source ~/.zshrc

# If you use bash
echo 'export EVOLINK_API_KEY=your_EvoLink_API_Key' >> ~/.bashrc
source ~/.bashrc

$env:EVOLINK_API_KEY = "your_EvoLink_API_Key"

setx EVOLINK_API_KEY "your_EvoLink_API_Key"

​

ステップ 2: 使用を開始して確認する

​

1. モデルの選択

pi

​

2. 構成を確認する

who are you

List the files in the current directory and tell me which ones are Markdown files.

• AI の通常の応答 (数行のテキスト) が表示されます。
• Pi は 2 番目のタスクで ls ツールを呼び出し、応答を続けることができます。
• 401、404、model_not_found、Unexpected role "tool" などのエラーはありません。

​

トラブルシューティング

​

401 (無効な API キー) を返します

{"code":"unauthorized","message":"Invalid API key (request id: ...)"}

• 環境変数が有効になりませんでした (最も一般的な): 現在のターミナルで test -n "$EVOLINK_API_KEY" && echo "Key loaded" || echo "Key not loaded" を実行します。 Windows では、setx を使用した後に ターミナルを再起動する必要があります。
• apiKey フィールドは間違っています。変数名をリテラル キーとして扱うのではなく、models.json に "$EVOLINK_API_KEY" (環境変数を参照) が含まれていることを確認してください。
• "authHeader": true がありません: EvoLink の /v1/messages にはベアラー トークンが必要なので、このフィールドが apiKey と同じプロバイダー構成内にあることを確認してください。
• キー自体が無効であるか、無効になっています。EvoLink コンソール で確認してください。

​

404 Invalid URLを返します

{"message":"Invalid URL (POST /v1/v1/messages)","type":"invalid_request_error"}

​

404 model_not_foundを返します

{"code":"model_not_found","message":"Model '...' is not available for this API key ... Call GET /v1/models ..."}

​

400 Unexpected role "tool"を返します

400: messages: Unexpected role "tool". Allowed roles are "user" or "assistant".

{
  "baseUrl": "https://direct.evolink.ai",
  "authHeader": true,
  "api": "anthropic-messages"
}

​

コストについて

​

よくある質問

​

コマンドラインターミナルを開くにはどうすればよいですか?

​

1. baseUrl をドメイン ルートのみに設定するのはなぜですか?

​

2. authHeader: true を設定する必要がありますか?

​

3. このガイドが端末 CLI に従っているのはなぜですか?

​

4. API キーを構成にプレーンテキストで書き込まないようにするにはどうすればよいですか?

​

5. EvoLink はどの一般的なモデルをサポートしていますか?

​

6. 使用状況を確認するにはどうすればよいですか?