概要
手動で設定する場合は、クライアントのインストール、設定ファイルの編集、エンドポイントと API Key の入力が必要です。セットアップスクリプト(evolink-config)は、これらをすべてコマンド 1 つで行います:
- 環境を確認し、クライアントがまだパソコンに入っていなければインストールします
- EvoLink のエンドポイントと API Key を書き込みます
- テストメッセージを 1 通送り、呼び出しが通ることを確認します
- ファイルを変更する前に必ずバックアップし、コマンド 1 つですべて元に戻せます
以下のコマンドは macOS と Linux 用です。Windows の場合は、当面 Claude Code CLI または Codex CLI の手動ガイドに従って設定してください。
前提条件
- EvoLink API Key:EvoLink ダッシュボード にログインし、API Keys で Key を作成してコピーします。Key は
sk-で始まります。 - Node.js:バージョン 22 以上を推奨します(最低 18)。ターミナルで
node -vを実行して確認できます。インストールされていない場合は、Node.js 公式サイト から LTS 版をダウンロードしてください。
Claude Code を設定する
ターミナルで次のコマンドを実行します:1
環境の確認
Node.js と Claude Code を確認します。Claude Code がまだインストールされていない場合、スクリプトが「Install now?」と尋ねます。Enter キーを押すと自動でインストールされます。
2
API Key
EvoLink の API Key を貼り付けて Enter キーを押します。貼り付けた内容は画面に表示されません。スクリプトが Key の有効性をオンラインで確認し、残高を表示します。
3
モデルの選択
Claude Code がデフォルトで使うモデルを選びます。あとから Claude Code の中で
/model を使っていつでも切り替えられます。4
変更内容の確認
スクリプトが変更するファイルと設定の一覧を表示します。Enter キーを押すと適用されます。
5
書き込みと検証
設定を書き込んだあと、スクリプトがテストメッセージを 1 通送ります(約 0.01 クレジット)。正常に応答があれば設定は完了です。
/status を実行します。Anthropic base URL に EvoLink のアドレスが表示されていれば、設定は有効です。
Codex CLI を設定する
ターミナルで次のコマンドを実行します:スクリプトは Codex 用に別のプロファイル
~/.codex/evolink.config.toml を作成し、既存の ~/.codex/config.toml は変更しません。Codex が EvoLink を使うのは -p evolink を付けて起動したときだけで、codex だけで起動した場合は元の設定のままです。スクリプトが変更するファイル
Claude Code
Codex CLI
共通事項
- 変更するファイルは、変更前に
~/.evolink/backups/にバックアップされます。 - スクリプト本体は
~/.evolink/に保存され、コマンドは~/.evolink/bin/evolink-configです。PATH やシェルのプロファイルは変更しません。 - Key はパソコン上の設定ファイルにのみ保存され、EvoLink API にのみ送信されます。
evolink-config は API 接続の設定だけを行います。画像・動画・音声を生成するコマンドラインツール evolink(CLI/MCP セクションを参照)とは別のツールで、両方を使うことができます。確認・元に戻す・再設定
変更内容を事前に確認する(何も書き込みません)
現在の設定を確認する
~/.evolink/bin/evolink-config doctor codex を使います。
設定を元に戻す
~/.evolink/bin/evolink-config reset codex を使います。
Key やデフォルトモデルを変更する
設定コマンドをもう一度実行してください。よくある質問
1. Node.js が見つからないと表示された場合は?
Node.js 公式サイト から LTS 版をインストールし、新しいターミナルを開いてから、設定コマンドをもう一度実行してください。2. すでに手動で設定しています。設定は上書きされますか?
まるごと上書きされることはありません。スクリプトが変更するのは上に挙げた項目だけで、それ以外はそのまま残ります。書き込む前に各項目の変更前と変更後の値を表示し、元のファイルをバックアップします。3. Claude Code で自動モード(auto mode)が使えないのはなぜですか?
自動モードでは、Claude Code はコマンドごとに確認を求めなくなります。その代わり、まず審査リクエストを送り、コマンドを安全に実行できるかどうかをモデルが判断します。この審査リクエストも、ほかのリクエストと同じくトークン単位で課金されます。どのデフォルトモデルを選んだかに関係なく、claude-sonnet-5 が使われます。
想定外の費用が発生しないよう、スクリプトはデフォルトで自動モードをオフにし、Claude Code はコマンドを実行する前に確認を求めます。設定の最後にも、スクリプトがこの点をお知らせします。
自動モードを使いたい場合は、次のようにオンにします:
--auto-mode を付けずに設定コマンドをもう一度実行してください。
4. 実行する前にスクリプトの中身を確認できますか?
はい。ダウンロードして内容を確認してから実行してください:5. 「Rate limited (429)」と表示された場合は?
各アカウントが 1 分間に Key を確認できる回数には上限があります。スクリプトを短時間に何度も実行すると、このメッセージが表示されます。メッセージに表示された秒数だけ待ってから、もう一度実行してください。6. 設定後もうまく動かない場合は?
~/.evolink/bin/evolink-config doctor を実行し、出力をサポートに送ってください。Claude Code CLI と Codex CLI のページにあるトラブルシューティングも参考にしてください。