configuring

設定

AI コーディング環境全体の統合設定管理です。あらゆる AI コーディングプラットフォームから、環境変数、シークレット、その他の独自の設定を読み込みます。

クイックスタート

import sys
sys.path.insert(0, '/path/to/claude-skills')  # or wherever skills are installed
from configuring import get_env, detect_environment

# Get a variable (searches all sources automatically)
token = get_env("TURSO_TOKEN", required=True)

# With default
port = get_env("PORT", default="8080")

# What environment are we in?
env = detect_environment()  # "claude.ai", "claude-code-desktop", "codex", "jules", etc.

対応環境

環境	設定ソース
Claude.ai Projects	/mnt/project/*.env、/mnt/project/*-token.txt
Claude Code	~/.claude/settings.json（env ブロック）、.claude/settings.json
OpenAI Codex	~/.codex/config.toml、セットアップスクリプト → ~/.bashrc、shell_snapshots/*.sh
Jules	環境設定 UI、リポジトリ内の .env
共通	os.environ、.env、.env.local

API リファレンス

# Core
get_env(key, default=None, *, required=False, validator=None) -> str | None
load_env(path) -> dict[str, str]           # Load specific file
load_all(force_reload=False) -> dict       # Load all sources

# Utilities
detect_environment() -> str                 # Current platform
mask_secret(value, show_chars=4) -> str    # Safe logging
debug_info() -> dict                        # Troubleshooting
get_loaded_sources() -> list[str]          # What was checked

認証情報ファイルの形式

.env ファイル（KEY=value）：

TURSO_TOKEN=eyJhbGciOiJFZERTQSI...
EMBEDDING_API_KEY=sk-svcacct-...

単一値ファイル（*-token.txt、*-key.txt）：

eyJhbGciOiJFZERTQSI...

ファイル名がキーになります：turso-token.txt → TURSO_TOKEN

Claude Code の settings.json：

{
  "env": {
    "TURSO_TOKEN": "eyJhbGciOiJFZERTQSI..."
  }
}

優先順位

後のソースが前のソースを上書きします：

1. OS の環境変数
2. プラットフォーム固有のソース（自動検出）
3. 作業ディレクトリ内の .env ファイル
4. OS の環境変数（再度読み込み — 明示的なエクスポートが常に優先されます）

デバッグ

import sys
sys.path.insert(0, '/path/to/claude-skills')
from configuring import debug_info
print(debug_info())
# {'environment': 'claude.ai', 'sources': ['os.environ', 'claude.ai:/mnt/project/'], ...}

CLI：

cd /path/to/claude-skills/configuring
python scripts/getting_env.py                    # Show debug info
python scripts/getting_env.py TURSO_TOKEN        # Get specific key

api-credentials / getting-env からの移行

次のように置き換えます：

# Old (api-credentials)
from credentials import get_anthropic_api_key
key = get_anthropic_api_key()

# Old (getting-env)
from getting_env import get_env
key = get_env("ANTHROPIC_API_KEY")

# New (configuring)
import sys
sys.path.insert(0, '/path/to/claude-skills')
from configuring import get_env
key = get_env("ANTHROPIC_API_KEY", required=True)