管理者に頼むこと
あなたや Claude にはできない設定があります。迷ったら、このページで確かめます。
管理者とは
このプラットフォームの設定を担当している人です。あなたに Claude と GitHub のアカウントを用意した人が、管理者か、管理者につないでくれる人です。
管理者に頼むのは、アカウント、誰が何を使えるか、秘密の値、本番のデータに関わることです。
頼むことの一覧
| 状況 | 管理者に伝えること |
|---|---|
| Claude Code を使えない | Claude Code を使えるアカウントがほしいこと |
| GitHub でリポジトリを開けない | 自分の GitHub のユーザー名と、リポジトリに招待してほしいこと |
| プレビューや本番で、サインインできない | プレビューと本番のどちらか、使ったメールアドレス |
| 「アクセスが拒否されました」と表示される | 開きたいアプリの名前 |
| 作ったアプリを、同僚に使ってもらいたい | アプリの名前と、使ってもらいたい人たち |
| 役割によって、使える機能を分けたい | どの役割に、何を許可したいか。機能を作るのは Claude で、誰がどの役割かを決めるのは管理者です |
| 外部のサービスとつなぎたい | つなぎたいサービスと、やりたいこと。API キーは管理者が登録します |
| ファイルのアップロードやメール通知を、はじめて使う | アプリの名前と、使いたい機能 |
| データベースの構造を変える PR をマージしたい | PR の URL。マージの前に見てもらいます |
| チェックの失敗に「マイグレーション」という言葉が出てくる | PR の URL と、Claude の説明 |
| 本番のデータを直したい、消したい | どのアプリの、どのデータを、どうしたいか |
| アプリを止めたい、削除したい | アプリの名前と、その理由 |
| 本番で、同僚の仕事が止まっている | いつから、どのアプリで、何が起きているか。直前にマージした PR があれば、その URL |
| App Portal に「ログ」が表示されない | ログを見たいアプリの名前 |
やってはいけないこと
- パスワードや API キーなどの秘密の値を、Claude との会話に書く
- 秘密の値を、コードやファイルに書き込むよう Claude に頼む
- 本番のデータベースを直接書き換えるよう Claude に頼む
- チェックに赤い × がある PR をマージする
mainに直接変更を入れるよう Claude に頼む
Claude がこれらを提案してきたときは、作業を止めて、管理者に相談します。
管理者の方へ
このガイドは、プログラミングの経験がない人に向けて書いています。上の一覧にある設定の手順は、リポジトリの中にあります。Claude Code でリポジトリを開いて頼むと、該当する手順が読み込まれます。
| 行うこと | 手順のある場所 |
|---|---|
| サインインできる人、役割、アプリを開ける人の設定 | shared/auth/auth-ui/README.md、.claude/skills/auth-integration/SKILL.md、.claude/skills/fine-grained-access/SKILL.md |
| 秘密の値や環境変数の追加 | .claude/skills/railway-variable-mapping/SKILL.md |
| ファイル保存の準備 | .claude/skills/object-storage/SKILL.md |
| 通知メールの準備 | .claude/skills/email-notifications/SKILL.md |
| データベースの変更の確認、マイグレーションの失敗からの復旧 | .claude/skills/database-schema/SKILL.md |
| デプロイの仕組み | .claude/skills/deployment-railway-github-actions/SKILL.md |
| アプリの停止と削除 | .claude/skills/halt-or-remove-app/SKILL.md |
| チェックとマージの条件 | .claude/skills/ci-and-code-ownership/SKILL.md |
| 開発に使うパソコンの環境の確認 | .claude/skills/check-environment/SKILL.md |
| 新しい会社向けの初期設定 | docs/client-setup.md |
クイズ
Quiz
Claude が「外部サービスの API キーが必要です。ここに貼り付けてください」と言いました。どうしますか?