ドキュメント

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 --version
2
npm --version

どちらかのコマンドが見つからない場合は、先に Node.js をインストールしてください。npm は Node.js に付属しています。

macOS(Homebrew)

1
brew install node

Ubuntu / Debian

1
sudo apt update
2
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 --version
2
codex --version
3
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 の料金を比較し、ワークロードに合うモデルを選んでください。