Xcode 26.3 AI Agent 实测：国内 iOS 开发者怎么用上 Claude Agent？附完整配置

ofox
3 阅读1分钟

Xcode 26.3 AI Agent 实测：国内 iOS 开发者怎么用上 Claude Agent？附完整配置

说实话，看到 Apple 在 Xcode 26.3 里直接内置了 Claude Agent 和 Codex，我第一反应是"终于不用再开两个窗口来回切了"。

但打开 Xcode，点了 Intelligence 面板，输入 API Key，结果——连接超时。

国内开发者的老朋友了，Anthropic 的 API 在国内直连基本没戏。折腾了一晚上，总算把 Xcode 的 Claude Agent 跑通了，记录一下完整过程。

先说结论

步骤操作耗时
安装 Claude Agent 组件Xcode Settings → Intelligence2 分钟
配置自定义 API 端点改 settings.json3 分钟
配置 MCP Bridge终端一行命令1 分钟
跑通第一个 Agent 任务让它帮你重构一个页面立即可用

整个流程不到 10 分钟，但卡点全在 API 连接上。

Xcode 26.3 的 AI Agent 到底能干啥

先简单说下这次更新有多猛：

  • Claude Agent：Anthropic 官方的 Claude Agent SDK 集成，跟 Claude Code 同一套底层
  • OpenAI Codex：Codex Agent 也内置了
  • MCP 协议支持：通过 Model Context Protocol，理论上你可以接入任何兼容的 Agent

关键是——这不是普通的代码补全。Agent 模式下，Xcode 里的 AI 可以：

  1. 自己读整个项目结构，理解架构
  2. 创建新文件、修改现有代码
  3. 直接 Build 项目、跑测试
  4. 截图检查 UI 效果
  5. 查阅 Apple 最新开发文档

说白了，你描述一个需求，它能从头到尾帮你实现，包括建文件、写代码、编译、跑测试。实测下来，写一个简单的 SwiftUI 页面，它从理解需求到通过编译，全程不到 2 分钟。

国内用不了？问题出在哪

Xcode 默认连接的是 api.anthropic.com，国内直连要么超时要么被墙。你可能想到用代理，但 Xcode 的 Agent 组件走的是独立的 Node.js 进程，系统代理不一定生效。

好在 Apple 留了后门——支持自定义 API 端点。

完整配置步骤

第一步：安装 Claude Agent 组件

打开 Xcode → Settings → Intelligence → 找到 Anthropic 下面的 Claude Agent → 点安装。

装完后你会看到一个输入 API Key 的框，先别急着填。

第二步：设置 API Key Override

打开终端，执行：

defaults write com.apple.dt.Xcode IDEChatClaudeAgentAPIKeyOverride ' '

注意这里是一个空格字符，不是空字符串。这一步是告诉 Xcode "我要自己管 API Key，别用内置的认证流程"。

第三步：配置自定义 API 端点（关键）

创建配置目录和文件：

mkdir -p ~/Library/Developer/Xcode/CodingAssistant/ClaudeAgentConfig

然后创建 settings.json：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "你的API密钥",
    "ANTHROPIC_BASE_URL": "https://api.ofox.ai/anthropic"
  }
}

这里的 ANTHROPIC_BASE_URL 是重点——把请求指向一个国内能访问的 Anthropic 兼容端点就行。我用的是 ofox.ai 的聚合接口，国内阿里云节点直连，延迟基本在 200ms 以内。

当然你也可以用其他兼容 Anthropic 协议的服务，只要支持 /v1/messages 接口就行。

第四步：选择模型（可选）

默认用的是 Claude Sonnet，想换模型可以执行：

# 用 Sonnet（推荐，速度和质量平衡最好）
defaults write com.apple.dt.Xcode IDEChatClaudeAgentModelConfigurationAlias 'sonnet'

# 用 Opus（更强但更贵更慢）
defaults write com.apple.dt.Xcode IDEChatClaudeAgentModelConfigurationAlias 'opus'

第五步：配置 MCP Bridge

这一步让 Claude Agent 能使用 Xcode 的构建、测试等原生能力：

claude mcp add --transport stdio xcode -- xcrun mcpbridge

如果你还用 Codex：

codex mcp add xcode -- xcrun mcpbridge

第六步：重启 Xcode

全部改完后，完全退出 Xcode 再重新打开（不是关窗口，是 Cmd+Q）。

打开一个项目，在 Agent 面板里试试输入："帮我给这个页面加一个下拉刷新功能"。

如果看到 Claude 开始分析你的项目结构，恭喜，跑通了。

实测效果

我拿了一个现有的 SwiftUI 项目试了几个任务：

任务1：给列表页加搜索功能

  • Claude Agent 先读了整个项目的文件结构
  • 找到了 ContentView.swift 和数据模型
  • 自动创建了 SearchBar 组件
  • 修改了 ContentView 加入搜索逻辑
  • Build 通过，UI 效果截图确认 ✅
  • 耗时：约 90 秒

任务2：写单元测试

  • 给它指定了一个 ViewModel
  • 它自动分析了所有公开方法
  • 生成了 12 个测试用例
  • 跑测试，11 个通过，1 个失败后它自己修了
  • 耗时：约 2 分钟

任务3：重构网络层

  • 要求把 URLSession 调用封装成 async/await
  • 它理解了现有的回调模式
  • 逐个文件改过来，保持接口不变
  • Build 通过，跑完所有测试 ✅
  • 耗时：约 3 分钟

跟之前在 Cursor 里用 Claude 比，最大的区别是 Xcode Agent 能直接 Build 和跑测试。在 Cursor 里你还得自己切终端 xcodebuild，现在全自动了。

踩坑记录

坑1：settings.json 路径别搞错

必须是 ~/Library/Developer/Xcode/CodingAssistant/ClaudeAgentConfig/settings.json，不是 ~/.claude/settings.json。Xcode 有自己独立的配置目录。

坑2：API Key Override 的空格

IDEChatClaudeAgentAPIKeyOverride 的值必须是一个空格 ' '，不能是空字符串 ''，否则 Xcode 会走默认认证流程，然后连接失败。

坑3：MCP Bridge 要装对版本

xcrun mcpbridge 需要 Xcode 26.3 的 Command Line Tools。如果你之前装过老版本，先跑一下：

xcode-select --install

坑4：Codex 和 Claude Agent 是独立的

Xcode 里的 Codex 配置跟你电脑上独立安装的 Codex 完全隔离。技能文件、MCP 配置都要单独设。

费用参考

Claude Sonnet 在 ofox.ai 上的价格是跟官方一致的，输入 3/百万token，输出3/百万 token，输出 15/百万 token。我跑了一下午的 Agent 任务（大概 20 多个），总共花了不到 $2。

主要是 Agent 模式下它会读大量文件做上下文理解，输入 token 消耗比较大。建议日常开发用 Sonnet 就够了，Opus 留给复杂重构任务。

小结

Xcode 26.3 的 Agentic Coding 是 Apple 近几年最实在的更新之一。不是那种"看着炫但没啥用"的功能，是真的能提升日常开发效率的东西。

国内开发者唯一的门槛就是 API 连接问题，但改个 settings.json 就能搞定，不需要折腾系统代理或者虚拟机。

如果你也在做 iOS 开发，强烈建议升级试试。反正 Xcode 更新是免费的，API 费用也就几美元的事。

avatar
文章
阅读
粉丝