Claude Code・Codex・Gemini CLI 導入
npm で Claude Code、Codex、Gemini CLI のいずれかをインストールし、Code By AI に接続して、テストリクエストで設定を確認する手順を解説します。Node.js の確認から最初の呼び出しまで進められます。
1. Node.js と npm を確認する
現行の Node.js LTS を使用してください。まず、すでにインストールされているものを確認します。
1 node --version2 npm --version
どちらかのコマンドが見つからない場合は、先に Node.js をインストールしてください。npm は Node.js に付属しています。
macOS(Homebrew)
1 brew install node
Ubuntu / Debian
1 sudo apt update2 sudo apt install nodejs npm
Windows
nodejs.org から現行 LTS のインストーラーをダウンロードし、Node.js を PATH に追加するオプションを有効にしたまま実行します。インストール後に新しいターミナルを開き、バージョンを再確認してください。
複数の Node.js バージョンを管理している場合は、システムの Node.js を変更せず、普段使っているバージョン管理ツールを使用してください。
2. 必要なコーディングクライアントをインストールする
実際に使うツールだけをインストールします。
Claude Code
1 npm install -g @anthropic-ai/claude-code
Codex
1 npm install -g @openai/codex
Gemini CLI
1 npm install -g @google/gemini-cli
インストールを確認し、CLI が PATH 上にあることを確認します。
1 claude --version2 codex --version3 gemini --version
インストールしたクライアントだけを確認すれば構いません。バージョン番号が表示されればパッケージのインストールは成功ですが、API 接続が動くことの確認は別途必要です。
3. Code By AI を設定する
Code By AI のダッシュボードでキーを作成し、クライアントをゲートウェイに向けます。キーはソース管理に入れず、可能な限りシェル履歴にも残さないでください。
Claude Code に必要なのは、エンドポイントとトークンの 2 つの変数です。
macOS / Linux(Bash / Zsh)
1 export ANTHROPIC_BASE_URL="https://www.codebyai.net/api/agent"2 export ANTHROPIC_AUTH_TOKEN="sk-proj-xxxx"
Windows PowerShell
1 $env:ANTHROPIC_BASE_URL = "https://www.codebyai.net/api/agent"2 $env:ANTHROPIC_AUTH_TOKEN = "sk-proj-xxxx"
Windows CMD
1 set "ANTHROPIC_BASE_URL=https://www.codebyai.net/api/agent"2 set "ANTHROPIC_AUTH_TOKEN=sk-proj-xxxx"
使用するターミナルに合ったコマンドを選び、sk-proj-xxxx を実際のキーに置き換えてください。これらの変数は現在のターミナルだけに適用されるため、下のスモークテストも同じウィンドウで実行してください。永続化するには、macOS / Linux では export の行を ~/.zshrc または ~/.bashrc に追加し、Windows では Windows の設定手順に従ってください。~/.claude/settings.json を使う場合は JSON 設定例に従って env オブジェクトに変数を入れ、シェルコマンドをそのまま貼り付けないでください。
他のクライアントでは、設定ファイルと変数名が異なります。
どの変数をどのファイルに設定するか不明な場合は、環境変数リファレンスを参照してください。シェル、settings.json、VS Code、TypeScript、Python、YAML、TOML、INI、.env の例を掲載しています。
4. 最初のリクエストを実行する
Claude Code では print モードを使うと、応答後にコマンドが終了します。
1 claude -p "Reply with exactly: setup ok"
setup ok と返ってくれば、CLI のインストール、ゲートウェイでのキー認証、モデルの応答の 3 点が確認できます。コマンドが止まる場合や認証エラーが返る場合は、CLI を再インストールする前に以下を確認してください。
トラブルシューティング
node: command not found または npm: command not found。 Node.js がインストールされていないか、ターミナルが PATH を再読み込みしていません。Node.js をインストールし、ターミナルを閉じてから再試行してください。
npm のグローバルインストール後に claude: command not found。 npm がグローバルな実行ファイルを置く場所を確認します。
1 npm prefix -g
グローバルな実行ファイルのディレクトリを PATH に追加してください。{prefix} は npm prefix -g が出力したディレクトリを指します。
- macOS / Linux:
{prefix}/binを追加します。 - Windows:
{prefix}自体を追加し、末尾にbinを付けないでください。
PATH を更新したら、新しいターミナルを開いて claude --version を再実行してください。macOS と Linux では、sudo でグローバルパッケージを入れるより、nvm などのバージョン管理ツールを使う方が適しています。
npm install -g で EACCES や権限エラー。 まず sudo は使わず、Node.js のバージョン管理ツールか、ユーザーが書き込める npm グローバルプレフィックスを使用してください。
401、invalid api key、認証エラー。 ANTHROPIC_AUTH_TOKEN に Code By AI のキーが入っていること、同時に ANTHROPIC_API_KEY を設定していないことを確認してください。2 つの変数は異なるヘッダーを使うため、どちらか一方だけを設定します。
Code By AI ではなく Anthropic にリクエストが行く。 ANTHROPIC_BASE_URL が https://www.codebyai.net/api/agent であること、CLI を起動する環境にも設定されていることを確認してください。VS Code 拡張パネルには、シェルの export だけでなく claudeCode.environmentVariables が必要です。
長いリクエストがタイムアウトする。 失敗した時刻とゲートウェイのログを確認してください。Anthropic Messages のストリーミングには開始待ち、無通信、全体の期限があり、非ストリーミング要求の全体上限は295秒のままです。API_TIMEOUT_MS を増やしてもこれらの期限は延びません。すぐに失敗する場合はエンドポイントと API キーを確認してください。
設定変更が反映されない。 CLI を再起動するか、VS Code で Developer: Reload Window を実行してください。環境変数はプロセス開始時に読み込まれます。
次のステップ
- Claude Code 環境変数リファレンス
- Claude Code セットアップガイド
- Codex セットアップガイド
- Gemini CLI セットアップガイド
- モデルとトークンの料金
- 自分のスクリプトや SDK は API クイックスタート
スモークテストに合格したら、Claude Code の料金を比較し、ワークロードに合うモデルを選んでください。