01｜Claude Code を Crazyrouter に接続するクイックスタートと設定#

本記事は Crazyrouter Claude Code シリーズの第 01 回です。今回は「Claude Code を Crazyrouter に接続するクイックスタートと設定」をテーマに、Claude Code の導入と設定を中心に解説します。

接続先の使い分け：Claude Code / Anthropic ネイティブクライアントでは ANTHROPIC_BASE_URL=https://cn.crazyrouter.com を使用します。OpenAI 互換 SDK、HTTP リクエスト、フロントエンド／バックエンドアプリでは base_url=https://cn.crazyrouter.com/v1 を使用します。

本記事の概要#

• 対象読者：Claude Code を利用中の方、中国産モデルの接続を検討している方、またはチームの呼び出し先を Crazyrouter に統一したい開発者。
• 学べること：Crazyrouter のドキュメントに沿って環境変数を設定する方法、ワークフローの組み立て方、Base URL の記述ミスによる /v1/v1/... 問題を避ける方法。
• 事前準備：Crazyrouter コンソール で専用の API Token を 1 つ作成し、Claude Code 接続ドキュメント を参考に基本設定を完了しておくことをおすすめします。

Claude Code のクイックスタートと設定#

Claude Code をインストールする#

システムは以下の最低要件を満たしている必要があります。

オペレーティングシステム： Linux(Ubuntu 18.04+, CentOS 7+) macOS 10.15+, Windows 10+

ネットワーク接続：安定したインターネット接続

ストレージ容量：少なくとも 500MB の空きディスク容量

Node.js をインストールする#

インストールを始める前に、Node.js と npm のバージョンを確認してください。

ローカル環境に Node.js がまだ入っていない場合は、Node.js 18 LTS 以上のインストールをおすすめします。

• ダウンロード：Node.js 公式サイト
• インストール手順：Node.js 公式ドキュメント

Git をインストールする#

インストールを始める前に、Git のバージョンを確認してください。

ローカル環境に Git がまだ入っていない場合は、利用している OS に合わせてインストール方法を選択できます。

• ダウンロード：Git 公式サイト
• インストール手順：Git 公式ドキュメント

Linux /macOS でのインストール#

Windows でのインストール#

Crazyrouter API Key を設定する#

Claude Code を Crazyrouter に接続する場合は、まず ANTHROPIC_BASE_URL と ANTHROPIC_API_KEY を設定します。通常、記事内で空のプロキシアドレスを記入する必要はありません。

Windows PowerShell：

macOS / Linux：

Git、Node.js、Claude Code をスクリプトで自動チェックしたい場合は、Crazyrouter Claude Code 一括設定スクリプト をそのまま利用できます。

コンソールから claude code を起動する#

ターミナルで claude と入力します。その後、claude にログインし、Crazyrouter Token で認証を完了します。

一、基本操作：コマンドと設定が出発点#

ヘルプコマンドを把握し、できることを広げる#

すばやく使い始めたいなら、まずは claude --help から始めましょう。このコマンドでは、利用可能なすべての引数とコマンドが一覧表示されます。たとえば、-p は非対話形式の出力、-c は直近の会話の継続、--model はモデル指定に使います。よく使う引数を覚えておくと作業効率が大きく上がります。たとえば claude -r で過去のセッションを復元したり、--output-format json で構造化された結果を書き出したりできます。

コマンド	説明	利用シーン
/clear	コンテキストをクリア	最初からやり直したい場合、または AI が問題を解決できなくなっていると感じる場合
/compact	会話を圧縮	会話を立て直したいが、これまでの記憶は失いたくない場合
/cost	コスト	現在のセッションの消費量を確認できる。Crazyrouter コンソールログと照合するのがおすすめ
/logout /login	ログアウト／ログイン	アカウント切り替えなどの操作
/model	モデルを切り替え	Token の権限やモデルのホワイトリストに応じて、利用可能なモデルへ切り替え
/status	ステータス	現在の CC の状態を確認
/doctor	検査	CC のインストール状態を検査

IDE とシームレスに連携し、コーディング中にウィンドウを切り替えない#

VS Code、Cursor などの IDE で Claude Code を使うには、次の 2 ステップだけです。#

• プラグインをインストール： “Claude Code” を検索し、Anthropic 公式版であることを確認してインストールします。

• すばやく起動：ショートカット Cmd+Escape（カスタマイズ可能）で呼び出すか、IDE 画面内の Claude Code アイコンをクリックします。右側にワークスペースが直接表示され、選択したコードの自動コンテキスト投入、diff によるコード変更比較、さらに Alt+Cmd+K による選択内容のプロンプト欄への一括送信にも対応しています。

二、主要モード：シーンに応じて切り替え、効率を最大化する#

自動編集モード：確認なしで一括操作#

逐次確認が不要なファイル作成・変更に適したモードです。Shift+Tab を 1 回押すと有効になり、この状態では Claude が編集操作を自動実行するため、手動確認は不要です。たとえば「かっこいい todolist アプリを作って」と指示すると、ファイル生成と変更をそのまま進めてくれるので、何度も確認する手間を省けます。

Plan モード：初期設計に強いモード#

プロジェクト構築や複雑な問題に取り組む場合は、Shift+Tab を 2 回押して Plan モードを有効にします。まず解決方針の枠組みを整理してくれます。たとえば「ピクセルアート風のモバイル向け todolist」を作る場合、技術スタック、画面構成、適応方針などを自動で計画し、確認後に実装へ進みます。納得できない場合は「再計画して」と伝えれば、期待に合うまで調整できます。

Yolo モード：全権限で任せる#

コードのリファクタリング、新規プロジェクトの立ち上げ、複雑な bug 修正では、claude --dangerously-skip-permissions で Yolo モードに入ります。この状態では Claude により高い権限が与えられ、多くの操作を直接実行できます（安全面に注意が必要なため、サンドボックス環境での利用をおすすめします）。起動後も Shift+Tab でモードを調整でき、権限の粒度を柔軟に切り替えられます。

三、CLAUDE.md：グローバルメモリの中核#

チャットボットとやり取りするとき、「システムプロンプト」が重要であり、AI の挙動に継続的な影響を与えることはよく知られています。CC における CLAUDE.md も、それに近い位置づけです。典型的なワークフローは次のとおりです。

初期の CLAUDE.md を作成 → 会話を続け、長さが上限に近づいたら /compact を実行して延命 → マイルストーンに到達したら、進捗に基づいて CLAUDE.md を更新するよう CC に依頼 → 完了まで繰り返す

このように、CLAUDE.md は継続的に効力を持つグローバル変数のようなものです。また、CC が書き込む際はたいてい十分に要約されるため、可読性も良好です。

CLAUDE.md の注意点

• ファイルを長くしすぎないこと。CC はこのファイルをデフォルトで読み込むためです。
• 会話中は手間を省くために claude.md と言っても、CC は理解できます。
• ファイルにはリマインダーを入れておくと便利です。たとえば「CC が成功を宣言するたびに、必ず証拠ファイルのリンクを添えること」や「プロキシサービスのポートは 9890」などです。会話中に、CC に「claude.md の該当部分を確認して」と依頼できます。
• 公式の「#」でドキュメントに入る機能は、GPT によると不安定な bug があるそうです。

四、セッション管理：暴走を防ぎ、効率よく進める#

いつでも一時停止・ロールバックする#

• 作業中に Esc を押すと現在の操作を一時停止できます。たとえば Claude の依存関係インストールがタイムアウトしたり、方針がずれたりした場合、早めに中断することで無駄な操作を減らせます。
• Esc を 2 回押すと、過去の会話ノードに戻れます（redo 機能はないため、戻る前に確認してください）。
• コードが気に入らない場合は、「前回のコードにロールバックして」と直接伝えれば、Claude が以前のバージョンを自動で復元します。

履歴の上限に対応する#

セッションに “Context left until auto-compact: 3%” と表示された場合、履歴がほぼ満杯であることを意味します。この時点で自動圧縮（約 150 秒）がトリガーされますが、/compact コマンドを手動で実行して延命し、会話の中断を避けることもできます。#

履歴の復元と確認#

• claude -c で前回の会話に直接入れます。
• claude -r で過去のセッションを選択して復元できます。途中で終了した作業を再開する場合に便利です。

五、リソース監視とバッチタスク：ペースを管理して無駄を減らす#

token 使用量をリアルタイム監視する#

毎日／毎時どれくらいのリソースを消費しているか知りたい場合は、npx ccusage@latest を実行して日別の使用量を確認できます。npx ccusage blocks --live を使うと、消費速度をリアルタイムで監視できます。速度が速すぎる場合は、git commit など token を消費しやすい操作を手動で処理し、超過を避けましょう。

バッチタスクを効率よく処理する#

数十件の繰り返しタスク（たとえばドキュメント章の一括生成）を実行する場合は、スクリプト形式の使い方が便利です。

1. タスクを 1 行 1 件で TASK.md に書き込みます。
2. 次のコマンドを実行します。

timeout を追加して単一タスクのハングを防ぎつつ、--allowedTools "Edit" で権限を制限して予期しない操作を避けることもできます。並列実行は避けてください。制限に引っかかり、ブロックされる可能性があります。

六、落とし穴と応用：Claude をより “指示どおり” に動かす#

自由度を与えつつ、防御策も用意する#

• auto-accept edits（Shift+Tab で切り替え）を有効にすると、Claude がファイルを自動編集できます。git のバージョン管理と組み合わせれば、誤操作を恐れずに使えます。
• Bash コマンドを実行する場合は、Docker で環境を分離するか、btrfs ファイルシステムでスナップショットを作成します。権限を広く与えつつ、すばやくロールバックできます。
• セッションディレクトリに ssh key などの機密情報を置かないようにしましょう。別マシンへの操作リスクを防ぐためです。

“見せかけの成果” を徹底的に防ぐ#

Claude はたまに “大げさに言う” ことがあります。たとえば、テストが完了していないのに成功したと宣言するケースです。CLAUDE.md に「成功を宣言するたびに、必ず証拠ファイルのリンクを添えること」というルールを追加し、定期的に「本当に完了した？証拠はある？」と確認しましょう。問題が見つかったらすぐ修正させます。

これらのコツを押さえると、Claude Code は単なる “ツール” から “頼れる相棒” へ変わります。日常のコーディング、プロジェクト管理、バッチ処理のいずれでも、効率を大きく高められます。重要なのは、必要に応じてモードを切り替えること、グローバルメモリを使いこなすこと、そして適切な監視と防御策を組み合わせることです。そうすれば、その価値を最大限に引き出せます。

---

関連記事#

• 次の記事：第 02 回
• 設定ドキュメント：Claude Code を Crazyrouter に接続する
• API アドレスの説明：Base URL と /v1 の使い方
• 一括設定スクリプト：Crazyrouter Claude Code 一括設定スクリプト

Crazyrouter への接続を始める#

Claude Code、中国産モデル、または自分のアプリケーションを Crazyrouter に統一して接続する場合は、次の順序で進めるとよいでしょう。

1. Crazyrouter コンソール で専用の API Token を作成し、プロジェクトまたはチーム単位で権限を個別に管理します。
2. Claude Code ではルートドメイン https://cn.crazyrouter.com を使用します。OpenAI 互換 SDK では https://cn.crazyrouter.com/v1 を使用します。
3. 環境の自動チェックや設定のすばやい書き込みが必要な場合は、Crazyrouter Claude Code 一括設定スクリプト を使用します。
4. デバッグに失敗した場合は、まずコンソールログを確認し、次に API Endpoint の説明 を照合します。特に Base URL に余分な /v1 を書いていないか確認してください。

モデルコストを見積もったり、別のモデルを選択したりする必要がある場合は、まず Crazyrouter の価格とモデルページ を確認し、そのうえでよく使うモデルを Token のホワイトリストに追加してください。