介紹

從 Xcode 26.3 開始，Apple 正式引入 Coding Agents（編碼代理） 概念，目前 Xcode 內(nèi)置支持的典型代表包括 Claude Agent 和 Codex。與早期“代碼補(bǔ)全”“聊天式問答”不同，Coding Agent 是一種具備任務(wù)執(zhí)行能力的 AI 助手，能夠：

• 理解項(xiàng)目結(jié)構(gòu)；
• 連續(xù)執(zhí)行多步操作；
• 自動(dòng)修改、生成、重構(gòu)代碼；
• 在一定范圍內(nèi)“替你寫代碼”。

Claude Agent運(yùn)行機(jī)制

• 表面上看，Claude Agent 是 Xcode 的一個(gè)內(nèi)置功能，但實(shí)際上它并不是“寫死在 Xcode 里的 AI”。
• Xcode 啟動(dòng) Claude Agent 時(shí)，會(huì)調(diào)用一個(gè)獨(dú)立的 Claude Code CLI 作為子進(jìn)程運(yùn)行。這個(gè) CLI 在啟動(dòng)時(shí)會(huì)讀取一個(gè)固定位置的配置目錄，并從中加載環(huán)境變量。配置路徑為：~/Library/Developer/Xcode/CodingAssistant/ClaudeAgentConfig/settings.json。
• 只要覆蓋幾個(gè)關(guān)鍵環(huán)境變量就可以把原本發(fā)往 Anthropic 官方 API 的請(qǐng)求，重定向到任意 Anthropic-Compatible 服務(wù)。簡(jiǎn)而言之：Xcode 不關(guān)心用的到底是不是 Claude，只關(guān)心接口“像不像 Claude”。

切換示例

• 將 Claude Agent 切換到 OpenRouter。

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://openrouter.ai/api/v1",
    "ANTHROPIC_API_KEY": "sk-or-xxxxxxxxxxxxxxxx",
    "ANTHROPIC_MODEL": "anthropic/claude-3.5-sonnet",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "anthropic/claude-3-opus",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "anthropic/claude-3.5-sonnet"
  }
}

• 配置完成后，保存 settings.json，完全退出并重啟 Xcode。此時(shí)，Xcode 中的 Claude Agent 實(shí)際請(qǐng)求已經(jīng)由 OpenRouter 代發(fā)，但使用體驗(yàn)不會(huì)發(fā)生變化。

注意點(diǎn)

• Xcode 在真正啟動(dòng) Claude 前仍然需要用戶登錄 Anthropic 賬戶。如果退出了 Anthropic 賬戶，Agent 無法啟動(dòng)，自定義配置也無法生效。
• 該方法適用于任何支持 Anthropic API 格式的服務(wù)，可以是第三方服務(wù)，也可以是本地服務(wù)。