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
Logan Yang ab96aebcd8
docs: Windows setup guide for Claude and Codex Agent Mode (#2542) 
* docs: add Windows setup guide for Claude Code Agent Mode

Windows users hit a confusing dead end: the Claude Code installer does not
add the binary to PATH, so `claude` and `where.exe claude` report
not-found even on a healthy install, leading users to think it broke. Copilot
resolves the binary by file path, not PATH, so the install is fine.

Add docs/agent-mode-windows-setup.md walking through install, sign-in,
Auto-detect / manual path, and troubleshooting, with the PATH gotcha called
out up front. Link it from docs/index.md and docs/agent-mode-and-tools.md.

Docs-only slice of logancyang/obsidian-copilot-preview#108; the in-plugin
not-found copy linking to this page is a follow-up.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

* docs: don't link v4 Windows guide from the v3 agent doc

agent-mode-and-tools.md documents the v3 in-process autonomous agent (vault
tools, @vault, max-iterations), a different feature from v4 Agent Mode (the
Claude Code / Codex / OpenCode coding-agent backends). The Windows guide is
about v4, so the callout there was misplaced. Keep only the standalone
docs/index.md entry.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

* docs: trim Windows guide to the exact command sequence

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

* docs: add Codex Windows installer for Agent Mode

* docs: script Claude Windows Agent Mode setup

* docs: harden Codex CLI path resolution

* docs: verify Codex login before finishing setup

* docs: avoid redundant Codex login prompts

* fix: auto-detect Codex ACP on Windows

* fix: address Windows agent setup review

* fix: align Claude Windows configure modal

* fix: clarify Windows PowerShell install label

* fix: use gist Windows install helpers

---------

Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
2026-05-31 20:53:56 -07:00

1.4 KiB
Raw 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

Run this in PowerShell:

irm https://gist.githubusercontent.com/logancyang/380ef4dbf9f98900771da76eca3d21e6/raw/install-codex-agent-mode-windows.ps1 | iex

When Codex asks you to sign in, finish the login. The installer copies the codex-acp.exe path to your clipboard.

In Obsidian: Settings -> Copilot -> Agents -> Codex -> Configure. Paste the copied 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.

Use the copied codex-acp.exe path only. Do not use codex.exe, codex.cmd, or codex-acp.cmd.