基于個(gè)人微信云SaaS平臺(tái)www.wechatbot.online使微信用戶(hù)可直接與 Claude 對(duì)話(huà)Claude 也可主動(dòng)向微信用戶(hù)發(fā)送文字、圖片和文件。版權(quán)歸Anthropic官方目錄架構(gòu)概覽環(huán)境要求快速開(kāi)始微信配置啟動(dòng)方式消息類(lèi)型支持Claude 主動(dòng)發(fā)送能力文件存儲(chǔ)天翼云 OSS模型配置目錄結(jié)構(gòu)工作原理架構(gòu)概覽微信用戶(hù) │ 發(fā)送消息文字/語(yǔ)音/圖片 ▼ 微信服務(wù)WebSocket HTTP API │ ▼ interactive-bridge.ts ← 后臺(tái)靜默運(yùn)行 │ 文字直接注入 │ 語(yǔ)音 → 騰訊云 ASR → 文字 │ 圖片 → 阿里云 Qwen3 → 描述文字 ▼ Claude Code REPL交互式終端 │ Claude 處理可調(diào)用所有工具 │ 新加入工具 WechatSendImage / WechatSendFile │ 如果star數(shù)超過(guò)1000我再把語(yǔ)音回復(fù)功能加上 ▼ 回復(fù)文本 → 微信用戶(hù)環(huán)境要求依賴(lài)版本Bun≥ 1.3.5Node.js≥ 24.0.0微信saas服務(wù)WebSocket HTTP API環(huán)境變量必填A(yù)NTHROPIC_AUTH_TOKENsk-ant-...# Claude API KeyANTHROPIC_BASE_URLhttps://...# API 代理地址如使用中轉(zhuǎn)快速開(kāi)始# 1. 安裝依賴(lài)buninstall# 2. 復(fù)制并填寫(xiě)微信配置cpwechat-config.json.example wechat-config.json# 編輯 wechat-config.json見(jiàn)下方說(shuō)明# 3. 啟動(dòng)自動(dòng)掛載微信橋bun run dev -- --dangerously-skip-permissions啟動(dòng)后終端進(jìn)入交互模式同時(shí)后臺(tái)自動(dòng)連接微信 Hook 服務(wù)微信消息會(huì)直接注入 CyberClaude微信配置編輯項(xiàng)目根目錄的wechat-config.json{robotId:wxid_xxxxxxxxxxxxxxxx,authorization:wx_xxxxxxxxxxxxxxxx,serverIp:your.websocket.server.ip,serverPort:5555,apiHost:your.api.server.host,allowFrom:[],name:Claude 助手,aliyunApiKey:sk-xxxxxxxxxxxxxxxx}字段必填說(shuō)明robotId?微信機(jī)器人的 wxid如wxid_abc123authorization?API 鑒權(quán) TokenserverIp?Websocket服務(wù)器 IPserverPortWebSocket 服務(wù)器 端口默認(rèn)5555apiHost?微信 HTTP API 服務(wù)器地址ip:port或域名allowFrom白名單 wxid 列表空數(shù)組表示接受所有人消息name機(jī)器人名稱(chēng)僅用于日志顯示aliyunApiKey阿里云 DashScope Key用于圖片識(shí)別留空則跳過(guò)圖片消息oss.accessKey天翼云 ZOS OSS AccessKey用于 WechatSendImage / WechatSendFile 上傳本地文件oss.secretKey天翼云 ZOS OSS SecretKeyoss.endpointOSS 端點(diǎn)如https://shanghai-9.zos.ctyun.cntencentAsr.secretId騰訊云 SecretId用于語(yǔ)音消息 ASR 識(shí)別tencentAsr.secretKey騰訊云 SecretKey啟動(dòng)方式交互式模式推薦bun run dev -- --dangerously-skip-permissions進(jìn)入 Claude Code 交互終端項(xiàng)目目錄存在wechat-config.json時(shí)自動(dòng)在后臺(tái)啟動(dòng)微信橋微信消息注入終端Claude 回復(fù)后同步發(fā)回微信僅 Claude Code不啟動(dòng)微信橋bun run dev不帶--dangerously-skip-permissions時(shí)不會(huì)自動(dòng)啟動(dòng)微信橋。消息類(lèi)型支持微信消息類(lèi)型MsgType處理方式文字1直接注入 Claude圖片3阿里云 Qwen3 圖像理解 → 描述文字注入 Claude語(yǔ)音34騰訊云 ASR 語(yǔ)音識(shí)別 → 文字注入 Claude其他文件、鏈接等其他忽略語(yǔ)音識(shí)別騰訊云 ASR格式SILK微信原生格式語(yǔ)言16k 中文普通話(huà)識(shí)別失敗時(shí)向用戶(hù)回復(fù)錯(cuò)誤提示圖片識(shí)別阿里云 Qwen3 Omni通過(guò)阿里云 DashScope 實(shí)時(shí) WebSocket API輸出詳細(xì)的圖片內(nèi)容描述作為 Claude 的輸入上下文未配置aliyunApiKey時(shí)回復(fù)提示信息Claude 主動(dòng)發(fā)送能力微信橋啟動(dòng)后Claude 可主動(dòng)調(diào)用以下工具向微信用戶(hù)發(fā)送內(nèi)容WechatSendImage — 發(fā)送圖片參數(shù) source 圖片來(lái)源支持 - 本地絕對(duì)路徑自動(dòng)上傳 OSS 后發(fā)送 - 公網(wǎng) HTTP/HTTPS URL直接發(fā)送示例場(chǎng)景用戶(hù)說(shuō)截圖發(fā)我一下→ Claude 截圖保存本地 → 調(diào)用此工具自動(dòng)上傳并發(fā)送。WechatSendFile — 發(fā)送文件參數(shù) source 文件來(lái)源支持本地路徑或公網(wǎng) URL fileName (可選) 微信端顯示的文件名省略時(shí)自動(dòng)從路徑提取支持任意格式PDF、Word、Excel、ZIP、代碼文件等。這兩個(gè)工具僅在微信橋連接后對(duì) Claude 可見(jiàn)不影響普通 Claude Code 會(huì)話(huà)。模型配置優(yōu)先級(jí)順序模型選擇遵循以下優(yōu)先級(jí)從高到低1. /model 命令會(huì)話(huà)中動(dòng)態(tài)切換 ← 最高優(yōu)先級(jí) 2. --model CLI 啟動(dòng)參數(shù) 3. ANTHROPIC_MODEL 環(huán)境變量 4. settings.json 中的 model 字段 5. 訂閱等級(jí)默認(rèn)值 ← 最低優(yōu)先級(jí)模型別名啟動(dòng)或切換模型時(shí)可使用簡(jiǎn)短別名無(wú)需記憶完整模型 ID別名對(duì)應(yīng)模型說(shuō)明opusclaude-opus-4-6最強(qiáng)模型sonnetclaude-sonnet-4-6均衡模型默認(rèn)haikuclaude-haiku-4-5-20251001最快/最省bestclaude-opus-4-6永遠(yuǎn)指向最強(qiáng)模型opus[1m]claude-opus-4-6 100 萬(wàn) token 上下文需付費(fèi)訂閱sonnet[1m]claude-sonnet-4-6 100 萬(wàn) token 上下文需付費(fèi)訂閱opusplan計(jì)劃模式 → Opus普通模式 → Sonnet自動(dòng)切換[1m]后綴可附加在任意別名后啟用 100 萬(wàn) token 擴(kuò)展上下文僅限付費(fèi)訂閱不支持第三方 API。環(huán)境變量模型選擇# 指定主模型別名或完整 IDANTHROPIC_MODELsonnetANTHROPIC_MODELclaude-opus-4-6# 覆蓋各級(jí)別默認(rèn)模型用于鎖定具體版本ANTHROPIC_DEFAULT_OPUS_MODELclaude-opus-4-6ANTHROPIC_DEFAULT_SONNET_MODELclaude-sonnet-4-6ANTHROPIC_DEFAULT_HAIKU_MODELclaude-haiku-4-5-20251001# 覆蓋內(nèi)部快速小模型token 估算等輕量任務(wù)使用ANTHROPIC_SMALL_FAST_MODELclaude-haiku-4-5-20251001API 連接# 自定義 API 端點(diǎn)中轉(zhuǎn)代理、私有部署ANTHROPIC_BASE_URLhttps://your-proxy.example.com# API KeyANTHROPIC_API_KEYsk-ant-...ANTHROPIC_AUTH_TOKENsk-ant-oat01-...# Bearer Token 格式部分代理使用# 自定義請(qǐng)求頭ANTHROPIC_CUSTOM_HEADERS{X-Custom: value}AWS Bedrock# 啟用 Bedrock 模式CLAUDE_CODE_USE_BEDROCKtrue# 區(qū)域配置AWS_DEFAULT_REGIONus-east-1ANTHROPIC_SMALL_FAST_MODEL_AWS_REGIONus-west-2# 單獨(dú)指定 Haiku 區(qū)域# 認(rèn)證AWS_BEARER_TOKEN_BEDROCKyour-token# Bearer Token 認(rèn)證替代 IAMCLAUDE_CODE_SKIP_BEDROCK_AUTHtrue# 跳過(guò)認(rèn)證僅測(cè)試/代理Google Cloud Vertex AI# 啟用 Vertex AI 模式CLAUDE_CODE_USE_VERTEXtrue# 項(xiàng)目與區(qū)域ANTHROPIC_VERTEX_PROJECT_IDyour-gcp-projectCLOUD_ML_REGIONus-central1# 按模型指定區(qū)域優(yōu)先級(jí)最高VERTEX_REGION_CLAUDE_HAIKU_4_5us-east1VERTEX_REGION_CLAUDE_3_5_SONNETeurope-west1# GCP 認(rèn)證GOOGLE_APPLICATION_CREDENTIALS/path/to/service-account.jsonCLAUDE_CODE_SKIP_VERTEX_AUTHtrue# 跳過(guò)認(rèn)證僅測(cè)試Azure AI Foundry# 啟用 Foundry 模式CLAUDE_CODE_USE_FOUNDRYtrue# 端點(diǎn)二選一ANTHROPIC_FOUNDRY_RESOURCEmy-resource# 自動(dòng)構(gòu)建 https://my-resource.services.ai.azure.comANTHROPIC_FOUNDRY_BASE_URLhttps://...# 直接指定完整 URL# 認(rèn)證ANTHROPIC_FOUNDRY_API_KEYyour-azure-key# 不設(shè)則使用 Azure AD DefaultAzureCredentialCLAUDE_CODE_SKIP_FOUNDRY_AUTHtrue# 跳過(guò)認(rèn)證僅測(cè)試功能開(kāi)關(guān)# 禁用舊版模型 ID 自動(dòng)重映射保留舊 ID 直接使用CLAUDE_CODE_DISABLE_LEGACY_MODEL_REMAPtrue# 禁用快速模式CLAUDE_CODE_DISABLE_FAST_MODEtrueCLI 參數(shù)# 啟動(dòng)時(shí)指定模型bun run dev ----modelopus bun run dev ----modelclaude-sonnet-4-6# 恢復(fù)默認(rèn)bun run dev ----modeldefault# 打印模式的備用模型主模型過(guò)載時(shí)自動(dòng)切換bun run dev--print你好--modelsonnet --fallback-model haiku# 思維模式bun run dev ----thinkingenabled# 開(kāi)啟深度推理bun run dev ----thinkingadaptive# 自動(dòng)判斷是否推理bun run dev ----thinkingdisabled# 關(guān)閉推理會(huì)話(huà)中切換模型/model 命令/model# 打開(kāi)交互式選擇器/model opus# 直接切換到 Opus/model sonnet[1m]# 切換到 Sonnet 百萬(wàn)上下文版/model default# 恢復(fù)默認(rèn)模型/model--info# 顯示當(dāng)前模型信息settings.json 模型字段位置~/.claude/settings.json{model:sonnet,availableModels:[opus,sonnet,haiku,claude-sonnet-4-6],modelOverrides:{claude-opus-4-6:us.anthropic.claude-opus-4-6-v1:0,claude-sonnet-4-6:anthropic.claude-sonnet-4-6:0}}字段說(shuō)明model默認(rèn)模型支持別名或完整 IDavailableModels企業(yè)白名單限制可用模型范圍未設(shè)置則不限制modelOverridesAnthropic ID → 云廠商 ID 映射主要用于 Bedrock ARN各 API 提供商的 Bedrock 模型 ID 參考Anthropic 模型AWS Bedrock IDclaude-opus-4-6us.anthropic.claude-opus-4-6-v1:0claude-sonnet-4-6us.anthropic.claude-sonnet-4-6-v1:0claude-haiku-4-5-20251001us.anthropic.claude-haiku-4-5-v1:0OpenAI 兼容模式Claude Code 內(nèi)置 OpenAI 格式適配層可對(duì)接任何兼容POST /v1/chat/completions接口的服務(wù)包括 OpenRouter、Azure OpenAI、本地 Ollama、各類(lèi)中轉(zhuǎn)代理等。工作原理啟用后Claude Code 會(huì)在發(fā)請(qǐng)求前自動(dòng)將 Anthropic 格式的請(qǐng)求/v1/messages轉(zhuǎn)換為 OpenAI 格式/v1/chat/completions將 OpenAI SSE 流的響應(yīng)轉(zhuǎn)換回 Anthropic 格式工具調(diào)用、多輪對(duì)話(huà)全程透明轉(zhuǎn)換Claude 無(wú)感知方式一環(huán)境變量推薦# 啟用 OpenAI 兼容模式CLAUDE_CODE_COMPATIBLE_API_PROVIDERopenai# 接口地址到 /v1 之前的部分ANTHROPIC_BASE_URLhttps://openrouter.ai/api# 該服務(wù)的 API KeyANTHROPIC_API_KEYsk-or-v1-...# 該服務(wù)上的模型名稱(chēng)ANTHROPIC_MODELgpt-4o方式二配置文件持久化寫(xiě)入~/.claude/config.json全局配置文件{customApiEndpoint:{provider:openai,baseURL:https://openrouter.ai/api,apiKey:sk-or-v1-xxxxxxxx,model:anthropic/claude-3-5-sonnet,savedModels:[anthropic/claude-3-5-sonnet,gpt-4o,deepseek/deepseek-r1]}}方式三會(huì)話(huà)中動(dòng)態(tài)切換在交互終端中使用斜杠命令/add-model gpt-4o# 添加并切換到指定模型/add-model deepseek/deepseek-r1# 支持任意 OpenAI 兼容模型名/remove-model gpt-4o# 從保存列表中移除常見(jiàn)服務(wù)配置示例OpenRouter支持?jǐn)?shù)百個(gè)模型ANTHROPIC_BASE_URLhttps://openrouter.ai/apiANTHROPIC_API_KEYsk-or-v1-...ANTHROPIC_MODELanthropic/claude-opus-4# 或 gpt-4o、deepseek/r1 等CLAUDE_CODE_COMPATIBLE_API_PROVIDERopenaiAzure OpenAIANTHROPIC_BASE_URLhttps://your-resource.openai.azure.com/openai/deployments/deploymentANTHROPIC_API_KEYazure-api-keyANTHROPIC_MODELgpt-4oCLAUDE_CODE_COMPATIBLE_API_PROVIDERopenaiOllama本地模型ANTHROPIC_BASE_URLhttp://localhost:11434ANTHROPIC_API_KEYollama# 任意非空值即可ANTHROPIC_MODELllama3.2# 已拉取的模型名CLAUDE_CODE_COMPATIBLE_API_PROVIDERopenaiCLAUDE中轉(zhuǎn)代理ANTHROPIC_BASE_URLhttps://4399code.com/claudecodeANTHROPIC_AUTH_TOKENsk-ant-oat01-...# 如果代理兼容 Anthropic 原生格式不需要設(shè)置 CLAUDE_CODE_COMPATIBLE_API_PROVIDER注意事項(xiàng)項(xiàng)目說(shuō)明請(qǐng)求路徑兼容模式發(fā)送到baseURL/v1/chat/completions原生模式發(fā)送到baseURL/v1/messages模型名稱(chēng)必須填寫(xiě)目標(biāo)服務(wù)識(shí)別的模型名不能用 Claude Code 的別名如opus工具調(diào)用自動(dòng)在 Anthropictool_use? OpenAItool_calls之間轉(zhuǎn)換思維模式OpenAI 兼容模式不支持?jǐn)U展思維--thinking此參數(shù)會(huì)被忽略1M 上下文[1m]后綴不適用于第三方模型優(yōu)先級(jí)配置文件中的provider字段優(yōu)先于CLAUDE_CODE_COMPATIBLE_API_PROVIDER環(huán)境變量快速模式Fast Mode支持 Opus 4.6 / Sonnet 4.6 / Haiku 4.5切換到不支持的模型時(shí)自動(dòng)關(guān)閉需要付費(fèi)訂閱免費(fèi)賬號(hào)不可用計(jì)劃模式自動(dòng)升級(jí)使用haiku時(shí)進(jìn)入計(jì)劃模式自動(dòng)升級(jí)到 Sonnet使用opusplan別名計(jì)劃模式用 Opus普通模式用 Sonnet舊版模型 ID 重映射claude-opus-4、claude-opus-4-0、claude-opus-4-1自動(dòng)重映射到當(dāng)前 Opus 版本僅限第一方 APIBedrock/Vertex/Foundry 原樣傳遞設(shè)置CLAUDE_CODE_DISABLE_LEGACY_MODEL_REMAPtrue可禁用此行為目錄結(jié)構(gòu)Claude-Code/ ├── src/ │ ├── wechat-mode/ │ │ ├── interactive-bridge.ts # 交互式微信橋核心 │ │ │ WebSocket 接收、ASR/圖片識(shí)別、 │ │ │ 天翼云 OSS 上傳、REPL 消息注入 │ │ └── index.ts # 獨(dú)立無(wú)頭模式備用 │ │ │ ├── tools/ │ │ ├── WechatSendImageTool/ # 發(fā)圖片工具 │ │ └── WechatSendFileTool/ # 發(fā)文件工具 │ │ │ ├── utils/ │ │ ├── wechatHook.ts # 橋接鉤子零依賴(lài)單例 │ │ └── messageQueueManager.ts # REPL 消息注入隊(duì)列 │ │ │ ├── entrypoints/ │ │ └── cli.tsx # 啟動(dòng)入口自動(dòng)掛載微信橋 │ │ │ ├── main.tsx # onTurnComplete 回調(diào)注冊(cè) │ └── screens/REPL.tsx # 交互式終端React Ink │ ├── wechat-config.json # 微信配置不提交到 git ├── wechat-config.json.example # 配置模板 └── package.json工作原理消息接收鏈路cli.tsx檢測(cè)到--dangerously-skip-permissionswechat-config.json存在調(diào)用startWechatInteractiveBridge()interactive-bridge.ts建立 WebSocket 連接到微信 Hook 服務(wù)收到消息后文字直接進(jìn)入步驟 4語(yǔ)音下載 SILK 文件 → 騰訊云 ASR → 文字圖片下載圖片 → 阿里云 Qwen3 → 描述文字發(fā)送方的wxid入隊(duì)pendingWechatSenders文字內(nèi)容通過(guò)enqueue()注入 REPLREPL 將文字作為用戶(hù)輸入提交給 Claude回復(fù)發(fā)送鏈路Claude 完成回復(fù)REPL.tsx觸發(fā)onTurnComplete(messages)main.tsx調(diào)用notifyWechatTurnComplete(messages)interactive-bridge.ts的回調(diào)從messages中提取最后一條助手文本從隊(duì)列取出對(duì)應(yīng)wxid調(diào)用微信 API 發(fā)送回復(fù)若 Claude 調(diào)用了WechatSendImage/WechatSendFile文件先上傳 OSS 再發(fā)送權(quán)限機(jī)制微信橋下 Claude 擁有完整工具權(quán)限bypassPermissions無(wú)需逐條確認(rèn)可直接執(zhí)行 Bash 命令、讀寫(xiě)文件、調(diào)用所有工具。