gRPC Practical Guide with Claude Code

gRPC開発をClaude Codeで効率化する

gRPCはGoogleが開発した高効率なRPCフレームワークで、Protocol Buffersによる型安全な通信が特徴です。Claude Codeを使えば、Proto定義からサーバー/クライアント実装まで効率よく進められます。

Protocol Buffers定義

サービス定義の作成

> ユーザー管理サービスのProto定義を作成して。
> CRUD操作とページネーション対応の一覧取得を含めて。

// proto/user/v1/user.proto
syntax = "proto3";

package user.v1;

option go_package = "gen/user/v1;userv1";

service UserService {
  rpc GetUser(GetUserRequest) returns (GetUserResponse);
  rpc ListUsers(ListUsersRequest) returns (ListUsersResponse);
  rpc CreateUser(CreateUserRequest) returns (CreateUserResponse);
  rpc UpdateUser(UpdateUserRequest) returns (UpdateUserResponse);
  rpc DeleteUser(DeleteUserRequest) returns (DeleteUserResponse);
  // サーバーストリーミング：大量ユーザーのエクスポート
  rpc ExportUsers(ExportUsersRequest) returns (stream User);
}

message User {
  string id = 1;
  string name = 2;
  string email = 3;
  UserRole role = 4;
  google.protobuf.Timestamp created_at = 5;
  google.protobuf.Timestamp updated_at = 6;
}

enum UserRole {
  USER_ROLE_UNSPECIFIED = 0;
  USER_ROLE_ADMIN = 1;
  USER_ROLE_MEMBER = 2;
  USER_ROLE_VIEWER = 3;
}

message GetUserRequest {
  string id = 1;
}

message GetUserResponse {
  User user = 1;
}

message ListUsersRequest {
  int32 page_size = 1;
  string page_token = 2;
  string filter = 3;
}

message ListUsersResponse {
  repeated User users = 1;
  string next_page_token = 2;
  int32 total_count = 3;
}

message CreateUserRequest {
  string name = 1;
  string email = 2;
  UserRole role = 3;
}

message CreateUserResponse {
  User user = 1;
}

サーバー実装（Go）

> 上記Proto定義のgRPCサーバーをGoで実装して。
> エラーハンドリングとインターセプターも含めて。

// internal/server/user.go
package server

import (
    "context"
    pb "myapp/gen/user/v1"
    "google.golang.org/grpc/codes"
    "google.golang.org/grpc/status"
)

type UserServer struct {
    pb.UnimplementedUserServiceServer
    repo UserRepository
}

func (s *UserServer) GetUser(
    ctx context.Context,
    req *pb.GetUserRequest,
) (*pb.GetUserResponse, error) {
    if req.Id == "" {
        return nil, status.Error(codes.InvalidArgument, "IDは必須です")
    }

    user, err := s.repo.FindByID(ctx, req.Id)
    if err != nil {
        return nil, status.Error(codes.NotFound, "User not found")
    }

    return &pb.GetUserResponse{User: toProtoUser(user)}, nil
}

func (s *UserServer) ExportUsers(
    req *pb.ExportUsersRequest,
    stream pb.UserService_ExportUsersServer,
) error {
    users, err := s.repo.FindAll(stream.Context())
    if err != nil {
        return status.Error(codes.Internal, "データ取得に失敗しました")
    }

    for _, user := range users {
        if err := stream.Send(toProtoUser(user)); err != nil {
            return err
        }
    }
    return nil
}

クライアント実装（TypeScript）

// src/client/userClient.ts
import { createClient } from '@connectrpc/connect';
import { createGrpcTransport } from '@connectrpc/connect-node';
import { UserService } from '../gen/user/v1/user_connect';

const transport = createGrpcTransport({
  baseUrl: 'https://api.example.com',
  httpVersion: '2',
});

const client = createClient(UserService, transport);

// 型安全なAPI呼び出し
const response = await client.getUser({ id: 'user-123' });
console.log(response.user?.name);

// ストリーミング
for await (const user of client.exportUsers({})) {
  console.log(user.name);
}

インターセプター（ミドルウェア）

認証、ロギング、メトリクス収集などの横断的関心事はインターセプターで実装します。Claude Codeに「認証インターセプターを追加して」と依頼すれば、JWTトークン検証のインターセプターを生成してくれます。

REST APIとの比較

項目	gRPC	REST
プロトコル	HTTP/2	HTTP/1.1 or HTTP/2
データ形式	Protocol Buffers	JSON
型安全性	強い	ツール依存
ストリーミング	ネイティブ対応	WebSocket等が必要
ブラウザ対応	gRPC-Web必要	ネイティブ

Summary

Claude Codeを使えば、gRPCのProto定義からサーバー/クライアント実装まで効率よく進められます。マイクロサービス設計やAPI開発ガイドも合わせて参考にしてください。

gRPCの詳細はgRPC公式ドキュメントを参照してください。