← 返回开源雷达

yusuke-114/claude-xcode-agent

B · 精选

在 Xcode 中用 Claude Code 作为编码 Agent

⭐ 81 stars⑂ 0 forksShellMIT创建于 2026-11-09最近更新 2026-11-09

这个项目是什么

这个项目是一个小工具,让你能在苹果的 Xcode 27 里直接使用 Claude Code 作为内置的「编码 Agent」。Xcode 27 支持通过一种叫 ACP 的协议接入外部 AI Agent,但官方适配器有两个问题:一是 Xcode 从图形界面启动 Agent,读不到你在终端里设置的环境变量,所以 API Key 和自定义网关地址没有地方放;二是它会自动加载你全局的 ~/.claude/settings.json,导致你在终端里的私人配置被意外带进 Xcode。

项目用一个叫 claude-acp.sh 的脚本解决这两点:密钥、网关地址、模型、MCP 服务器统一写在一个 config.json 里,由脚本读取成环境变量;默认不读取全局配置,只有你主动开启 setting_sources 才会加载。脚本被调用两次、扮演两种角色(一次作为 Agent 启动器,一次伪装成 claude 命令本身),全程用 exec 替换进程,不留常驻包装进程,保证和 Xcode 的通信干净。

它面向的是在 macOS 上用 Xcode 开发、同时想用 Claude Code 辅助写代码的开发者,尤其是已经在用第三方 API 网关或自己的 Anthropic Key、不想被绑死在 Xcode 内置账号体系里的人。核心能力包括:自带 Key/网关接入、模型别名映射、把自定义 MCP 服务器和 Xcode 提供的服务器一起挂上、以及配置与全局设置隔离。

核心亮点

  • ▸让 Claude Code 直接变成 Xcode 27 里的编码 Agent,不用在编辑器和终端之间来回切换
  • ▸支持填入自己的 Anthropic API Key 或第三方网关(Bearer 或 x-api-key 两种鉴权),不强制使用 Xcode 内置登录
  • ▸默认不加载全局 ~/.claude/settings.json,避免私人配置被带进 Xcode,需要时可手动开启
  • ▸可以在 config.json 里自定义模型(含 opus/sonnet/haiku 别名映射)并追加自己的 MCP 服务器
  • ▸一条 setup.sh 自动装好 node、claude 和适配器,并直接打印出要填进 Xcode 的可执行文件路径

谁做的

作者 yusuke-114 是一位独立开发者,GitHub 简介写着「cola-driven developer -> token-driven developer」,粉丝约 20 人,项目以 MIT 协议开源,属于个人维护的小型工具。

怎么用

需要一台 Mac 并装有 Xcode 27。使用方式是本地部署:先 git clone 仓库,运行 ./setup.sh 自动安装依赖,然后把输出的 claude-acp.sh 路径填到 Xcode 的 Settings › Intelligence › Add an Agent 的 Executable 一栏。如果想用自己的 Key、网关、模型或 MCP 服务器,把 config.example.json 复制成 config.json 并 chmod 600,再按需填写字段;不建这个文件也可以,此时 Claude 会使用它自己的登录状态。运行日志在 .runtime/agent.log。

项目本身以 MIT 协议免费开源,但 Claude Code 的模型调用不是免费的——费用由你的 Anthropic API Key 或所用网关按量计费(或者走你已有的 Claude 订阅登录)。

数据速览

Stars
81
Forks
0
Open Issues
0
收录时间
2026-11-16
acpagent-client-protocolai-agentai-toolsanthropicclaudeclaude-codedeveloper-toolsmacosmcp