← 試験の目次へ
Architect Professional ドメイン7: 開発者の生産性と運用の支援（7%）
この章で学ぶこと: チーム向けの Claude Code の設定（管理設定、共有の設定、権限、MCP、プラグイン、監視）、AI を使った開発のワークフローの改善、デバッグと運用の問題解決の支え方。
| タスク（試験ガイド） |
この章の節 |
| チーム向けに Claude のツールと環境を設定する（例: Claude Code） |
第1節 |
| AI支援ツールで開発者のワークフローを改善する |
第2節 |
| デバッグと運用上の問題解決を支援する |
第3節 |
本番の63問のうち約4問の小さいドメインです。Claude Code の機能そのものは前の試験で学んだので、この章は「チーム・組織として、どう設定して広げるか」に絞ります。
基礎はここで復習してください:
1. チーム向けの設定
1.1 どの設定をどこに置くか
| 置きたいもの |
置き場所 |
理由 |
| 組織として必ず守らせる決まり（禁止のコマンド、監視の送り先） |
管理設定（managed-settings.json、MDM、管理コンソール） |
優先順位がいちばん高く、利用者の設定や --settings で上書きできない |
| チームで共有する権限・フック・MCP サーバー・プラグイン |
.claude/settings.json、.mcp.json（Git にコミット） |
全員に同じ環境 |
| チームで共有するプロジェクトの決まり（ビルドのしかた、コードの決まり） |
プロジェクトの CLAUDE.md、.claude/rules/ |
セッションの開始時に読み込まれる |
| くり返す手順（デプロイ、レビュー） |
.claude/skills/ またはプラグイン |
必要なときだけ読み込む |
| 自分だけの好み・上書き |
~/.claude/settings.json、.claude/settings.local.json |
他の人に影響しない |
1.2 権限の設計
| 決まり |
内容（公式の Permissions） |
| deny が先 |
どの範囲の deny のルールも、allow のルールより先に評価される。ユーザーの deny は、プロジェクトの allow もふさぐ |
| リストは合わせて使う |
permissions.allow などのリストは、範囲をまたいで上書きではなく合わせて使われる |
| 管理設定の deny |
組織全体で止めたい操作（例: 本番の資格情報の読み取り、危険なコマンド）は管理設定の deny に |
| MCP サーバーを断る |
disabledMcpjsonServers で、.mcp.json のサーバーを名前で断れる |
| サンドボックス |
シェルのコマンドの書き込み先や通信先を制限する。権限のルールとあわせて使う |
1.3 監視と利用状況
公式の Monitoring によると、Claude Code は OpenTelemetry でメトリクス（時系列のデータ）、イベント（ログ）、任意で分散トレースを出せます。管理者は管理設定ですべての利用者の OpenTelemetry の設定を決められます。複数のチームがある組織は OTEL_RESOURCE_ATTRIBUTES でチームなどの属性を付けて分けられます。
| 何に使うか |
例 |
| 費用の把握 |
チームごとの使用量とコスト |
| 広がりの把握 |
セッション数（claude_code.session.count など）、使っている人数 |
| 安全の確認 |
ツールの使用、拒否された操作 |
注意: プロンプトなどの中身を記録するかは別の設定です。中身の記録はプライバシーと規制（ドメイン5）を考えて決めます。
1.4 広げ方（この教材の整理）
| 段階 |
やること |
| 1. 試行 |
少人数のチームで、共有の設定と CLAUDE.md を作る |
| 2. 決まりを固める |
管理設定で禁止の操作と監視を決める。セキュリティと合意 |
| 3. 部品を配る |
よく使う Skills、MCP サーバー、フックをプラグインやマーケットプレイスで配る |
| 4. 測る |
使用量、コスト、PR の数やレビューの時間など、決めた指標で効果を確かめる |
| 5. 改善 |
よくある失敗を CLAUDE.md や Skills に足す |
2. AI を使った開発のワークフローの改善
| ワークフロー |
Claude Code の使い方 |
気をつけること |
| 新しいコードベースの理解 |
Explore サブエージェント、質問しながら読む |
大きな探索はサブエージェントに分け、メインのコンテキストを守る |
| 大きな変更 |
plan mode で計画 → 人が確かめる → 実行 |
計画を確かめずに大きく変えない |
| テスト駆動 |
テストを先に書かせ、通るまで直させる |
テストを消してごまかさないよう指示とレビュー |
| コードレビュー |
CI のヘッドレスモード（-p、--output-format json、--json-schema）でレビューのコメントを作る |
生成したセッションとレビューのセッションを分ける |
| くり返す作業 |
Skills やカスタムのスラッシュコマンドにする |
手順を1か所で管理 |
| 並列の作業 |
複数のセッションや git worktree で別々の作業 |
同じファイルを同時に変えない |
効果の測り方（この教材の整理）: 「使った人数」だけでなく、PR のリードタイム、レビューの待ち時間、不具合の数など、業務の柱（ドメイン1 第6節）につながる指標で測ります。
3. デバッグと運用の問題解決の支え方
3.1 Claude Code で運用の問題を調べる
| やり方 |
例 |
| ログやスタックトレースを渡す |
エラーのログを読ませ、原因の候補と確かめ方を出させる |
| MCP で監視の道具につなぐ |
エラー追跡や監視のサービスの MCP サーバーから、エラーやメトリクスを読ませる（読み取り専用の権限で） |
| 再現のテストを書かせる |
不具合を再現するテストを先に作り、直したら通るか確かめる |
| 手順書（runbook）を Skill にする |
よくある障害の調べ方を Skill にして、誰でも同じ手順で調べる |
3.2 安全に使う
| 決まり |
理由 |
| 本番には読み取り専用の資格情報 |
調べるだけなら書き込みの権限は要らない（最小権限） |
| 本番を変える操作は人が承認 |
取り消せない変更を防ぐ。権限は ask、または管理設定の deny |
| 秘密情報を会話やログに出さない |
環境変数展開を使い、.env などは読ませない（deny のルール） |
| 調べた結果を記録する |
事故の振り返りと、次の Skill や CLAUDE.md の改善に使う |
3.3 Claude Code 自体の問題を調べる
| 症状 |
調べること |
| チームの決まりに従わない |
CLAUDE.md が読み込まれているか（階層、置き場所）。/memory で確かめる |
| 許可したはずの操作で毎回確認が出る |
別の範囲の deny や ask がないか（deny が先に評価される） |
| MCP のツールが出てこない |
.mcp.json の設定、承認、disabledMcpjsonServers、環境変数 |
| CI で止まる |
ヘッドレスモード（-p）か、権限が足りているか |
4. 試験に向けたまとめ
- 組織で必ず守らせる → 管理設定。チームで共有 →
.claude/settings.json・.mcp.json・CLAUDE.md をコミット。自分だけ → ローカル
- deny はどの範囲でも allow より先。管理設定は上書きできない
- 監視は OpenTelemetry。管理設定で全員に設定。中身の記録は別に判断
- ワークフローは plan mode、サブエージェント、ヘッドレスの CI レビュー、Skills
- 運用の調査は読み取り専用、変更は人の承認
5. 用語集
| 用語 |
意味 |
| 管理設定（managed settings） |
組織の管理者が配る、いちばん優先される設定 |
| deny-first |
拒否のルールを許可のルールより先に評価すること |
| サンドボックス |
コマンドが触れる場所や通信先を制限するしくみ |
| マーケットプレイス |
プラグインを配る場所 |
| runbook |
運用の手順書 |
出典
注意: 第1.4節の広げ方、第2節の効果の測り方、第3節の表は、この教材の整理です。設定のキー名とメトリクス名は変わりやすい情報です。