ローカル AI ナレッジベース：自分の文書で Q&A

一度だけ設定：グローバル設定を AICodeWith に向ける

設定は一度で十分です。以降のユースケースは同じです。他ツールは 連携ガイド。キーの取得は API キーを取得。

1. 1. Claude Code をインストール

   Claude Code の公式インストール手順に従ってください。claude --version がバージョン番号を出せば完了です。

2. 2. キーを作り、グローバル設定を編集

   ログインし、ダッシュボードの **APIキー** ページを開いてキーを作成します。場所が分からなければ API キーを取得 を見てください。

   グローバル設定 ~/.claude/settings.json を開き、env に Base URL とキーを入れます：

   ~/.claude/settings.json复制代码

   {
     "env": {
       "ANTHROPIC_BASE_URL": "https://api.aicodewith.ai",
       "ANTHROPIC_AUTH_TOKEN": "sk-YOUR_KEY"
     }
   }
   

   Base URL の末尾に /v1 を付けないでください。ターミナルを開き直し、claude を実行して普通に返信があれば接続できています。

実測手順

1. 1. 文書を用意し、Q&A ツールを作らせる

   フォルダを作り、Markdown ファイルを docs/ に置き、その中で claude を実行し、入力：

   text复制代码

   docs/ フォルダに会社の規約文書が数件ある。ローカル Q&A ツールを作って：第三者 API キーが不要な Python スクリプト ask.py を書き、docs/ 下の Markdown を読み、段落ごとに分割し、キーワード/BM25 で関連度の高い箇所を取り、回答と出典（ファイル名 + 元の文）を出力して。それでこの質問に答え、結果を qa-results.md に書いて：（質問は自分のものに置き換え）。文書になければ "not found in the documents" と言って。答えを捏造しないで。
   

   最後の「not found in the documents」 と答えを捏造しない、の文は残してください。スクリプトが推測できないようにする文です。

2. 2. あとは Claude Code なしで質問

   スクリプトがあれば Claude Code は不要です。ターミナルで質問：

   bash复制代码

   python3 ask.py "How many vacation days after 12 years?"
   python3 ask.py -k 3 "Who do I ask for a test phone?"   # top 3 candidate passages
   

   Claude Code が書くスクリプトは違うことがあります。初回は、答えを知っている質問を幾つ試してください。

トラブルシューティング

文書にあるのに not found と出る

一致閾値を下げるか類義語を足し、その質問を再実行させてください。

文書が Word や PDF

検証したのは Markdown だけです。先に変換させることはできます（その段階は未検証）。

401 またはリクエスト失敗

キーが欠けておらず、Base URL が https://api.aicodewith.ai（/v1 なし）か確認してください。変更後はターミナルを開き直します。

FAQ

関連記事

• Claude Code + Python：依存ゼロのローカル文書 Q&A
• すべての連携ガイド
• API キーを取得