declaude

declaude

Claude語から平易な英語へ。サービスとして提供します。
へつらう前置き、中身のない最上級表現、曖昧な言い回しを取り除きます。
意味、コード、構成はそのまま保たれます。

---

Before  "Great question! Before I answer, let me make sure I understand what
        you're asking. You want to know why the build is failing. Let me walk
        through my thinking, and then I'll give you the answer."

After   "I understand you want to know why the build is failing. Here's what
        I think is happening."

Before  "One thing I didn't touch, but you won't want to leave hanging, is the
        migration script. I'd be happy to walk you through it whenever you're
        ready!"

After   "One thing I didn't cover is the migration script. When you're ready,
        I can go through it with you."

オープンソースモデル（Qwen2.5-14B-AWQ）を自社のL4 GPUで実行しているため、テキストが商用AIプロバイダーに届くことはありません。モデルサーバーではプロンプトのログ記録を無効にしています。テキストはメモリ上で処理されて破棄され、ディスク、データベース、ログに書き込まれることはありません。

ライブ版：speak-english.tenken.co · API キーを取得 · ドキュメントを翻訳

	無料	月額 $5
翻訳	月100回	無制限
ドキュメント	月5件、200 KB	月500件、2 MB
カードの登録	不要	必要

クイックスタート

Claude Codeでプラグインをインストールします。スキルが導入され、フックが登録されます。

/plugin marketplace add tenkenco/declaude
/plugin install declaude@tenken

次に /declaude:setup を実行します。手動で設定したフックがあれば安全に移行し、dk_ キーを設定します。 Claude Codeはキーをセキュアなプラグイン設定に保存します。キーが設定されると、フックが応答を書き換えます。停止するには hook_enabled オプションを false に設定してください。キーがない場合、フックは何もせず、セッションをブロックすることもありません。

MCP サーバーだけを使う場合は、Claude Codeまたはその他のMCPクライアントで次のように設定します。

claude mcp add --transport http declaude https://speak-english.tenken.co/mcp

貼り付けるAPIキーは不要です。クライアントがOAuthを検出してブラウザーでのサインインを開き、トークンを保持します。設定はこれで完了です。

利用方法	用途	ドキュメント
MCP サーバー	Claude Code、Cursor、任意のMCPクライアント。ツール：translate、usage	スキル
Claude Codeフック	応答の表示と同時に書き換え、Claudeのトークンを消費しません。プラグインが登録します	hook/
ドキュメント	.md／.txt をドロップすると、書き換えたファイルが返されます	ウェブ
REST API	POST /v1/translate、/v1/documents、/v1/usage	スキル
OpenAI互換	POST /v1/chat/completions — 任意のOpenAIクライアントで /v1 を指定します	スキル

使い方、認証、クォータの動作について詳しくは、 skills/declaude/SKILL.md をご覧ください。エージェントスキルとしてインストールできるため、 エージェントが直接内容を読み取れます。

アーキテクチャ

client ── API key / OAuth / Clerk JWT ──> Cloud Run gateway ── VPC ──> internal LB ──> vLLM GPU MIG
                                              │                                    (Qwen2.5-14B, spot L4)
                                              ├─> Firestore (usage, paid flags, key hashes)
                                              └─> Stripe (payment link + signed webhooks)

• gateway/ — FastAPI です。すべての境界で依存性を注入できるため、ネットワーク、GPU、クラウドの認証情報なしでテストスイートを実行できます。
• infra/ — Terraform を使用し、状態は GCS に保存します。プランを適用すると差分がゼロに収束します。GPU 層は、内部 L7 ロードバランサーの背後にあるプライベート IP のスポットインスタンスです。
• hook/ — Claude Code のフッククライアントです。処理に失敗してもそのまま通し、セッションをブロックすることはありません。
• hooks/ — hooks.json は、インストール時に Claude Code が読み込むプラグイン登録ファイルです。
• CI — すべての PR で lint、テスト、カバレッジを実行し、セキュリティスキャンと本番環境のスモークテストを毎日実行します。

運用上の注意事項

• run.app では /healthz が Google Frontend によって予約されています。/health を使用してください。
• モデルの切り替えは Terraform の変数 1 つで行えます。32B には 2×L4（クォータの引き上げが必要）、14B には L4 が 1 基あれば十分です。
• MIG テンプレートのロールアウトは意図的に OPPORTUNISTIC にしています。以前は積極的なポリシーにより、問題のないテンプレート編集が予期しない 15 分間の停止につながっていました。
• シークレットは Secret Manager のみに保存します。API キーは SHA-256 ダイジェストとして保存されるため、データベースが漏えいしても使用可能な認証情報は得られません。
• モデルサーバーではプロンプトのログ記録を無効にしています。リクエストのテキストはメモリ内で処理され、破棄されます。
• テストファーストで開発しました。実際の使用中に見つかった本番環境の不具合はすべて、修正前に回帰テストに追加しました。

開発

cd gateway
uv sync --dev
uv run pytest -q          # 197 tests
uv run ruff check .

クレジット

gvzdv/claudish-to-english を起点に開発しました。これは元となったローカル Ollama フックです。MIT ライセンスで提供されており、上流の告知はTHIRD_PARTY_LICENSES.mdにあります。