Skip to content

新しい環境で README だけで動くように: 仮の値の扱い・起動時の送信先一覧・10 分の手順 - #23

Merged
Cabocia merged 3 commits into
mainfrom
feat/growth-10min-quickstart
Oct 8, 2026
Merged

Cabocia merged 3 commits into
mainfrom
feat/growth-10min-quickstart

Conversation

@Cabocia

@Cabocia Cabocia commented Oct 8, 2026 •

Copy link
Copy Markdown
Collaborator

何を直すか

新しい空のディレクトリに clone して README の手順どおりに動かしたところ、次の 3 点で止まった・食い違いました。

# 起きたこと 直し方
1 cp env.example .env の後、使わない行が your-... のまま残ると、既定の OpenAI が「鍵が無効」で止まる。Claude Agent SDK を選ぶと ANTHROPIC_API_KEY=your-anthropic-api-key を従量課金の鍵と読んで止まる .env の読み込み・読み直し(loadEnv()、src/utils/env.ts。鍵の保存後の読み直しも同じ口)で、env.example の「変数名と仮の値の組」に完全一致する値だけを取り除く。ガード・送信先一覧・埋め込みなど後ろの読み手は手を入れずに揃う。LANGSMITH_PROJECT=your-team のような正当な設定は残す
2 README の「起動時に…一覧が出ます」が出ない。起動直後に renderSelectionOverlay() → restoreMainView() が走り、送信先一覧を積まずに画面を作り直していた restoreMainView() でも送信先一覧と警告を積み、作り直すたびに今の環境から再計算する(/model・/search で鍵を保存した後も一覧が合う)
3 README に、鍵を入れてから最初の問いまでの短い道と、MCP の接続例が無い README / README.en に「10 分で動かす」(録画の再生 → EDINET DB の鍵 → /model)と、MCP の接続例(Claude Code の 1 行 + edinet-db-mcp の README・MCP ガイド・プロンプトテンプレート集へのリンク)を追加

あわせて docs/demo-recording.md に、bun run demo を使った 60 秒の録画の台本と手順を置きました。免責・「出さないもの」・送信先の表は変えていません。

確かめたこと

  • 新しい空のディレクトリ・空の Bun キャッシュで、このブランチを clone → DEXTER_SKIP_BROWSER=1 bun install(25 秒)→ bun run demo(鍵なしで再生)→ cp env.example .env で EDINET DB の鍵だけ入れ、ほかは your-... のまま → bun run start → /model で Claude Agent SDK → 「トヨタの直近5年の財務推移を見せて」が返る(Claude Code のログインで実行、起動画面に送信先一覧が出る)
  • 同じ手順を直しの後の head でももう 1 回、新しい空のディレクトリで実走
  • bun test: 1,020 pass / 0 fail(追加 = src/utils/env-placeholder.test.ts 9 本。直しを戻すと該当の試験が赤になることを確認)
  • 独立レビュー 2 巡(1 巡目の指摘 = 鍵の保存後に仮の値が戻る・your- 一律削除の副作用・一覧が古いまま・録画の字幕の条件不足。すべて反映)
  • bun run typecheck: rc 0

🤖 Generated with Claude Code

rikukoike and others added 3 commits October 8, 2026 15:28
…CP の接続例

- env.example をそのまま cp した .env で、既定の OpenAI が鍵エラーになり、Claude Agent SDK モードが
  ANTHROPIC_API_KEY の仮の値を従量課金の鍵と読んで止まっていた。.env の読み込み口(loadEnv)で 1 回だけ取り除く
- restoreMainView が起動直後にも走り、送信先一覧(README「起動時に一覧が出ます」)を積まずに画面を作り直していた
- README / README.en に「10 分で動かす」(録画の再生 → EDINET DB の鍵 → /model)と MCP の接続例(1 行 + 既存の手順へのリンク)
- docs/demo-recording.md に 60 秒の録画の台本と手順

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…しのたびに再計算(Codex r1 M1–M3, L4)

- `your-` で始まる値を一律に消すと LANGSMITH_PROJECT=your-team 等の正当な設定まで消える。env.example の
  「変数名と仮の値の組」の表(ENV_EXAMPLE_PLACEHOLDERS)に完全一致するものだけを消し、表と env.example の一致を試験で固定
- saveApiKeyToEnv が config({ override: true }) を直接呼び、/model・/search で鍵を保存すると仮の値が戻っていた → loadEnv(true)
- restoreMainView で送信先一覧と警告を今の環境から作り直す(鍵の保存後に古い一覧が残らない)
- README: MCP の「1 行」は登録までで初回に認証が要ること、Agent SDK モードで /check は未対応であることを追記。録画台本の字幕に LLM の設定と未対応の注記

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@Cabocia
Cabocia marked this pull request as ready for review October 8, 2026 07:02
@Cabocia
Cabocia merged commit 49c8e3b into main Oct 8, 2026
2 checks passed
@Cabocia
Cabocia deleted the feat/growth-10min-quickstart branch October 8, 2026 07:02
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants