obsidian-plugin/logancyang_obsidian-copilot
1
0
Fork 0
mirror of https://github.com/logancyang/obsidian-copilot.git synced 2026-07-22 07:50:24 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
logancyang_obsidian-copilot/docs/agent-mode-windows-setup.md

2.7 KiB
Raw Permalink Blame History

Windows Setup for Agent Mode

Use this guide to connect Claude Code or Codex to Copilot Agent Mode on Windows.

Claude Code

Run this in PowerShell:

irm https://gist.githubusercontent.com/logancyang/7a87eb38d91015eac567521f8cc9c729/raw/install-claude-agent-mode-windows.ps1 | iex

When Claude asks you to sign in, finish the browser login. The installer copies the claude.exe path to your clipboard.

In Obsidian: Settings -> Copilot -> Agents -> Claude -> Configure -> Auto-detect. If it doesn't find Claude, paste the copied path into the binary path field, then save.

Open a Copilot chat, switch to Agent Mode, pick Claude, and send a message.

A "not in your PATH" warning is normal and does not matter: Copilot finds Claude by file path, not PATH.

Codex

Codex requires the current Node.js LTS release, which includes npm. Install Node.js first, then reopen PowerShell.

Run this in PowerShell:

irm https://raw.githubusercontent.com/logancyang/obsidian-copilot/v4-preview/docs/install-codex-agent-mode-windows.ps1 | iex

The installer removes the superseded adapter if it is present, installs @agentclientprotocol/codex-acp, checks its bundled Codex CLI, and copies the adapter's dist\index.js path to your clipboard.

You can rerun the installer to update or repair the adapter; it resolves and copies the active global npm package path each time.

In Obsidian: Settings -> Copilot -> Agents -> Codex -> Configure -> Auto-detect. If auto-detect does not find it, paste the copied dist\index.js path into the binary path field. Leave Environment variables empty, then save.

Open a Copilot chat, switch to Agent Mode, pick Codex, and send a message. Copilot will offer Codex sign-in when authentication is needed.

The adapter includes a compatible Codex CLI. You do not need to install @openai/codex globally, and a separate codex command on PATH is not used. On Windows, configure the copied dist\index.js file—not codex.exe, codex.cmd, or codex-acp.cmd.

Updating or replacing an older Codex adapter

The install command shown by Copilot is:

npm install -g @agentclientprotocol/codex-acp

If Copilot says the installed adapter is unsupported, it shows this exact replacement command (supported by PowerShell 7):

npm uninstall -g @zed-industries/codex-acp && npm install -g @agentclientprotocol/codex-acp

In Windows PowerShell 5, run the equivalent commands on separate lines:

npm uninstall -g @zed-industries/codex-acp
npm install -g @agentclientprotocol/codex-acp

Then return to Configure, clear an old saved path if necessary, and click Auto-detect again.