---
title: 거시경제
description: FRED(Federal Reserve Economic Data) 핵심 거시경제 지표 8개, 경제 스트레스 지수, 거시경제 레짐 판정을 한 화면에 매일 갱신해 보여줍니다. 포트폴리오가 처한 거시 환경을 항상 파악할 수 있습니다.
---

export const reasons = [
  {
    icon: 'VIX',
    title: '공포 지수',
    desc: 'VIX가 30 이상이면 불확실성이 커진 상태입니다. VIX가 높을 때 포트폴리오는 거시 뉴스에 더 크게 반응합니다. 기준선을 알아야 신호와 잡음을 구분할 수 있습니다.',
  },
  {
    icon: '10Y',
    title: '금리 환경',
    desc: '10년물 금리는 주식의 할인율 역할을 합니다. 10년물 상승은 성장주 밸류에이션을 압축하며, 수익률 곡선(10Y 빼기 2Y)이 역전되면 신뢰성 있는 경기 침체 신호로 작동합니다.',
  },
  {
    icon: 'FX',
    title: '환율 영향',
    desc: '홈 통화가 KRW나 JPY라면 USD 강세가 실질 수익률에 직접 영향을 줍니다. Firma는 현재 환율과 30일/90일 변화를 함께 표시합니다.',
  },
];

export const percentileRows = [
  { cmd: <span style={{ color: 'var(--red)' }}>≥ p80</span>,  desc: '역사적으로 높음. 오늘 값이 최근 5년 일별 관측치의 80%보다 높습니다. 빨간색 표시.' },
  { cmd: 'p60 - p80', desc: '평균 이상. 최근 이력 대비 다소 높은 수준.' },
  { cmd: 'p20 - p60', desc: '정상 범위. 일반적인 역사적 범위 내. 회색 표시.' },
  { cmd: <span style={{ color: 'var(--green)' }}>≤ p20</span>, desc: '역사적으로 낮음. 오늘 값이 최근 관측치의 80%보다 낮습니다. 녹색 표시.' },
];

export const indicators = [
  { cmd: 'VIX',                 desc: 'CBOE 변동성 지수, 시장 공포 지표 (VIXCLS)' },
  { cmd: '10Y Treasury',        desc: '10년 미국 국채 금리, 주식 할인율 (DGS10)' },
  { cmd: 'Yield Curve',         desc: '10Y 빼기 2Y 스프레드, 경기 침체 지표 (T10Y2Y)' },
  { cmd: 'USD Index',           desc: '교역 가중 달러 강도 (DTWEXBGS)' },
  { cmd: 'HY Credit Spread',    desc: '하이일드 대 국채 스프레드, 신용 스트레스 지표 (BAMLH0A0HYM2)' },
  { cmd: 'Breakeven Inflation', desc: '시장이 반영한 10년 인플레 기대 (T10YIE)' },
  { cmd: 'Fed Funds Rate',      desc: '실효 연방기금금리 (FEDFUNDS)' },
  { cmd: 'FX vs home currency', desc: <>KRW/USD, JPY/USD, EUR/USD 등. <code>currency</code> 설정에 따라 자동 선택됩니다.</> },
];

export const stressComponents = [
  { cmd: 'Yield Curve (10Y–2Y)',  desc: '역전 시 경기 침체 위험 신호 (T10Y2Y)' },
  { cmd: 'Bank Spread (10Y–3M)',  desc: '대안 역전 지표. 종종 신용 긴축에 선행 (T10Y3M)' },
  { cmd: 'VIX',                   desc: '주식 시장 변동성 / 공포 지수 (VIXCLS)' },
  { cmd: 'Financial Stress',      desc: '세인트루이스 연은 금융 스트레스 지수. 종합 (STLFSI4)' },
  { cmd: 'Initial Jobless Claims',desc: '주간 실업수당 청구. 노동 시장 스트레스 (ICSA)' },
];

export const stressTiers = [
  { cmd: <span style={{ color: 'var(--green)'  }}>&lt; 20</span>, desc: '낮음: 안정적 환경' },
  { cmd: <span style={{ color: 'var(--cyan)'   }}>20–40</span>,    desc: '보통: 악화 여부 주시' },
  { cmd: <span style={{ color: 'var(--yellow)' }}>40–60</span>,    desc: '높음: 주의 필요' },
  { cmd: <span style={{ color: 'var(--red)'    }}>60–80</span>,    desc: '심각: 거시 역풍 큼' },
  { cmd: <span style={{ color: 'var(--red)', fontWeight: 700 }}>≥ 80</span>, desc: '위기: 시스템적 스트레스 수준' },
];

export const regimeSignals = [
  { cmd: 'VIX level',           desc: '20 미만 → risk-on · 20 이상 → risk-off (VIXCLS)' },
  { cmd: 'Yield curve',         desc: '양수 (10Y > 2Y) → risk-on · 역전 → risk-off (T10Y2Y)' },
  { cmd: 'HY credit spread',    desc: '4% 미만 → risk-on · 4% 이상 → risk-off (BAMLH0A0HYM2)' },
  { cmd: 'USD trend (30d)',     desc: '약세 → risk-on · 강세 → risk-off (DTWEXBGS)' },
  { cmd: 'Breakeven inflation', desc: '1–3% 범위 → risk-on · 범위 밖 → risk-off (T10YIE)' },
];

export const optionsRows = [
  { cmd: <code>firma show macro</code>,           desc: '캐시된 결과를 사용 (있으면)' },
  { cmd: <code>firma show macro --refresh</code>, desc: '캐시 무시하고 FRED에서 다시 가져오기' },
  { cmd: <code>firma show macro --json</code>,    desc: '머신 친화 출력' },
];

export const claudeTools = [
  { cmd: 'fetch_fred_series',  desc: <>80만 개 이상의 FRED 시리즈를 ID로 조회 (예: <code>UNRATE</code>, <code>DEXKOUS</code>)</> },
  { cmd: 'search_fred_series', desc: '시리즈 ID를 모를 때 키워드로 카탈로그 검색' },
];

export const claudeExchange = [{
  user: '지금 주식 비중 더 늘려도 괜찮은 시기야?',
  ai: <p>
    거시 환경은 현재 전반적으로 우호적입니다. VIX는 <code>19.31</code>로
    보통이고, 5년 평균 <code>19.22</code>에 근접합니다. 수익률 곡선은{' '}
    <code>+0.53%</code> (10Y 빼기 2Y)로 양수, HY 신용 스프레드는 30일간{' '}
    <code>−56bp</code> 좁혀져 <code>2.86%</code>로 안정적이며, USD는 30일간{' '}
    <code>2.3%</code> 약세입니다.
    스트레스 지수는 <code>4/100 (Low)</code>이고 5개 레짐 신호 모두 risk-on 상태입니다.
    역사적으로 성장주에 우호적인 배경입니다. 추가 매수를 망설이는 이유가 거시 환경일
    필요는 없습니다. 주된 위험은 거시 환경이 아니라 TSLA 단일 종목 집중입니다.
  </p>,
}];

<Section label="중요한 이유">
  <FeatureList items={reasons} />
</Section>

<Section label="firma show macro">
8개의 큐레이션된 FRED 시리즈를 가져와 현재값, 30일 변화, 90일 변화, 5년 평균,
그리고 최근 5년 일별 관측치 기준 현재값의 백분위를 표시합니다. 환율 행은 홈 통화
(<code>firma config set currency KRW</code>로 설정)에 따라 자동 선택됩니다.
같은 화면에 경제 스트레스 지수와 거시경제 레짐 판정도 함께 표시됩니다 (아래 섹션 참고).
결과는 디스크에 캐시되므로 같은 날 재실행은 즉시 응답합니다.

<div className="terminal">
  <div className="terminal-line">
    <span className="term-prompt">$</span>
    <span className="term-cmd">firma show macro</span>
  </div>
  <table className="term-table">
    <thead>
      <tr><th>INDICATOR</th><th>CURRENT</th><th>30d Δ</th><th>90d Δ</th><th>5y AVG</th><th>5y %ile</th></tr>
    </thead>
    <tbody>
      <tr className="sep"><td colSpan={6}/></tr>
      <tr><td className="td-bold">VIX</td><td>19.31</td><td className="td-muted">−11.74</td><td className="td-muted">+3.16</td><td className="td-muted">19.22</td><td className="td-muted">p52</td></tr>
      <tr><td className="td-bold">10Y Treasury Yield</td><td>4.34%</td><td className="td-muted">−10bp</td><td className="td-muted">+12bp</td><td className="td-muted">3.55%</td><td className="td-orange">p85</td></tr>
      <tr><td className="td-bold">Yield Curve (10y-2y)</td><td>0.53%</td><td className="td-muted">−3bp</td><td className="td-muted">−13bp</td><td className="td-muted">0.13%</td><td>p72</td></tr>
      <tr><td className="td-bold">USD Index (Broad)</td><td>118.08</td><td className="td-muted">−2.32%</td><td className="td-muted">+0.02%</td><td className="td-muted">120.36</td><td className="td-muted">p41</td></tr>
      <tr><td className="td-bold">HY Credit Spread</td><td>2.86%</td><td className="td-muted">−56bp</td><td className="td-muted">+17bp</td><td className="td-muted">3.31%</td><td className="td-muted">p31</td></tr>
      <tr><td className="td-bold">10Y Breakeven Inflation</td><td>2.42%</td><td className="td-muted">+11bp</td><td className="td-muted">+10bp</td><td className="td-muted">2.36%</td><td>p60</td></tr>
      <tr><td className="td-bold">Fed Funds Rate</td><td>3.64%</td><td className="td-muted">0</td><td className="td-muted">0</td><td className="td-muted">3.41%</td><td>p64</td></tr>
      <tr className="sep"><td colSpan={6}/></tr>
    </tbody>
    <tfoot><tr><td className="td-muted" colSpan={6}>As of 2026-04-23 · Source: FRED · Home currency: USD</td></tr></tfoot>
  </table>
</div>

  <Note>
    무료 FRED API 키가 필요합니다.{' '}
    <a href="https://fred.stlouisfed.org/docs/api/api_key.html" target="_blank" rel="noopener noreferrer">fred.stlouisfed.org</a>에서
    등록한 뒤 <code>firma config set fred-key &lt;key&gt;</code>로 설정합니다.
    결과는 <code>~/.firma/cache/macro-YYYY-MM-DD-&lt;currency&gt;.json</code>에 캐시됩니다.
  </Note>
</Section>

<Section label="5y %ile 컬럼 읽기">
**5y %ile**(5년 백분위)는 오늘 값이 해당 시리즈의 최근 5년 일별 관측치 중
어느 위치에 있는지를 나타냅니다.

  <CommandTable rows={percentileRows} />

예: **10Y Treasury가 p85**라는 것은 최근 5년 거래일의 85%보다 오늘 금리가 높다는
의미입니다. 최근 이력 기준으로 금리 환경이 타이트합니다. **HY Credit Spread가 p31**
이라는 것은 스프레드가 평균보다 좁다는 의미이며, 신용 시장이 비교적 안정적입니다.

  <Note>
    백분위는 다른 컬럼에 사용된 동일한 5년 FRED 시리즈에서 계산되므로 추가 API 호출은
    없습니다. *최근* 이력 기준이라는 점에 주의하세요. 저금리 시기의 p85와 고금리
    시기의 p85는 다릅니다.
  </Note>
</Section>

<Section label="지표 설명">
  <CommandTable rows={indicators} />
</Section>

<Section label="경제 스트레스 지수">
5개 FRED 지표로 계산한 0–100 점수로 현재 경제 스트레스 수준을 요약합니다.
낮으면 안정, 높으면 거시 환경에 부담이 큰 상태입니다. 다섯 구성 요소 각각을
역사적 백분위와 중립 임계값 대비 방향에 따라 0–20점으로 점수화한 뒤 합산해
100점 만점으로 표시합니다.

  <CommandTable rows={stressComponents} />

  <CommandTable rows={stressTiers} />

<div className="terminal">
  <pre className="term-pre"><span className="d">Stress Score  </span><span className="g">4 / 100  (Low)</span></pre>
  <table className="term-table">
    <thead>
      <tr><th>COMPONENT</th><th>VALUE</th><th>SCORE</th><th>WEIGHT</th></tr>
    </thead>
    <tbody>
      <tr className="sep"><td colSpan={4}/></tr>
      <tr><td className="td-bold">Yield Curve (10y-2y)</td><td>0.53</td><td>0</td><td className="td-muted">23.5%</td></tr>
      <tr><td className="td-bold">Bank Spread (10y-3m)</td><td>0.62</td><td>0</td><td className="td-muted">17.6%</td></tr>
      <tr><td className="td-bold">Volatility (VIX)</td><td>19.31</td><td>7</td><td className="td-muted">23.5%</td></tr>
      <tr><td className="td-bold">Financial Stress (STLFSI4)</td><td>−0.76</td><td>4</td><td className="td-muted">23.5%</td></tr>
      <tr><td className="td-bold">Initial Jobless Claims</td><td>214k</td><td>11</td><td className="td-muted">11.8%</td></tr>
      <tr className="sep"><td colSpan={4}/></tr>
    </tbody>
    <tfoot>
      <tr><td className="td-muted" colSpan={4}>&lt;20 Low · 20–40 Moderate · 40–60 Elevated · 60–80 Severe · ≥80 Critical</td></tr>
    </tfoot>
  </table>
</div>

  <Note>
    순수 기술적 지표입니다. 투자 자문이 아닙니다.
  </Note>
</Section>

<Section label="거시경제 레짐">
FRED 데이터에서 도출한 5개의 이진 신호입니다. 각각 risk-on 또는 risk-off로
판정되고, 그 균형이 전반적인 레짐 편향을 결정합니다. 거시 환경이 위험 자산에
우호적인지 빠르게 파악하는 도구입니다.

  <CommandTable rows={regimeSignals} />

<div className="terminal">
  <pre className="term-pre">{`Bias:  Risk-on bias  (5 of 5 signals risk-on)

  ✓  VIX 19.31 (moderate)
  ✓  10Y − 2Y +0.53% (normal)
  ✓  HY OAS 2.86% (very tight)
  ✓  USD -2.32% 30d (weak)
  ✓  Breakeven 2.42% (anchored)

≥70% bullish → Risk-on bias  ·  ≤40% → Risk-off bias  ·  otherwise Mixed`}</pre>
</div>

  <Note>
    편향 규칙: 70% 이상 강세 → <span style={{ color: 'var(--green)' }}>Risk-on</span> ·
    {' '}40% 이하 강세 → <span style={{ color: 'var(--red)' }}>Risk-off</span> · 그 외{' '}
    <span style={{ color: 'var(--yellow)' }}>Mixed</span>. 순수 기술적 휴리스틱이며
    투자 자문이 아닙니다.
  </Note>
</Section>

<Section label="옵션">
  <CommandTable rows={optionsRows} />
</Section>

<Section label="Claude와 함께">
Claude Desktop에서 <code>show_macro</code>가 동일한 화면을 반환합니다 —
지표, 스트레스 지수, 레짐이 하나의 페이로드에 담깁니다.
두 가지 추가 MCP 도구를 통해 Claude는 FRED에 자유롭게 접근할 수 있습니다:

  <CommandTable rows={claudeTools} />

  <ChatDemo header="Claude Desktop · firma MCP 연결됨" exchanges={claudeExchange} />
</Section>
