Claude Code 代理配置ツール

Tool
Claude Code 代理配置ツール

Claude Code 代理配置ツール

Claude Codeのコマンドラインツールをプロキシ経由で利用するための自動設定ツールです。Node.js環境下で動作し、設定ファイルの自動更新やバックアップ機能を備え、jqやPython3を活用してJSONを安全に操作します。プロキシAPIアドレスやキーの設定を簡単に行い、Claude Codeの利便性を高める実用的なユーティリティです。

https://github.com/tingxifa/claude_proxy

概要

claude_proxyは、Claude Codeという大規模言語モデル向けのコマンドラインツールの設定を自動化し、プロキシ経由でのアクセスを可能にするシェルスクリプトツールです。Node.js環境で動作し、ユーザーの~/.claude/settings.jsonを安全にバックアップしつつ、jqやPython3を利用してJSON設定ファイルをスマートに書き換えます。APIのエンドポイントやアクセスキーの設定を自動で行うため、ユーザーは手動で複雑な設定を行う必要がなく、手軽にClaude Codeをプロキシ経由で利用可能です。

GitHub

リポジトリの統計情報

  • スター数: 18
  • フォーク数: 3
  • ウォッチャー数: 18
  • コミット数: 4
  • ファイル数: 4
  • メインの言語: TypeScript

主な特徴

  • Claude Codeコマンドラインツールの自動インストールチェックとセットアップ
  • ~/.claude/settings.jsonの安全なバックアップと自動編集
  • jqまたはPython3による柔軟なJSON設定ファイル操作をサポート
  • プロキシAPIアドレスとAPIキーを簡単に設定可能

技術的なポイント

claude_proxyの最大の特徴は、Claude Code CLIツールの設定ファイルを自動かつ安全に書き換える点にあります。設定ファイルはJSON形式で保存されており、APIのエンドポイントや認証情報を直接編集する必要がありますが、手動編集はミスや設定漏れを引き起こしやすい問題があります。そこで本ツールは、実行前に必ず既存の設定ファイルをバックアップし、jqやPython3を用いてJSONをパース・編集することで、ファイルの破損リスクを低減しています。

さらに、jqが利用できない環境ではPython3のスクリプトにフォールバックして設定変更を行うため、環境依存性を排除しつつ幅広いシステムで動作可能です。Node.jsとnpmを前提としているのは、Claude Code自体のインストールや実行に必要だからであり、claude_proxyはそれらの依存関係も含めた一連の準備を自動化します。

設定内容としては、プロキシAPIのURLや認証キーをユーザーが指定しやすいようにスクリプトが対話的またはコマンドパラメータで受け取り、~/.claude/settings.jsonの該当フィールドに反映させます。また、環境変数やシェルスクリプトを活用し、柔軟かつ拡張性の高いカスタマイズも可能です。

これにより、たとえば企業ネットワーク内で直接Claude APIにアクセスできない環境でも、代理サーバーを通じて安全かつ効率的に利用できるようになるため、開発者の利便性が大幅に向上します。

プロジェクトの構成

主要なファイルとディレクトリ：

  • README.md: ツールの概要や使い方を記述したファイル
  • claude_proxy.sh: プロキシ設定およびClaude Codeの自動構成を行うシェルスクリプト
  • src: TypeScriptソースコードを格納するディレクトリ
  • wrangler.toml: Cloudflare Workersの設定ファイル（サーバーレス環境用）

まとめ

Claude Codeのプロキシ設定を自動化し、安全かつ簡単に環境構築可能な実用ツール。

リポジトリ情報：