Jika organisasi Anda merutekan Claude melalui gateway LLM internal yang terhubung ke AWS Bedrock, Google Cloud Vertex AI, atau Microsoft Azure, Anda dapat menggunakan add-in Claude for Excel dan Claude for PowerPoint tanpa akun Claude.
Ini adalah pola gateway 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.
Persyaratan
Claude for Excel atau Claude for PowerPoint terinstal (dari Microsoft Marketplace atau diterapkan oleh admin Anda)
URL gateway dan token API dari tim IT Anda
Tim IT organisasi Anda mengelola gateway. Jika Anda tidak memiliki kredensial ini, hubungi mereka—Anthropic tidak dapat menyediakan atau mengatur ulang kredensial untuk Anda.
Instruksi koneksi gateway untuk pengguna akhir
Administrator perlu menerapkan Claude for Excel atau PowerPoint ke organisasi Anda sebelum Anda dapat terhubung. Untuk instruksi, lihat bagian berikut:
Setelah admin Anda menerapkan add-in, ikuti langkah-langkah berikut:
Buka Excel atau PowerPoint dan luncurkan add-in Claude.
Di layar masuk, pilih "Enterprise gateway."
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 mengirimkan permintaan uji ke gateway. Jika berhasil, Anda akan melihat pengalaman aplikasi utama.
Kredensial Anda disimpan secara lokal di localStorage browser Anda dalam iframe bersandbox add-in. Kredensial tidak disinkronkan ke server Anthropic. Karena add-in Office berjalan di dalam iframe bersandbox dalam aplikasi Microsoft, add-in tidak dapat menggunakan keychain OS seperti yang dilakukan Claude Code—untuk alasan ini, hanya masukkan token yang dikeluarkan gateway, bukan kredensial penyedia cloud mentah.
Ubah atau perbarui gateway Anda
Jika token API Anda kedaluwarsa atau tim IT Anda memberi Anda URL baru, buka "Settings" di sidebar add-in, masukkan nilai baru, dan pilih "Test connection."
Persyaratan gateway untuk tim IT
Add-in Office hanya mendukung format Anthropic Messages API melalui endpoint Unified. Ini lebih spesifik daripada Claude Code, yang juga mendukung format Bedrock InvokeModel dan Vertex rawPredict secara langsung.
Endpoint yang diperlukan
Gateway Anda harus mengekspos dua endpoint ini:
Endpoint | Deskripsi |
| Kirim pesan ke Claude. Mendukung respons streaming dan non-streaming. |
| Dapatkan 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 untuk meneruskan header ini dapat mengakibatkan fungsionalitas berkurang atau mencegah add-in bekerja.
Penemuan model
Saat masuk, 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 kepada pengguna untuk ID model secara manual.
Perbedaan dari setup gateway Claude Code
Aspek | Claude Code | Claude for Excel dan PowerPoint |
Format API yang didukung | Anthropic Messages, Bedrock InvokeModel, Vertex rawPredict | Anthropic Messages saja (endpoint Unified) |
Jenis endpoint | Unified dan pass-through | Unified 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 (URL dan token) |
Penyegaran token | Mendukung skrip pembantu untuk rotasi | Entri ulang manual di pengaturan |
Nama model kustom | Dapat dikonfigurasi melalui variabel lingkungan | Tidak dapat dikonfigurasi di v1 |
Contoh konfigurasi gateway dengan LiteLLM
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.
Catatan: LiteLLM adalah perangkat lunak open-source pihak ketiga dan tidak dikelola oleh Anthropic.
Perutean langsung ke Anthropic
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
# Aktifkan endpoint Anthropic unified
# Ini adalah apa yang akan dipanggil add-in Office
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
Perbarui litellm_config.yaml Anda:
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
Perbarui litellm_config.yaml Anda:
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 instruksi setup terperinci, lihat dokumentasi format Anthropic LiteLLM.
Apa yang dikumpulkan Anthropic
Ketika Anda menggunakan add-in melalui gateway, Anthropic mengumpulkan informasi sesuai dengan syarat AWS Bedrock, Google Cloud Vertex AI, atau Microsoft Azure dan 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 lainnya--dan menggunakan metadata tersebut untuk tujuan analitik dan peningkatan produk.
Untuk detail tentang apa yang dicatat gateway 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 gateway, add-in mengirimkan permintaan ke infrastruktur organisasi Anda sebagai gantinya, dan tim IT Anda mengontrol bagaimana lalu lintas itu dirutekan dan dicatat.
Beberapa fitur yang bergantung pada memiliki akun Claude belum tersedia melalui gateway, tetapi kami sedang mengerjakan penambahan dukungan segera:
Fitur | Akun Claude | Gateway enterprise |
Obrolan dengan spreadsheet atau deck Anda | ✓ | ✓ |
Baca dan edit sel, slide, rumus | ✓ | ✓ |
Konektor (S&P, FactSet, dll.) | ✓ | — |
Bekerja lintas aplikasi | ✓ | — |
Keterampilan | ✓ | — |
Unggahan file | ✓ | — |
Memori | ✓ | — |
Pencarian web | ✓ | Vertex saja |
Jika tim Anda membutuhkan fitur-fitur ini, bicarakan dengan admin Claude Anda tentang jalur masuk mana yang sesuai untuk organisasi Anda.
Pemecahan masalah
"Connection refused" atau kesalahan jaringan
URL gateway tidak dapat dijangkau dari jaringan pengguna. Verifikasi URL sudah benar, gateway sedang berjalan, dan tidak ada pembatasan firewall atau VPN yang memblokir koneksi.
401 Unauthorized atau "Invalid token"
Token autentikasi tidak valid atau kedaluwarsa. Konfirmasi token dengan tim IT Anda. Token gateway dikelola oleh organisasi Anda, bukan Anthropic.
403 Forbidden atau "Access denied"
Token valid tetapi tidak memiliki izin yang tepat. Untuk Bedrock, verifikasi peran IAM gateway memiliki izin bedrock:InvokeModel. Untuk Vertex, verifikasi akun layanan memiliki izin aiplatform.endpoints.predict. Hubungi admin IT Anda untuk izin yang benar.
404 Not Found
Add-in tidak dapat menjangkau jalur API yang diharapkan. Verifikasi URL gateway adalah URL dasar (misalnya, https://litellm-server:4000) — jangan sertakan /v1/messages di bidang URL.
500 atau kesalahan server lainnya
Gateway mengalami kesalahan internal. Periksa log gateway Anda (misalnya, docker logs litellm jika menggunakan LiteLLM) untuk kesalahan penyedia upstream. Coba permintaan lagi, dan hubungi admin IT Anda jika masalah berlanjut.
"No models available"
Add-in tidak dapat menemukan model Claude di gateway Anda. Gateway Anda mungkin tidak mengekspos daftar model di GET /model/info. Tim IT Anda dapat mengonfigurasi gateway untuk melayani daftar model atau memberi Anda ID model spesifik untuk dimasukkan secara manual saat diminta.
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 ada
Konektor, Keterampilan, unggahan file, dan memori tidak tersedia melalui gateway enterprise. Jika Anda membutuhkan ini, tanyakan kepada admin Anda tentang masuk dengan akun Claude sebagai gantinya.