Jika organisasi Anda menggunakan AWS Bedrock, Google Cloud Vertex AI, atau gateway LLM untuk mengakses Claude, Anda dapat menggunakan add-in Claude untuk Excel dan Claude untuk PowerPoint tanpa akun Claude. Add-in terhubung melalui infrastruktur organisasi Anda, sehingga prompt dan respons Anda tetap berada dalam batas kepercayaan yang ada.
Ada tiga jalur koneksi, tergantung pada cara organisasi Anda mengakses Claude:
Gateway LLM: Add-in mengirimkan permintaan ke gateway Anda (LiteLLM, Portkey, Kong, dll.), yang merutekannya ke penyedia pilihan Anda. Ini adalah pola yang sama yang digunakan oleh Claude Code. Jika organisasi Anda sudah menjalankan Claude Code melalui gateway LLM, Anda dapat mengarahkan add-in Office ke endpoint yang sama—tidak diperlukan infrastruktur baru.
Bedrock langsung: Add-in melakukan autentikasi melalui Microsoft Entra ID dan memanggil AWS Bedrock secara langsung, tanpa gateway di antaranya.
Vertex AI langsung: Add-in melakukan autentikasi melalui Google OAuth dan memanggil Vertex AI secara langsung.
Admin IT Anda memilih jalur selama penyebaran. Sebagai pengguna akhir, pengalaman sama terlepas dari jalur mana yang digunakan organisasi Anda.
Persyaratan
Persyaratan bervariasi menurut jalur koneksi.
Semua jalur:
Claude untuk Excel atau Claude untuk PowerPoint terpasang (dari Microsoft AppSource atau disebarkan oleh admin Anda)
Microsoft 365 dengan Entra ID (untuk persetujuan admin dan, di jalur cloud langsung, penerbitan token)
Gateway LLM:
URL gateway dan token API dari tim IT Anda
Bedrock langsung:
Akun AWS dengan akses model Claude diaktifkan di wilayah target
Penyedia identitas OIDC IAM dan peran yang dikonfigurasi untuk mempercayai token Microsoft Entra ID
Vertex AI langsung:
Proyek Google Cloud dengan API Vertex AI diaktifkan dan akses model Claude di wilayah target
Klien Google OAuth yang dikonfigurasi dengan URI pengalihan add-in
Tim IT organisasi Anda mengelola sumber daya ini. Jika Anda tidak memiliki kredensial yang Anda butuhkan, hubungi mereka—Anthropic tidak dapat menyediakan atau mengatur ulang kredensial untuk Anda.
Daftar izin jaringan
Add-in perlu menjangkau domain tertentu untuk berfungsi. Domain mana yang tergantung pada apakah organisasi Anda menggunakan API Anthropic secara langsung (1P) atau platform pihak ketiga (3P). Bagikan tabel yang berlaku dengan tim jaringan atau keamanan Anda sehingga mereka dapat menambahkan domain ini ke daftar izin.
Penting: Di semua konfigurasi—termasuk pihak ketiga—prompt Anda dan respons Claude hanya bepergian ke penyedia inferensi pilihan Anda (gateway, Bedrock, atau Vertex AI). Domain yang tercantum di bawah yang menunjuk ke Anthropic (seperti pivot.claude.ai) melayani antarmuka add-in, konfigurasi fitur, dan telemetri operasional. Mereka tidak membawa konten prompt atau respons.
API Anthropic (1P)
Gunakan tabel ini jika orang-orang di organisasi Anda masuk dengan akun Claude dan inferensi menuju api.anthropic.com.
Domain | Diperlukan saat | Tujuan |
pivot.claude.ai | Selalu | Host add-in. Melayani UI panel tugas dan proxy analitik, pencarian ikon, unduhan keterampilan, dan telemetri. |
claude.ai | Selalu | Masuk OAuth Anthropic dan evaluasi bendera fitur. |
api.anthropic.com | Selalu | API inferensi Claude, unggahan file, kontainer eksekusi kode, dan registri konektor MCP. |
appsforoffice.microsoft.com | Selalu | Skrip runtime Microsoft Office.js. Diperlukan oleh setiap add-in Office. |
o1158394.ingest.us.sentry.io | Opsional | Pelaporan kerusakan dan kesalahan. Memblokir ini hanya mengurangi diagnostik; add-in masih berfungsi. |
mcp-proxy.anthropic.com | Jika menggunakan konektor MCP | Proxy untuk panggilan alat konektor MCP. |
bridge.claudeusercontent.com | Jika menggunakan pekerjaan lintas aplikasi | Jembatan WebSocket untuk fitur bekerja lintas aplikasi. |
Platform pihak ketiga (3P)
Gunakan tabel ini jika orang-orang di organisasi Anda masuk dengan Microsoft Entra ID dan inferensi menuju gateway LLM, Bedrock, atau Vertex AI Anda.
Domain | Diperlukan saat | Tujuan |
pivot.claude.ai | Selalu | Host add-in. Melayani UI panel tugas dan proksi analitik, pencarian ikon, dan telemetri. |
claude.ai/api/ | Selalu | Evaluasi bendera fitur. Tanpa masuk; add-in hanya mengambil konfigurasinya dari sini. |
appsforoffice.microsoft.com | Selalu | Skrip runtime Microsoft Office.js (diperlukan oleh setiap add-in Office). |
login.microsoftonline.com | Selalu | Masuk Microsoft Entra ID melalui Nested App Auth. Membaca konfigurasi gateway yang disediakan admin dan mengeluarkan token untuk autentikasi cloud langsung. |
o1158394.ingest.us.sentry.io | Opsional | Pelaporan kerusakan dan kesalahan. Memblokir ini hanya mengurangi diagnostik; add-in tetap berfungsi. |
URL gateway LLM Anda | Jika menggunakan gateway LLM | Gateway LLM organisasi Anda (LiteLLM, Portkey, Kong, dll.). Inferensi menuju sini alih-alih api.anthropic.com. |
sts.amazonaws.com | Jika menggunakan Bedrock langsung | AWS STS. Menukar token Entra ID dengan kredensial Bedrock sementara. |
bedrock-runtime.<region>.amazonaws.com | Jika menggunakan Bedrock langsung | Titik akhir inferensi Bedrock. Ganti <region> dengan wilayah AWS yang dikonfigurasi (misalnya, us-east-1). |
accounts.google.com | Jika menggunakan Vertex AI langsung | Layar persetujuan Google OAuth. |
oauth2.googleapis.com | Jika menggunakan Vertex AI langsung | Pertukaran dan penyegaran token Google OAuth. |
aiplatform.googleapis.com | Jika menggunakan Vertex AI langsung | Titik akhir inferensi global Vertex AI. |
<region>-aiplatform.googleapis.com | Jika menggunakan Vertex AI langsung | Titik akhir inferensi regional Vertex AI. Ganti <region> dengan wilayah GCP yang dikonfigurasi (misalnya, us-east5). |
Terapkan add-in untuk penggunaan pihak ketiga (admin IT)
Gunakan plugin claude-in-office untuk mengonfigurasi dan menerapkan add-in di seluruh organisasi Anda. Alat ini menangani penyediaan sumber daya cloud (jika menggunakan Bedrock atau Vertex AI langsung), menghasilkan manifes add-in, dan memperoleh persetujuan admin dalam satu alur terpandu.
Gunakan wizard penyiapan
Instal plugin dan jalankan wizard penyiapan interaktif:
claude plugin marketplace add anthropics/financial-services-plugins
claude plugin install claude-in-office@financial-services-plugins
/claude-in-office:setup
Wizard memandu Anda melalui jalur koneksi Anda:
Gateway LLM: Mengumpulkan URL dan token gateway Anda, menghasilkan manifes, dan menangani persetujuan admin Azure.
Bedrock langsung: Membuat penyedia identitas OIDC IAM dan peran, menghasilkan manifes, dan menangani persetujuan admin Azure.
Vertex AI langsung: Memandu Anda membuat klien Google OAuth, menghasilkan manifes, dan menangani persetujuan admin Azure.
Ketika wizard selesai, add-in siap untuk digunakan di seluruh tenant.
Catatan: Jalur Bedrock dan Vertex AI memerlukan Node.js untuk pembuatan dan validasi manifest. Wizard memeriksa dan meminta Anda untuk menginstalnya jika tidak ada.
Anda dapat menggunakan perintah berikut di dalam sesi claude-in-office:
Perintah | Fungsinya |
| Wizard interaktif—menyediakan sumber daya cloud, persetujuan admin, menulis manifest |
| Menghasilkan XML manifest add-in yang disesuaikan |
| Menghasilkan URL persetujuan admin Azure untuk pendaftaran aplikasi add-in |
| Menulis konfigurasi per-pengguna melalui atribut ekstensi Microsoft Graph |
Apa yang disediakan wizard
Wizard mengotomatisasi pembuatan sumber daya berdasarkan jalur koneksi Anda. Berikut yang diatur:
Gateway LLM: Tidak ada sumber daya cloud untuk disediakan. Wizard mengumpulkan URL gateway dan token Anda, kemudian menghasilkan manifest.
Bedrock langsung: Membuat penyedia identitas OIDC IAM yang mempercayai token Microsoft Entra ID, peran dengan izin bedrock:InvokeModel dan bedrock:InvokeModelWithResponseStream, dan kebijakan kepercayaan yang dibatasi pada ID aplikasi add-in Claude.
Vertex AI langsung: Memandu Anda membuat klien OAuth Google di GCP Console (langkah ini tidak dapat diotomatisasi melalui CLI), mengaktifkan API Vertex AI, dan menangkap ID klien dan rahasia untuk manifest.
Konfigurasi per-pengguna
Jika beberapa nilai berbeda per pengguna—misalnya, token gateway berbeda atau peran AWS berbeda untuk tim yang berbeda—wizard dapat menulis konfigurasi per-pengguna melalui atribut ekstensi Microsoft Graph. Jalankan /claude-in-office:update-user-attrs dengan kunci per-pengguna setelah pengaturan awal.
Terapkan ke Microsoft 365
Setelah wizard menghasilkan manifest Anda:
Buka Microsoft 365 Admin Center dan buka Pengaturan > Aplikasi Terintegrasi > Unggah aplikasi khusus.
Pilih "Office Add-in" sebagai jenis aplikasi, kemudian unggah file manifest.xml.
Pilih siapa yang mendapatkan add-in:
Jika semua pengguna berbagi konfigurasi yang sama, pilih "Seluruh organisasi."
Jika Anda menulis atribut per-pengguna di langkah sebelumnya, tetapkan ke Pengguna/grup tertentu yang cocok persis dengan yang dikonfigurasi. Siapa pun yang lain akan membuka add-in tanpa konfigurasi.
Terima izin dan selesaikan penerapan.
Penyebaran ke pengguna memakan waktu hingga 24 jam (biasanya jauh lebih cepat). Add-in muncul di bawah Beranda > Add-in di Excel dan PowerPoint setelah tiba.
Catatan: Mulai dengan grup pilot untuk mengonfirmasi add-in berfungsi, kemudian perluas penugasan. Anda dapat mengubah penugasan nanti tanpa menerapkan ulang.
Setelah menerapkan add-in, pengguna Anda dapat terhubung dengan mengikuti langkah-langkah di bawah ini.
Instruksi koneksi untuk pengguna akhir
Gateway LLM
Buka Excel atau PowerPoint dan luncurkan add-in Claude.
Di layar masuk, pilih "Gateway perusahaan."
Masukkan URL Gateway dan token API yang disediakan tim IT Anda.
URL Gateway: URL dasar HTTPS dari proxy LLM Anda (misalnya, https://llm-gateway.yourcompany.com).
Token API: Token pembawa yang diharapkan proxy Anda. Add-in mengirimkan ini di header Authorization: Bearer <token> dengan setiap permintaan.
Add-in memeriksa koneksi dengan mengirim permintaan uji ke gateway. Jika berhasil, Anda akan melihat pengalaman aplikasi utama.
Kredensial Anda disimpan secara lokal di localStorage browser Anda dalam iframe sandbox add-in. Mereka tidak disinkronkan ke server Anthropic. Karena add-in Office berjalan di dalam iframe sandbox dalam aplikasi Microsoft, add-in tidak dapat menggunakan keychain OS Anda seperti yang dilakukan Claude Code—untuk alasan ini, hanya masukkan token yang dikeluarkan gateway, bukan kredensial penyedia cloud mentah.
Bedrock atau Vertex AI langsung
Buka Excel atau PowerPoint dan luncurkan add-in Claude.
Masuk dengan akun kerja Microsoft Anda. Add-in menggunakan token Entra ID Anda untuk autentikasi dengan penyedia cloud Anda—tidak diperlukan kredensial cloud terpisah.
Add-in membaca konfigurasi yang disediakan admin Anda dan terhubung ke Bedrock atau Vertex AI secara langsung.
Jika Anda melihat kesalahan saat masuk, konfirmasi dengan tim IT Anda bahwa akun Anda ada di grup yang ditugaskan ke add-in.
Ubah atau perbarui koneksi Anda
Jika token API Anda kedaluwarsa atau tim IT Anda memberi Anda URL baru, buka "Pengaturan" di bilah sisi add-in, masukkan nilai baru, dan pilih "Uji koneksi."
Persyaratan gateway untuk tim IT
Add-in Office hanya mendukung format API Pesan Anthropic melalui titik akhir Terpadu. Ini lebih spesifik daripada Claude Code, yang juga mendukung format Bedrock InvokeModel dan Vertex rawPredict secara langsung.
Titik akhir yang diperlukan
Gateway Anda harus mengekspos dua endpoint ini:
Endpoint | Deskripsi |
/v1/messages | Kirim pesan ke Claude. Mendukung respons streaming dan non-streaming. |
/v1/models | Daftar model yang tersedia. |
Header yang diperlukan
Gateway harus meneruskan header permintaan berikut dari add-in ke penyedia upstream:
anthropic-beta — Mengaktifkan fitur beta yang diperlukan oleh add-in.
anthropic-version — Menentukan versi API untuk format permintaan/respons.
Kegagalan meneruskan header ini dapat mengakibatkan fungsionalitas berkurang atau mencegah add-in berfungsi.
Penemuan model
Saat login, add-in memvalidasi token melalui GET /v1/messages dan kemudian mencoba menemukan model Claude yang tersedia melalui GET /v1/models. Jika gateway Anda tidak mengekspos daftar model di jalur tersebut, add-in akan kembali ke permintaan ID model secara manual kepada pengguna.
Perbedaan dari pengaturan gateway Claude Code
Aspek | Claude Code | Claude untuk Excel dan PowerPoint |
Format API yang didukung | Anthropic Messages, Bedrock InvokeModel, Vertex rawPredict | Anthropic Messages saja (Endpoint Terpadu) |
Jenis endpoint | Terpadu dan pass-through | Terpadu saja |
Penyimpanan kredensial | Keychain OS atau variabel lingkungan | Browser localStorage (iframe bersandbox) |
Konfigurasi autentikasi | Variabel lingkungan, file pengaturan, skrip pembantu | Entri manual di UI add-in (gateway) atau Entra ID (cloud langsung) |
Penyegaran token | Mendukung skrip pembantu untuk rotasi | Entri ulang manual di pengaturan (gateway) atau otomatis melalui Entra ID (cloud langsung) |
Nama model khusus | Dapat dikonfigurasi melalui variabel lingkungan | Tidak dapat dikonfigurasi di v1 |
Contoh konfigurasi gateway dengan LiteLLM
Peringatan: Versi PyPI LiteLLM 1.82.7 dan 1.82.8 dikompromikan dengan malware pencuri kredensial. Jangan instal versi ini. Jika Anda telah menginstalnya:
Hapus paket
Putar semua kredensial pada sistem yang terpengaruh
Ikuti langkah remediasi di BerriAI/litellm#24518
LiteLLM adalah layanan proxy pihak ketiga. Anthropic tidak mendukung, memelihara, atau mengaudit keamanan atau fungsionalitas LiteLLM. Panduan ini disediakan untuk tujuan informasi dan mungkin menjadi usang. Gunakan atas kebijakan Anda sendiri.
Banyak organisasi menggunakan LiteLLM sebagai gateway mereka. Di bawah ini adalah litellm_config.yaml minimal untuk merutekan permintaan add-in Office ke Anthropic, Bedrock, atau Vertex.
Perutean ke Anthropic secara langsung
yaml
model_list:
- model_name: claude-sonnet-4-5-20250929
litellm_params:
model: claude-sonnet-4-5-20250929
api_key: os.environ/ANTHROPIC_API_KEY
litellm_settings:
drop_params: true
Perutean ke Amazon Bedrock
yaml
model_list:
- model_name: claude-sonnet-4-5-20250929
litellm_params:
model: bedrock/anthropic.claude-sonnet-4-5-20250929-v1:0
aws_region_name: us-east-1
litellm_settings:
drop_params: true
Perutean ke Google Cloud Vertex AI
yaml
model_list:
- model_name: claude-sonnet-4-5-20250929
litellm_params:
model: vertex_ai/claude-sonnet-4-5-20250929
vertex_project: your-gcp-project-id
vertex_location: us-east5
litellm_settings:
drop_params: true
Perutean ke Azure
yaml
model_list:
- model_name: claude-sonnet-4-5-20250929
litellm_params:
model: azure_ai/claude-sonnet-4-5-20250929
api_base: https://your-resource.services.ai.azure.com/anthropic
api_key: os.environ/AZURE_API_KEY
extra_headers:
x-api-key: os.environ/AZURE_API_KEY
litellm_settings:
drop_params: true
Untuk petunjuk penyiapan terperinci, lihat dokumentasi format Anthropic LiteLLM.
Apa yang dikumpulkan Anthropic
Bahkan ketika inferensi berjalan melalui infrastruktur Anda sendiri, add-in berkomunikasi dengan pivot.claude.ai untuk memuat antarmukanya dan dengan claude.ai/api/ untuk mengevaluasi bendera fitur. Koneksi ini mengirimkan telemetri operasional—seperti fitur mana yang digunakan, waktu kinerja, dan tingkat kesalahan—sehingga Anthropic dapat mempertahankan dan meningkatkan pengalaman add-in. Mereka tidak mengirimkan prompt Anda atau respons Claude.
Anthropic mengumpulkan informasi sesuai dengan AWS Bedrock, Google Cloud Vertex AI, atau persyaratan Microsoft Azure, konsisten dengan pengaturan Anthropic dengan pelanggan. Anthropic tidak memiliki akses ke instans AWS, Google, atau Microsoft pelanggan, termasuk prompt atau output yang dikandungnya. Anthropic tidak melatih model generatif dengan konten tersebut atau menggunakannya untuk tujuan lain. Anthropic dapat mengakses metadata—seperti penggunaan alat, jumlah token, dan item serupa—dan menggunakan metadata tersebut untuk tujuan analitik dan peningkatan produk.
Untuk detail tentang apa yang dicatat oleh gateway atau penyedia cloud organisasi Anda, hubungi tim IT Anda.
Bagaimana ini berbeda dari masuk dengan akun Claude
Ketika Anda masuk dengan akun Claude, add-in terhubung langsung ke Anthropic. Ketika Anda terhubung melalui platform pihak ketiga, add-in mengirimkan permintaan inferensi ke infrastruktur organisasi Anda, dan tim IT Anda mengontrol bagaimana lalu lintas itu dirutekan dan dicatat.
Beberapa fitur yang bergantung pada memiliki akun Claude belum tersedia melalui platform pihak ketiga, tetapi kami sedang mengerjakan penambahan dukungan:
Fitur | Akun Claude | Platform pihak ketiga |
Obrolan dengan spreadsheet atau deck Anda | ✓ | ✓ |
Baca dan edit sel, slide, rumus | ✓ | ✓ |
Konektor (S&P, FactSet, dll.) | ✓ | Segera hadir |
Bekerja di seluruh aplikasi | ✓ | — |
Keterampilan | ✓ | Segera hadir |
Unggahan file | ✓ | — |
Pencarian web | ✓ | Hanya Vertex |
Jika tim Anda memerlukan fitur-fitur ini, bicarakan dengan admin Claude Anda tentang jalur masuk mana yang sesuai untuk organisasi Anda.
Pemecahan masalah
"Koneksi ditolak" atau kesalahan jaringan
URL gateway atau titik akhir cloud tidak dapat dijangkau dari jaringan pengguna. Verifikasi URL sudah benar, layanan sedang berjalan, dan tidak ada pembatasan firewall atau VPN yang memblokir koneksi. Periksa bagian Daftar izin jaringan di atas untuk mengonfirmasi semua domain yang diperlukan diizinkan.
401 Tidak Sah atau "Token tidak valid"
Token autentikasi tidak valid atau kedaluwarsa. Untuk koneksi gateway, konfirmasi token dengan tim IT Anda. Untuk koneksi cloud langsung, verifikasi akun Entra ID pengguna ada di grup yang ditugaskan dan kepercayaan OIDC atau klien OAuth dikonfigurasi dengan benar.
403 Terlarang atau "Akses ditolak"
Token valid tetapi tidak memiliki izin yang tepat. Untuk Bedrock, verifikasi peran IAM memiliki izin bedrock:InvokeModel. Untuk Vertex, verifikasi akun layanan memiliki izin aiplatform.endpoints.predict. Untuk gateway, periksa cakupan token dengan admin IT Anda.
404 Tidak ditemukan
Add-in tidak dapat menjangkau jalur API yang diharapkan. Untuk gateway, verifikasi URL adalah URL dasar (misalnya, https://litellm-server:4000)—jangan sertakan /v1/messages di bidang URL.
500 atau kesalahan server lainnya
Gateway atau penyedia cloud mengalami kesalahan internal. Periksa log gateway Anda (misalnya, docker logs litellm jika menggunakan LiteLLM) untuk kesalahan penyedia hulu. Coba permintaan lagi, dan hubungi admin IT Anda jika masalah berlanjut.
"Tidak ada model tersedia"
Add-in tidak dapat menemukan model Claude. Untuk gateway, gateway Anda mungkin tidak mengekspos daftar model di GET /v1/models. Tim IT Anda dapat mengonfigurasi gateway untuk melayani daftar model atau memberi Anda ID model tertentu untuk dimasukkan secara manual. Untuk Bedrock atau Vertex, konfirmasi bahwa setidaknya satu model Claude (Claude Sonnet 4.5 atau lebih baru) diaktifkan di akun dan wilayah Anda.
Respons streaming gagal atau hang
Verifikasi bahwa gateway Anda mendukung pass-through Server-Sent Events (SSE). Beberapa konfigurasi proxy menghapus atau membuffer koneksi SSE, yang mencegah respons streaming mencapai add-in.
Fitur yang saya harapkan tidak tersedia
Konektor, keterampilan, unggahan file, dan Bekerja Lintas Aplikasi belum tersedia melalui platform pihak ketiga. Jika Anda membutuhkannya, minta admin Anda untuk masuk dengan akun Claude sebagai gantinya.