vault backup: 2026-06-09 23:15:17

2026-06-09 23:15:17 +08:00
parent 31fd89aafe
commit e92c0327d9
111 changed files with 7276 additions and 8846 deletions
@@ -1,8 +1,17 @@
+---
+tags: [claude-code, 远程依赖, API, 网络, 安全]
+create time: 2026-06-09 22:30
+---
+
 # Claude Code 远程服务器依赖

-> 只列出代码中实际发起网络请求的远程服务。本地服务、npm 包依赖、展示用 URL 不包含在内。
+## 概述

-## 总览表
+Claude Code 在运行时会与多个远程服务通信，包括 LLM 推理 API、云厂商适配层、OAuth 认证、功能开关、错误追踪、日志收集等。本文档只列出代码中实际发起网络请求的远程服务，本地服务、npm 包依赖、展示用 URL 不包含在内。
+
+## 正文
+
+### 总览表

 | # | 服务 | 远程端点 | 协议 | 状态 |
 |---|---|---|---|---|
@@ -19,7 +28,7 @@
 | 11 | BigQuery Metrics | `api.anthropic.com/api/claude_code/metrics` | HTTPS | 默认启用 |
 | 12 | MCP Proxy | `mcp-proxy.anthropic.com` | HTTPS+WS | 使用 MCP 工具时 |
 | 13 | MCP Registry | `api.anthropic.com/mcp-registry` | HTTPS | 查询 MCP 服务器时 |
-| 14 | Web Search Pages | `www.bing.com`, `search.brave.com` | HTTPS | WebSearch 工具，可通过 `WEB_SEARCH_ADAPTER=bing|brave` 切换 |
+| 14 | Web Search Pages | `www.bing.com`, `search.brave.com` | HTTPS | WebSearch 工具，可通过 `WEB_SEARCH_ADAPTER=bing\|brave` 切换 |
 | 15 | Google Cloud Storage (更新) | `storage.googleapis.com` | HTTPS | 版本检查 |
 | 16 | GitHub Raw (Changelog/Stats) | `raw.githubusercontent.com` | HTTPS | 更新提示 |
 | 17 | Claude in Chrome Bridge | `bridge.claudeusercontent.com` | WSS | Chrome 集成 |
@@ -27,11 +36,9 @@
 | 19 | Voice STT | `api.anthropic.com/api/ws/...` | WSS | Voice Mode |
 | 20 | Desktop App Download | `claude.ai/api/desktop/...` | HTTPS | 下载引导 |

---
+### 详细说明

-## 详细说明
-
-### 1. Anthropic Messages API
+#### 1. Anthropic Messages API

 核心 LLM 推理服务，发送对话消息、接收流式响应。

@@ -40,25 +47,25 @@
 - **认证**: API Key / OAuth Token
 - **文件**: `src/services/api/client.ts`, `src/services/api/claude.ts`

-### 2. AWS Bedrock
+#### 2. AWS Bedrock

 - **端点**: `bedrock-runtime.{region}.amazonaws.com`
 - **认证**: AWS 凭证链 / `AWS_BEARER_TOKEN_BEDROCK`
 - **文件**: `src/services/api/client.ts:153-190`, `src/utils/aws.ts`

-### 3. Google Vertex AI
+#### 3. Google Vertex AI

 - **端点**: `{region}-aiplatform.googleapis.com`
 - **认证**: `GoogleAuth` + `cloud-platform` scope
 - **文件**: `src/services/api/client.ts:221-298`

-### 4. Azure Foundry
+#### 4. Azure Foundry

 - **端点**: `https://{resource}.services.ai.azure.com/anthropic/v1/messages`
 - **认证**: API Key 或 Azure AD `DefaultAzureCredential`
 - **文件**: `src/services/api/client.ts:191-220`

-### 5. OAuth
+#### 5. OAuth

 OAuth 2.0 + PKCE 授权码流程。

@@ -72,41 +79,41 @@ OAuth 2.0 + PKCE 授权码流程。
  - `https://claude.fedstart.com` — FedStart 政府部署
 - **文件**: `src/constants/oauth.ts`, `src/services/oauth/`

-### 6. GrowthBook (功能开关)
+#### 6. GrowthBook (功能开关)

 - **端点**: `https://api.anthropic.com/` (remoteEval 模式) 或 `CLAUDE_GB_ADAPTER_URL`
 - **SDK Keys**: `sdk-zAZezfDKGoZuXXKe` (外部), `sdk-xRVcrliHIlrg4og4` (ant prod), `sdk-yZQvlplybuXjYh6L` (ant dev)
 - **文件**: `src/services/analytics/growthbook.ts`, `src/constants/keys.ts`

-### 7. Sentry (错误追踪)
+#### 7. Sentry (错误追踪)

 - **激活**: 设置 `SENTRY_DSN` (默认未配置)
 - **行为**: 仅错误上报，自动过滤敏感 header
 - **文件**: `src/utils/sentry.ts`

-### 8. Datadog (日志)
+#### 8. Datadog (日志)

 - **激活**: 同时设 `DATADOG_LOGS_ENDPOINT` + `DATADOG_API_KEY` (默认未配置)
 - **文件**: `src/services/analytics/datadog.ts`

-### 9. OpenTelemetry Collector
+#### 9. OpenTelemetry Collector

 - **激活**: `CLAUDE_CODE_ENABLE_TELEMETRY=1` 或 `OTEL_*` 环境变量
 - **协议**: gRPC / HTTP / Protobuf，支持 OTLP 和 Prometheus 导出
 - **文件**: `src/utils/telemetry/instrumentation.ts`

-### 10. 1P Event Logging (内部事件)
+#### 10. 1P Event Logging (内部事件)

 - **端点**: `https://api.anthropic.com/api/event_logging/batch`
 - **协议**: 批量导出 (10s 间隔, 每批 200 事件)
 - **文件**: `src/services/analytics/firstPartyEventLoggingExporter.ts`

-### 11. BigQuery Metrics
+#### 11. BigQuery Metrics

 - **端点**: `https://api.anthropic.com/api/claude_code/metrics`
 - **文件**: `src/utils/telemetry/bigqueryExporter.ts`

-### 12. MCP Proxy
+#### 12. MCP Proxy

 Anthropic 托管的 MCP 服务器代理。

@@ -114,17 +121,16 @@ Anthropic 托管的 MCP 服务器代理。
 - **认证**: Claude.ai OAuth tokens
 - **文件**: `src/services/mcp/client.ts`, `src/constants/oauth.ts`

-### 13. MCP Registry
+#### 13. MCP Registry

 获取官方 MCP 服务器列表。

 - **端点**: `https://api.anthropic.com/mcp-registry/v0/servers?version=latest&visibility=commercial`
 - **文件**: `src/services/mcp/officialRegistry.ts`

-### 14. Web Search Pages
+#### 14. Web Search Pages

-WebSearch 工具支持直接抓取 Bing 搜索结果页面，也支持通过 Brave 的 LLM Context API
-获取搜索上下文；可通过 `WEB_SEARCH_ADAPTER=bing|brave` 显式切换后端。
+WebSearch 工具支持直接抓取 Bing 搜索结果页面，也支持通过 Brave 的 LLM Context API 获取搜索上下文；可通过 `WEB_SEARCH_ADAPTER=bing|brave` 显式切换后端。

 - **Bing 端点**: `https://www.bing.com/search?q={query}&setmkt=en-US`
 - **Brave 端点**: `https://api.search.brave.com/res/v1/llm/context?q={query}`
@@ -136,42 +142,40 @@ WebSearch 工具支持直接抓取 Bing 搜索结果页面，也支持通过 Bra
 - **端点**: `https://api.anthropic.com/api/web/domain_info?domain={domain}`
 - **文件**: `packages/builtin-tools/src/tools/WebFetchTool/utils.ts`

-### 15. Google Cloud Storage (自动更新)
+#### 15. Google Cloud Storage (自动更新)

 - **端点**: `https://storage.googleapis.com/claude-code-dist-86c565f3-f756-42ad-8dfa-d59b1c096819/claude-code-releases`
 - **文件**: `src/utils/autoUpdater.ts`

-### 16. GitHub Raw Content
+#### 16. GitHub Raw Content

 - **端点**: `https://raw.githubusercontent.com/anthropics/claude-code/refs/heads/main/CHANGELOG.md`
 - **端点**: `https://raw.githubusercontent.com/anthropics/claude-plugins-official/refs/heads/stats/stats/plugin-installs.json`
 - **文件**: `src/utils/releaseNotes.ts`, `src/utils/plugins/installCounts.ts`

-### 17. Claude in Chrome Bridge
+#### 17. Claude in Chrome Bridge

 - **端点**: `wss://bridge.claudeusercontent.com` (生产) / `wss://bridge-staging.claudeusercontent.com` (staging)
 - **文件**: `src/utils/claudeInChrome/mcpServer.ts`

-### 18. CCR Upstream Proxy
+#### 18. CCR Upstream Proxy

 - **端点**: `ws://api.anthropic.com/v1/code/upstreamproxy/ws`
 - **激活**: `CLAUDE_CODE_REMOTE=1` + `CCR_UPSTREAM_PROXY_ENABLED=1`
 - **文件**: `src/upstreamproxy/upstreamproxy.ts`

-### 19. Voice STT
+#### 19. Voice STT

 - **端点**: `wss://api.anthropic.com/api/ws/...`
 - **文件**: `src/services/voiceStreamSTT.ts`

-### 20. Desktop App Download
+#### 20. Desktop App Download

 - **端点**: `https://claude.ai/api/desktop/win32/x64/exe/latest/redirect` (Windows)
 - **端点**: `https://claude.ai/api/desktop/darwin/universal/dmg/latest/redirect` (macOS)
 - **文件**: `src/components/DesktopHandoff.tsx`

---
-
-## Anthropic API 辅助端点汇总
+### Anthropic API 辅助端点汇总

 以下端点都挂在 `api.anthropic.com` 上，按功能分类:

@@ -197,7 +201,7 @@ WebSearch 工具支持直接抓取 Bing 搜索结果页面，也支持通过 Bra
 | `/v1/code/triggers` | 远程触发器 | `src/tools/RemoteTriggerTool/RemoteTriggerTool.ts` |
 | `/v1/organizations/{id}/mcp_servers` | 组织 MCP 配置 | `src/services/mcp/claudeai.ts` |

-## 非 Anthropic 远程域名汇总
+### 非 Anthropic 远程域名汇总

 | 域名 | 服务 | 协议 |
 |---|---|---|
@@ -212,3 +216,9 @@ WebSearch 工具支持直接抓取 Bing 搜索结果页面，也支持通过 Bra
 | `platform.claude.com` | OAuth 授权页 | HTTPS |
 | `claude.com` / `claude.ai` | OAuth / 下载 | HTTPS |
 | `claude.fedstart.com` | FedStart OAuth | HTTPS |
+
+## 关联笔记
+
+- [[auto-updater]] — 自动更新机制（GCS 下载、npm registry）
+- [[telemetry-remote-config-audit]] — 遥测与远程配置（Datadog、GrowthBook、OTel 等）
+- [[lsp-integration]] — LSP 集成（本地语言服务器，无远程依赖）