Update .github/ISSUE_TEMPLATE/bug_report.md

Co-authored-by: Boris Cherny <boris@anthropic.com>
Add GitHub issue template for bug reports
2026-05-17 15:23:16 +00:00 · 2025-03-06 20:01:25 -08:00 · 2025-03-06 19:57:03 -08:00 · 2025-03-02 22:19:40 -08:00 · 2025-02-28 12:43:49 -08:00 · 2025-02-28 05:15:32 -08:00
4 changed files with 56 additions and 10 deletions
--- a/.devcontainer/Dockerfile
+++ b/.devcontainer/Dockerfile
@@ -42,9 +42,10 @@ RUN mkdir -p /workspace /home/node/.claude && \

 WORKDIR /workspace

-RUN wget https://github.com/dandavison/delta/releases/download/0.18.2/git-delta_0.18.2_arm64.deb && \
-  sudo dpkg -i git-delta_0.18.2_arm64.deb && \
-  rm git-delta_0.18.2_arm64.deb
+RUN ARCH=$(dpkg --print-architecture) && \
+  wget "https://github.com/dandavison/delta/releases/download/0.18.2/git-delta_0.18.2_${ARCH}.deb" && \
+  sudo dpkg -i "git-delta_0.18.2_${ARCH}.deb" && \
+  rm "git-delta_0.18.2_${ARCH}.deb"

 # Set up non-root user
 USER node
--- a/.gitattributes
+++ b/.gitattributes
@@ -0,0 +1,2 @@
+* text=auto eol=lf
+*.sh text eol=lf
--- a/.github/ISSUE_TEMPLATE/bug_report.md
+++ b/.github/ISSUE_TEMPLATE/bug_report.md
@@ -0,0 +1,34 @@
+---
+name: Bug report
+about: Create a report to help us improve
+title: '[BUG] '
+labels: bug
+assignees: ''
+---
+
+## Environment
+- Platform (select one):
+  - [ ] Anthropic API
+  - [ ] AWS Bedrock
+  - [ ] Google Vertex AI
+  - [ ] Other: <!-- specify -->
+- Claude CLI version: <!-- output of `claude --version` -->
+- Operating System: <!-- e.g. macOS 14.3, Windows 11, Ubuntu 22.04 -->
+- Terminal:  <!-- e.g. iTerm2, Terminal App -->
+
+## Bug Description
+<!-- A clear and concise description of the bug -->
+
+## Steps to Reproduce
+1. <!-- First step -->
+2. <!-- Second step -->
+3. <!-- And so on... -->
+
+## Expected Behavior
+<!-- What you expected to happen -->
+
+## Actual Behavior
+<!-- What actually happened -->
+
+## Additional Context
+<!-- Add any other context about the problem here, such as screenshots, logs, etc. -->
--- a/README.md
+++ b/README.md
@@ -1,6 +1,6 @@
 # Claude Code (Research Preview)

-![](https://img.shields.io/badge/Node.js-18%2B-brightgreen?style=flat-square) [![npm]](https://www.npmjs.com/package/json-schema-to-typescript)
+![](https://img.shields.io/badge/Node.js-18%2B-brightgreen?style=flat-square) [![npm]](https://www.npmjs.com/package/@anthropic-ai/claude-code)

 [npm]: https://img.shields.io/npm/v/@anthropic-ai/claude-code.svg?style=flat-square

@@ -17,12 +17,21 @@ Some of its key capabilities include:

 ## Get started

-1. Run the following command in your terminal: <br />
-  ```sh
-  npm install -g @anthropic-ai/claude-code
-  ```
-2. Navigate to your project directory and run <code>claude</code>
-3. Complete the one-time OAuth process with your Anthropic Console account.
+1. If you are new to Node.js and Node Package Manager (`npm`), then it is recommended that you configure an NPM prefix for your user.
+   Instructions on how to do this can be found [here](https://docs.anthropic.com/en/docs/agents-and-tools/claude-code/overview#recommended-create-a-new-user-writable-npm-prefix).
+
+   *Important* We recommend installing this package as a non-privileged user, not as an administrative user like `root`.
+   Installing as a non-privileged user helps maintain your system's security and stability.
+
+2. Install Claude Code:
+   
+   ```sh
+   npm install -g @anthropic-ai/claude-code
+   ```
+
+3. Navigate to your project directory and run <code>claude</code>.
+
+4. Complete the one-time OAuth process with your Anthropic Console account.

 ### Research Preview
Author	SHA1	Message	Date
Ben Mann	ae7efe8a7f	Update .github/ISSUE_TEMPLATE/bug_report.md Co-authored-by: Boris Cherny <boris@anthropic.com>	2025-03-06 20:01:25 -08:00
8enmann	ec1b0f626f	Add GitHub issue template for bug reports This adds a structured template for bug reports including fields for: - Platform selection (Anthropic API, AWS Bedrock, Google Vertex AI) - Claude CLI version information - OS details - Steps to reproduce 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>	2025-03-06 19:57:03 -08:00
Ben Mann	2be177bfd5	Merge pull request #171 from Eingin/main fix: update the npm badge link in the Readme to the correct package	2025-03-02 22:19:40 -08:00
Sid Bidasaria	e91c77304d	Merge pull request #205 from emcd/main fix: README: Encourage users to install package as a non-administrative user for the sake of system security and stability.	2025-02-28 12:43:49 -08:00
Eric McDonald	1c6ab88c83	README: Address review comments.	2025-02-28 05:15:32 -08:00
Eric McDonald	8b22a3d693	fix: README: Encourage users to install package as a non-administrative user for the sake of system security and stability.	2025-02-27 10:53:03 -08:00
Antonio Iaccarino	5455e5d5cd	fix: update the npm badge link to the correct package name	2025-02-27 17:45:01 +11:00
Ben Mann	1a4e0f4d73	Merge pull request #91 from EmilLindfors/win11 Fix Docker build issues on Windows and non-ARM architectures	2025-02-26 16:19:37 -08:00
Boris Cherny	e41a75d3c2	Merge pull request #157 from anthropics/bcherny-patch-2 Add NPM version badge	2025-02-26 14:26:08 -08:00
Emil Lindfors	9b78675c47	Fix Docker build issues on Windows and non-ARM architectures	2025-02-25 20:39:51 +01:00