Xcode 26.3-Coding Agents

介绍

从 Xcode 26.3 开始，Apple 正式引入 Coding Agents（编码代理） 概念，目前 Xcode 内置支持的典型代表包括 Claude Agent 和 Codex。与早期“代码补全”“聊天式问答”不同，Coding Agent 是一种具备任务执行能力的 AI 助手，能够：

• 理解项目结构；
• 连续执行多步操作；
• 自动修改、生成、重构代码；
• 在一定范围内“替你写代码”。

Claude Agent运行机制

• 表面上看，Claude Agent 是 Xcode 的一个内置功能，但实际上它并不是“写死在 Xcode 里的 AI”。
• Xcode 启动 Claude Agent 时，会调用一个独立的 Claude Code CLI 作为子进程运行。这个 CLI 在启动时会读取一个固定位置的配置目录，并从中加载环境变量。配置路径为：~/Library/Developer/Xcode/CodingAssistant/ClaudeAgentConfig/settings.json。
• 只要覆盖几个关键环境变量就可以把原本发往 Anthropic 官方 API 的请求，重定向到任意 Anthropic-Compatible 服务。简而言之：Xcode 不关心用的到底是不是 Claude，只关心接口“像不像 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。此时，Xcode 中的 Claude Agent 实际请求已经由 OpenRouter 代发，但使用体验不会发生变化。

注意点

• Xcode 在真正启动 Claude 前仍然需要用户登录 Anthropic 账户。如果退出了 Anthropic 账户，Agent 无法启动，自定义配置也无法生效。
• 该方法适用于任何支持 Anthropic API 格式的服务，可以是第三方服务，也可以是本地服务。