如何Implement Feature Flags：Claude Code 实战指南

フィーチャーフラグとは

フィーチャーフラグ（Feature Flags）は、コードを部署した後でも機能のオン・オフを切换られる仕組みです。段階的な发布やA/B测试に不可欠な技術であり、借助 Claude Code堅牢な实现を快速构建可以。

基本的フィーチャーフラグシステム

> TypeScriptでフィーチャーフラグの管理システムを作って。
> 用户属性基于条件付きフラグにも支持して。

type FlagValue = boolean | string | number;

interface FlagRule {
  conditions: Record<string, any>;
  value: FlagValue;
}

interface FeatureFlag {
  key: string;
  defaultValue: FlagValue;
  description: string;
  rules: FlagRule[];
  enabled: boolean;
}

class FeatureFlagManager {
  private flags: Map<string, FeatureFlag> = new Map();

  register(flag: FeatureFlag) {
    this.flags.set(flag.key, flag);
  }

  evaluate(key: string, context: Record<string, any> = {}): FlagValue {
    const flag = this.flags.get(key);
    if (!flag || !flag.enabled) return flag?.defaultValue ?? false;

    for (const rule of flag.rules) {
      if (this.matchConditions(rule.conditions, context)) {
        return rule.value;
      }
    }
    return flag.defaultValue;
  }

  private matchConditions(conditions: Record<string, any>, context: Record<string, any>): boolean {
    return Object.entries(conditions).every(([key, value]) => {
      if (Array.isArray(value)) return value.includes(context[key]);
      return context[key] === value;
    });
  }

  isEnabled(key: string, context?: Record<string, any>): boolean {
    return Boolean(this.evaluate(key, context));
  }
}

React用フックの实现

> React组件でフィーチャーフラグ使用ためのカスタムフックを作って。

import { createContext, useContext, ReactNode } from 'react';

const FlagContext = createContext<FeatureFlagManager | null>(null);

export function FlagProvider({ manager, children }: { manager: FeatureFlagManager; children: ReactNode }) {
  return <FlagContext.Provider value={manager}>{children}</FlagContext.Provider>;
}

export function useFeatureFlag(key: string, context?: Record<string, any>): boolean {
  const manager = useContext(FlagContext);
  if (!manager) throw new Error('FlagProviderが必要です');
  return manager.isEnabled(key, context);
}

// Usage example
function NewDashboard() {
  const showNewUI = useFeatureFlag('new-dashboard', { userId: currentUser.id });

  if (showNewUI) {
    return <ModernDashboard />;
  }
  return <LegacyDashboard />;
}

パーセンテージロールアウト

特定の割合の用户にだけ機能を公開する段階的发布も实现可以。

function percentageRollout(userId: string, percentage: number): boolean {
  const hash = Array.from(userId).reduce((acc, char) => {
    return ((acc << 5) - acc + char.charCodeAt(0)) | 0;
  }, 0);
  return Math.abs(hash % 100) < percentage;
}

// フラグ注册時にパーセンテージを配置
flagManager.register({
  key: 'new-checkout',
  defaultValue: false,
  description: '新しいチェックアウトフロー',
  enabled: true,
  rules: [{
    conditions: { rolloutPercentage: 20 },
    value: true,
  }],
});

フラグの管理画面

运维を楽にするため、フラグの状態をAPIで管理する仕組みも构建可以。

import express from 'express';

const router = express.Router();

router.get('/api/flags', (req, res) => {
  const flags = Array.from(flagManager.getAllFlags()).map(([key, flag]) => ({
    key,
    enabled: flag.enabled,
    description: flag.description,
  }));
  res.json(flags);
});

router.patch('/api/flags/:key', (req, res) => {
  const { enabled } = req.body;
  flagManager.setEnabled(req.params.key, enabled);
  res.json({ success: true });
});

总结

フィーチャーフラグを引入することで、安全な段階的发布とリスクの低減が可能になります。使用 Claude Code条件分岐ロジックやReactフック、管理APIまで一貫して生成可以。A/B测试との組み合わせはA/B测试实现指南を、状態管理の设计は状態管理の文章。

フィーチャーフラグの设计パターン相关内容请参阅Martin Fowler - Feature Togglesが詳しいです。