claudeers.
// MCP Servers

claude-xcode-agent

Use Claude Code as the coding agent in Xcode 27, powered by your own API key or gateway.

Install with your AI

Paste into Claude Code, Cursor, or any agent — it reads the repo and wires the tool into your project.

Install and set up claude-xcode-agent (git-clone project) into my current project.
Found on https://claudeers.com/claude-xcode-agent
Repo: https://github.com/yusuke-114/claude-xcode-agent
Homepage/docs: —
Detected install method: git-clone → git clone https://github.com/yusuke-114/claude-xcode-agent
Category: mcp-servers. Platforms: api.
Read the repo's README for exact setup and env vars, then install it and wire it into my project.

Claudeers Health Verdict:
unknown; community-verified: false. Confirm the source before running anything.
// or clone
git clone https://github.com/yusuke-114/claude-xcode-agent

// compatibility

Platformsapi
Operating systems—
AI compatibilityclaude
LicenseMIT
Pricingopen-source
LanguageShell

Get your FREE $2.50 API credits to access TickAtlas financial data ↗

claude-xcode-agent

Claude Code as an Xcode 27 agent, using your own API key or gateway.

Design

Xcode talks to agents over ACP, and an adapter (claude-agent-acp) bridges ACP to Claude Code. Used on its own, the adapter has two problems:

  • Xcode starts the agent from the GUI, so there's no shell env to hold a key or gateway URL.
  • The adapter hardcodes claude --setting-sources user,project,local, so your global ~/.claude/settings.json gets applied to Xcode too.

claude-acp.sh fixes both: the key and gateway come from config.json, and ~/.claude/settings.json is not read unless you opt in with setting_sources. It does this by running twice in two roles:

flowchart LR
    X[Xcode] -- "launch<br/>once" --> S1["claude-acp.sh<br/>① as agent"]
    S1 -- exec --> A["ACP adapter<br/>long-lived"]
    A -- "spawn claude<br/>once per session" --> S2["claude-acp.sh<br/>② as claude"]
    S2 -- exec --> C["claude<br/>one per session"]
    X -. "ACP messages" .-> A
    A -. "session messages" .-> C
  1. As agent: loads config.json into env, points CLAUDE_CODE_EXECUTABLE at itself, execs the adapter.
  2. As claude: swaps --setting-sources for project,local, adds your MCP servers, execs the real claude.

Both steps exec, so no wrapper process stays alive and stdout stays pure ACP.

① runs once per agent launch, ② once per session. Messages within a session go straight to the running claude.

Run

git clone https://github.com/yusuke-114/claude-xcode-agent.git && cd claude-xcode-agent
./setup.sh        # installs node, claude and the adapter, then prints the path for Xcode

# optional: your own key / gateway / model / MCP servers (see Configure)
cp config.example.json config.json && chmod 600 config.json

In Xcode › Settings › Intelligence › Add an Agent…, set Executable to the printed claude-acp.sh path.

Logs go to .runtime/agent.log.

Configure

config.json lives next to claude-acp.sh. Every field is optional. Without the file, claude uses its own login. The script reads it each time Xcode launches the agent; restart Xcode if a change doesn't show up.

Base URL and key

EndpointFields
Anthropic APIapi_key
Gateway, Bearer authbase_url + auth_token
Gateway, x-api-key authbase_url + api_key

base_url is the gateway root, without /v1/messages.

{
  "base_url": "https://your-gateway.example.com",
  "auth_token": "your-token"
}

Model

model is the default model (sets ANTHROPIC_MODEL). Use a full ID or an alias like opus.

If your gateway names models differently, map the aliases with env:

{
  "model": "opus",
  "env": {
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "your-gateway-opus-id",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "your-gateway-sonnet-id",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "your-gateway-haiku-id"
  }
}

MCP servers

mcp_servers uses the same format as Claude Code's mcpServers. They're added alongside the servers Xcode provides. Each key is a name you choose. The example below shows a local server (started as a process) and a remote one (reached over HTTP).

{
  "mcp_servers": {
    "my-local-server": { "command": "/absolute/path/to/server", "args": ["--stdio"], "env": { "TOKEN": "..." } },
    "my-remote-server": { "type": "http", "url": "https://mcp.example.com/mcp", "headers": { "Authorization": "Bearer ..." } }
  }
}

Use absolute paths, since Xcode doesn't start the agent with your shell's PATH. Each session logs the loaded server names to .runtime/agent.log.

Other fields

  • setting_sources: defaults to project,local. Set user,project,local to also load ~/.claude/settings.json.
  • env: environment variables passed to claude as-is, for anything the fields above don't cover (e.g. HTTPS_PROXY). Xcode doesn't start the agent with your shell's env, so set them here. base_url, auth_token, api_key and model already become ANTHROPIC_* variables, so don't repeat them here.

License

MIT

// faq

What is claude-xcode-agent?

Use Claude Code as the coding agent in Xcode 27, powered by your own API key or gateway.. It is open-source on GitHub.

Is claude-xcode-agent free to use?

claude-xcode-agent is open-source under the MIT license, so it is free to use.

What category does claude-xcode-agent belong to?

claude-xcode-agent is listed under mcp-servers in the Claudeers registry of Claude-compatible tools.

6 views
★ 23 stars
unclaimed
updated 11 days ago

// embed badge

claude-xcode-agent on Claudeers
[![Claudeers](https://claudeers.com/api/badge/claude-xcode-agent.svg)](https://claudeers.com/claude-xcode-agent)

// retro hit counter

claude-xcode-agent hit counter
[![Hits](https://claudeers.com/api/counter/claude-xcode-agent.svg)](https://claudeers.com/claude-xcode-agent)

// reviews

// guestbook

0/500

// related in MCP Servers

🔓

f.k.a. Awesome ChatGPT Prompts. Share, discover, and collect prompts from the community. Free and open source — self-host for your organization with complete…

// mcp-serversf/⟨HTML⟩★ 177,810◷ NOASSERTION[ claude ]
🔓

A cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io

// mcp-serversfarion1231/⟨Rust⟩★ 155,814◷ MIT[ claude ]
🔓

🪨 why use many token when few token do trick — Claude Code skill that cuts 65% of tokens by talking like caveman

// mcp-serversJuliusBrussee/⟨JavaScript⟩★ 117,780◷ MIT[ claude ]
🔓

An open-source AI agent that brings the power of Gemini directly into your terminal.

// mcp-serversgoogle-gemini/⟨TypeScript⟩★ 108,744◷ Apache-2.0[ claude ]
→ see how claude-xcode-agent connects across the ecosystem