0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

Claude Code に .env を貼り付けて渡している ── AI エージェントに渡す token は 1 つだけ

0
Last updated at Posted at 2026-11-07

Claude Code に .env を貼り付けて渡している ── AI エージェントに渡す token は 1 つだけ

上原正吉(EarthLink Network Co., Ltd.)。AI会社・AI社員による業務自動化と、人の逐次介入なしに24時間自動開発を回す仕組みを自社で実践しています。開発ノウハウと具体的な設定方法、運用して分かった改善点を公開しています。

Claude Code に .env を貼り付けて渡している ── AI エージェントに渡す token は 1 つだけ

この記事は、連載「dotvault の使い方 ── .env を手で配るのをやめ、CI・チーム・AI エージェントに 1 コマンドで配るまで」の第 8 回です。この連載が終わる時に、dotvault を誰でも無料で使える形で公開する予定です。

Claude Code に「この .env を使って動かして」と頼む時、.env の中身を会話に貼り付けるか、.env を読ませることになります。値は会話の記録に残り、Claude Code が動かすコマンドの出力にも出ます。dotvault に値を置いてあっても、Claude Code に dotvault login をさせるには、自分のメールアドレスとパスワードを渡すことになります。

「AI エージェントに secret を渡すには、値そのものか、自分の login を渡すしかない」と考えがちですが、渡すのは dotvault の service token 1 つで足ります。project を 1 つに絞った、値を読み書きするための token(Read/write)です。Claude Code はこの token だけで .env を dotvault に取り込み、pull で受け取ります。人のパスワードは渡しません。使わせなくする時は、console で token を取り消します(Revoke)。

この回では、token を 1 つ発行して Claude Code の設定ファイルに置き、Claude Code に取り込みから pull までを任せ、Revoke で token を取り消すところまでを確かめます。Claude Code は token 1 つだけで 3 つの key を取り込み、pull で 3 つを受け取りました。token を取り消した後に同じ pull を頼むと、AUTH_REQUIRED と終了コード 3 で止まりました。

結論

  • Claude Code に渡す token は 1 つです。 console の Service Tokens → Create token で、Role を Read/write、Project を作業する project にした token を作ります。Read/write は、pull に加えて key の追加・更新・削除ができます。
  • project は、人が console で作ります。 Read/write の token では project を作れません。project の作り方は 2 回目で扱いました。
  • token は、そのリポジトリの .claude/settings.local.json の env に DOTVAULT_TOKEN として置きます。 ファイルには token が平文で書かれるので、.gitignore で外します。
  • Claude Code は、人の login なしで値を取り込み、受け取ります。 dotvault init → import → pull → run → whoami を Claude Code が自分で実行し、3 つの key を取り込んで、pull で 3 つを受け取りました。
  • dotvault scan . は、設定ファイルの token を見つけます。 1 つの token を 2 件として出し、終了コード 1 を返します。
  • 使わせなくする時は、console で token を取り消します(Revoke)。 取り消した後、Claude Code の pull は AUTH_REQUIRED(終了コード 3)で止まりました。AI に渡した token は、取り消して発行し直し(再発行)、設定ファイルの 1 行を書き換えれば済みます。AI が使う API キーの値は、提供元で作り直したキーに dotvault の値を入れ替えます。その仕組みは 11 回目で扱います。

本文(読了 約9分)

前提

7 回目で扱った service token の発行と取り消しの続きです。この回は、同じ画面で作った token を Claude Code に渡します。7 回目を読んでいなくても追えます。

1. token を 1 つ発行する

先に、Claude Code に使わせる project を console で作っておきます。ここでは、Projects の New project で demo-agent-app を作りました。作り方は 2 回目と同じです。Read/write の token では project を作れないので、project は人が作ります。

次に、サイドバーの Service Tokens → Create token を開きます。Name を claude-agent、Role を Read/write (member。dotvault の中での役の名前です)、Project を demo-agent-app、Expiry を 30 days にし、Environments は production だけに印を付けました。

Create service token のモーダル。Name に claude-agent、Role は Read/write で「In addition to pull, can add, update, and delete keys.」の説明。Project は demo-agent-app で「Project-scoped tokens receive only the Global keys bound to this project (they cannot see the Global keys list itself).」の注記。Expiry は 30 days。Environments (envs) は development・staging・production のうち production だけに印があり、「Leave empty for all environments. Picking some restricts the token to them.」の説明。右下に Cancel と Create のボタン。

Claude Code に import で値を取り込ませるので、Read only ではなく Read/write にします。Environments の欄は、何も選ばなければ全部の環境、選べばその環境だけに使える token になります。Claude Code が取り込む先は production だけなので、production だけにしました。

Create を押すと、token が 1 回だけ表示されます。ここで Copy します。

Token created の画面(token は伏せ字)。「Copy this token now — it is shown only once and cannot be retrieved again.」の注意、est_•••• の token、Token ID の 6db15215ff44cb01095ffd38cec39774 と「The Token ID is not a secret.」の説明、Copy と Done のボタン。

一覧には 1 行が並びます。Project は demo-agent-app、Envs は production です。

Service Tokens の一覧に 1 行。claude-agent・Token ID 6db15215ff44cb01095ffd38cec39774・Role は Read/write・Project は demo-agent-app・Envs は production・作成の 30 日後が期限・Last used は Not recorded・Status は active。行の右端に Revoke ボタン。

2. token を Claude Code に渡す

作業するリポジトリ(ここでは ~/dev/demo-agent-app)の .claude/settings.local.json に、token を書きます。Claude Code は、このファイルの env を、自分が実行するコマンドの環境変数として渡します。

{
  "env": {
    "DOTVAULT_TOKEN": "est_••••"
  },
  "permissions": {
    "allow": [
      "Bash(dotvault:*)"
    ]
  }
}
  • DOTVAULT_TOKEN には、1 節で作った Read/write の token を入れます。import・pull・run が読みます。
  • permissions.allow の Bash(dotvault:*) は、dotvault で始まるコマンドを、毎回の確認なしで実行してよいという許可です。

置き場所を、ユーザー全体の ~/.claude/settings.json ではなく、リポジトリの .claude/settings.local.json にしたのは、ユーザー全体に置くと、どのリポジトリで起動した Claude Code にもこの token が渡るためです。このリポジトリでだけ使う token は、このリポジトリに置きます。

このファイルには token が平文で書かれます。.gitignore に .claude/settings.local.json と .env を書いて、commit に入らないようにします。

.env
.claude/settings.local.json

このリポジトリで Claude Code を初めて起動すると、フォルダを信頼するかの確認に、このファイルで許可したコマンドが出ます。

Claude Code の起動時の画面。「Accessing workspace:」とリポジトリのパスの下に、信頼してよいフォルダかを尋ねる文。黄色の「⚠ This folder pre-approves 1 tool permission in .claude/settings.local.json:」の下に Bash(dotvault:*)、続けて「These will apply without asking. Only proceed if you trust this configuration.」。選択肢は No, exit と Yes, I trust this folder。

許可されるのが Bash(dotvault:*) の 1 つだけであることを確かめてから、Yes, I trust this folder を選びます。

3. Claude Code に取り込みから pull までを頼む

リポジトリには、ダミーの値の .env(DATABASE_URL・OPENAI_API_KEY・FEATURE_FLAGS の 3 行)を置いてあります。Claude Code には、こう頼みました。

Move this repo's .env into dotvault without asking me. The project demo-agent-app already exists. Use the dotvault CLI: init the config as demo-agent-app, import .env into production, pull it back from production, then check two values with dotvault run -E production -- printenv DATABASE_URL and dotvault run -E production -- printenv FEATURE_FLAGS (one name per command, never print the whole environment), and finish with whoami.

(one name per command, never print the whole environment) は、環境変数の全部を出さないための一言です。dotvault run は、取り出した値を環境変数として子のコマンドに渡します。printenv を名前なしで実行すると、渡した値がすべて画面に出て、Claude Code の会話の記録にも残ります。Mac の printenv は、名前を 2 つ渡しても 1 つ目の値しか出さないので、key ごとに 1 回ずつ頼みます。

$ env A=1 B=2 printenv A B
1

Claude Code は 7 個のコマンドを実行しました。初めの 2 個は dotvault --help などで使い方を読むためのもので、残りの 5 個で取り込みから確かめまでを進めました。ctrl+o で展開した、5 個のコマンドとその出力です。

Claude Code の実行の画面(ctrl+o の展開表示)。Bash(dotvault init --name demo-agent-app && dotvault import .env -E production) の出力に「Created project-config.json (project=demo-agent-app). Next: dotvault pull (uses DOTVAULT_TOKEN; no login needed)」と「imported 3 keys into .env [demo-agent-app/production]」。Bash(dotvault pull -E production) の出力に、元の 3 行をコメントにしたという warning と「✓ Wrote 3 keys to …/demo-agent-app/.env」「✔ 1 file synced, 0 excluded, 3 keys total」。dotvault run -E production -- printenv DATABASE_URL の出力にダミーの postgres:// の URL、printenv FEATURE_FLAGS の出力に beta-search。Bash(dotvault whoami) の出力に「Service token (DOTVAULT_TOKEN=est_••••…) — CI / Lambda mode」と、whoami はサーバーに問い合わせないという note。

  • init。 project-config.json を作り、「Next: dotvault pull (uses DOTVAULT_TOKEN; no login needed)」と、token があれば login は要らないと案内しました。
  • import。 「imported 3 keys into .env [demo-agent-app/production]」で、3 つの key が production に入りました。
  • pull。 「Wrote 3 keys」で 3 つを受け取りました。元の .env の 3 行は「# dotvault: moved into the managed block below:」を付けてコメントにし、その下の dotvault が管理する範囲に値を書いた、という warning も出ています。
  • run。 DATABASE_URL と FEATURE_FLAGS のダミーの値が、1 つずつ出ました。
  • whoami。 「Service token (DOTVAULT_TOKEN=est_••••…) — CI / Lambda mode」で、人の login ではなく token で動いていると分かります。

最後に、Claude Code はこう報告しました。

Claude Code の報告の画面。依頼文の下に「Ran 7 shell commands」。報告は「The repo's .env is now in dotvault under demo-agent-app, in the production environment.」で始まり、Init(project-config.json を作った)、Import(3 keys を production へ)、Pull(3 keys を .env へ書き戻し、元の 3 行はコメントにした)、Checks(DATABASE_URL と FEATURE_FLAGS の値)、whoami(service token を使っていて、whoami はサーバーに問い合わせないので token が有効かは確かめられない。確かめるには dotvault list --project demo-agent-app)の 5 項目。最後に「Churned for 24s」。

何を実行し、何が通ったかを、key の数と値の確かめまで含めて返しています。pull で元の行がコメントになったことも、報告に入っています。私が途中で答えたことはありません。

4. console で確かめる

console の Projects で demo-agent-app を開き、Keys の production を選ぶと、Claude Code が取り込んだ 3 つの key が並んでいます。

demo-agent-app の Keys 画面で production を選んだところ。env のファイルに 3 keys。DATABASE_URL・FEATURE_FLAGS・OPENAI_API_KEY の 3 行で、どれも 🔒 の印つき、UPDATED は同じ時刻。右に「Selected key」の欄。

5. scan で token の混入を見つける

5 回目の「.npmrc と kubeconfig を、まだ手で渡している」で使った dotvault scan は、est_ で始まる token も見つけます。リポジトリで scan . を実行しました。

$ dotvault scan .
.claude/settings.local.json:3  [dotvault-service-token] dotvault service token — est_•••• (80 chars)
.claude/settings.local.json:3  [generic-assignment] Generic secret assignment — TOKE•••• (90 chars)

2 potential secret(s) found.
$ echo $?
1

1 つの token が、dotvault service token と Generic secret assignment の 2 つの規則で、2 件として出ました。scan は見つけた文字列の初めと終わりを数文字ずつ出すので、そこも伏せています。.env のダミーの値は出ませんでした。

.claude/settings.local.json は .gitignore で外してありますが、5 回目で書いたとおり、scan . は .gitignore で外したファイルも読みます。commit の前のフックに exec dotvault scan . を置いているリポジトリでは、このファイルがあるだけで commit が止まります。その時は、フックの範囲を exec dotvault scan src/ .github/ のように絞ります。逆に、token を誤って commit されるファイル(チームで共有する .claude/settings.json など)に書いた時は、フックが commit を止めます。

6. Revoke で token を取り消す

Service Tokens の一覧で、claude-agent の行の Revoke(取り消し)を押しました。「Revoke token “claude-agent”? CI jobs and services using it will lose access immediately.」の確認で OK を押すと、Status が revoked になります。

Revoked only で絞り、検索欄に Token ID を入れた Service Tokens の一覧。claude-agent(Read/write・demo-agent-app・production)の 1 行で、Last used (hourly) には 3 節で token を使った時刻、Last-use IP は伏せ字、Status は revoked。

Last used は token ごとに 1 時間に 1 回だけ記録されるので、ここに出ているのは 3 節で Claude Code が最初に token を使った時刻です(init と import を続けて実行したコマンド)。token を取り消した後に、Claude Code に同じ pull を頼みました。

Claude Code の画面(ctrl+o の展開表示)。「Pull production from dotvault again with dotvault pull -E production and tell me the exit code.」の依頼に、Bash(dotvault pull -E production; echo "exit code: $?") の出力「✖ AUTH_REQUIRED: invalid, expired or revoked service token」と「exit code: 3」。続く報告は「The pull failed with exit code 3 (AUTH_REQUIRED).」で始まり、token が取り消されたか期限切れの可能性、失敗した pull は何も書いていないので手元の .env は変わっていないこと、console で新しい token を発行して DOTVAULT_TOKEN に入れれば pull をやり直せることを返している。

pull は「✖ AUTH_REQUIRED: invalid, expired or revoked service token」で、終了コード 3 で止まりました。Claude Code は、token が取り消されたか期限が切れたと読み、手元の .env は書き換わっていないこと、新しい token を発行すれば pull をやり直せることを返しました。

whoami では、token が取り消されたかどうかは分かりません。3 節の出力の note のとおり、whoami はサーバーに問い合わせないので、取り消した token でも同じ行を出します。確かめる時は pull か dotvault list --project <name> を使います。

token を取り消した後は、.claude/settings.local.json の DOTVAULT_TOKEN の値も消しておきます。

7. AI に渡しても、token の再発行とキーの入れ替えは簡単にできる

AI に渡した token は、取り消して新しい token を発行し直し(再発行)、.claude/settings.local.json の値を書き換えれば済みます。Claude Code の側で変えるのは、この 1 行だけです。

AI が使うキーの値(この回の OPENAI_API_KEY のような API キー)も、簡単に入れ替えられます。キーそのものは dotvault が作るのではありません。OpenAI などの提供元でキーを作り直し、dotvault に置いた値を新しい値に入れ替えます。取り替えの管理に登録しておけば、漏れた時に retire で誰にも渡らないように止め、新しい値を置けます。キーの入れ替えの仕組みは、11 回目の「漏れた API キーを 1 コマンドで止める」で扱います。

次回

次回は、一人で使ってきた Personal org を Company org に切り替え、人を招待してロールを渡し、辞めた人の権限を止めるところまでを扱います。


dotvault は、.env や設定ファイルの secret をサーバー側に置き、権限のある人・CI・AI エージェントが 1 コマンドで受け取るサービスです(https://dotvault.io )。この連載が終わる時に、dotvault を誰でも無料で使える形で公開する予定です。公開したら、この連載の手順どおりに使い始められます。

興味のある方は、ぜひ「いいね」と記事の購読をお願いいたします。

自社プロダクトは https://www.eln.ne.jp/products にまとめています。

筆者について

上原正吉。EarthLink Network Co., Ltd. 代表。AI社員に日々の業務を任せ、開発では人が逐一指示しなくても作業が進むHOOTL(Human Out Of The Loop)の仕組みを自社で実践しています。このブログでは、業務自動化と24時間自動開発のノウハウ、具体的な設定方法、日々の運用で見つかった問題と改善を共有します。

また、AIで業務や開発を組み替えたい会社・チーム向けに、AI活用のコンサルティングも受け付けています。ご相談は www.eln.ne.jp からどうぞ。


EarthLink Network は、会社の全業務を AI で回すために、必要になったものを自社で作っています。いま作っているプロダクトの一覧と概要は、こちらにまとめています。

→ EarthLink Network が自社でつくっている18のプロダクト

会社と各プロダクトの詳細は、公式サイト www.eln.ne.jp をご覧ください。

0
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?