Merge pull request #758 from anthropics/docs/readme-clarifications

README clarifications from docs walkthrough testing
2026-03-20 11:33:08 +00:00 · 2026-03-19 21:34:55 -07:00 · 2026-03-19 16:58:17 -07:00 · 2026-03-19 16:31:36 -07:00
2 changed files with 4 additions and 10 deletions
--- a/external_plugins/discord/README.md
+++ b/external_plugins/discord/README.md
@@ -47,18 +47,15 @@ These are Claude Code commands — run `claude` to start a session first.
 Install the plugin:
 ```
 /plugin install discord@claude-plugins-official
 /reload-plugins
 ```
 Check that `/discord:configure` tab-completes. If not, restart your session.
 **5. Give the server the token.**
 ```
 /discord:configure MTIz...
 ```
-Writes `DISCORD_BOT_TOKEN=...` to `~/.claude/channels/discord/.env`. You can also write that file by hand, or set the variable in your shell environment — shell takes precedence.
+Writes `DISCORD_BOT_TOKEN=...` to `.claude/channels/discord/.env` in your project. You can also write that file by hand, or set the variable in your shell environment — shell takes precedence.
 **6. Relaunch with the channel flag.**
@@ -70,7 +67,7 @@ claude --channels plugin:discord@claude-plugins-official
 **7. Pair.**
-DM your bot on Discord — it replies with a pairing code. In your assistant session:
+With Claude Code running from the previous step, DM your bot on Discord — it replies with a pairing code. If the bot doesn't respond, make sure your session is running with `--channels`. In your Claude Code session:
 ```
 /discord:access pair <code>
--- a/external_plugins/telegram/README.md
+++ b/external_plugins/telegram/README.md
@@ -27,18 +27,15 @@ These are Claude Code commands — run `claude` to start a session first.
 Install the plugin:
 ```
 /plugin install telegram@claude-plugins-official
 /reload-plugins
 ```
 Check that `/telegram:configure` tab-completes. If not, restart your session.
 **3. Give the server the token.**
 ```
 /telegram:configure 123456789:AAHfiqksKZ8...
 ```
-Writes `TELEGRAM_BOT_TOKEN=...` to `~/.claude/channels/telegram/.env`. You can also write that file by hand, or set the variable in your shell environment — shell takes precedence.
+Writes `TELEGRAM_BOT_TOKEN=...` to `.claude/channels/telegram/.env` in your project. You can also write that file by hand, or set the variable in your shell environment — shell takes precedence.
 **4. Relaunch with the channel flag.**
@@ -50,7 +47,7 @@ claude --channels plugin:telegram@claude-plugins-official
 **5. Pair.**
-DM your bot on Telegram — it replies with a 6-character pairing code. In your assistant session:
+With Claude Code running from the previous step, DM your bot on Telegram — it replies with a 6-character pairing code. If the bot doesn't respond, make sure your session is running with `--channels`. In your Claude Code session:
 ```
 /telegram:access pair <code>
Author	SHA1	Message	Date
Kenneth Lien	b664e152af	Merge pull request #758 from anthropics/docs/readme-clarifications README clarifications from docs walkthrough testing	2026-03-19 21:34:55 -07:00
Sarah Deaton	b01fad3396	README clarifications from docs walkthrough testing - Drop /reload-plugins (redundant, you restart with --channels next) - Fix token save path: .claude/channels/ not ~/.claude/channels/ - Clarify bot only responds once channel is running (pairing step)	2026-03-19 16:58:17 -07:00
Kenneth Lien	8908a582f8	Merge pull request #757 from anthropics/kenneth/add-bun-prereq Add Bun prerequisite to discord/telegram READMEs	2026-03-19 16:31:36 -07:00