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 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

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.