Claude Code

Install and Start in the Project Directory

Install Claude Code via npm and run the command in the correct root directory of the project to be worked on.

Run `npm install -g @anthropic-ai/claude-code`, then `cd` into the project directory and type `claude` to start the session.

Always start Claude Code right in the project's root directory so it correctly reads the file structure and package.json.

Clearly Describe the Issue to Resolve

Type a specific description of the bug or feature that needs fixing, along with steps to reproduce the bug if applicable.

Enter an example: 'API /orders returns error 500 when the cart is empty, please find the cause and fix it.'

Attach the actual error log or stack trace if available to help Claude Code locate the issue more quickly.

Review Plan Before Applying

Look through the files Claude Code intends to modify and the reasons before agreeing to execute.

Read the summary of proposed changes, type in any necessary adjustment feedback, then confirm for Claude Code to modify the file.

If the scope of changes is too broad compared to the initial request, ask Claude Code to narrow it down before applying.

Request Test Run for Confirmation

Allow Claude Code to run the existing test suite or write new tests for the modified part.

Type 'Run tests for the orders module and report results' for Claude Code to execute the test command and read the output.

Request additional test cases for the fixed bug to prevent the issue from recurring in the future.

Review Diff and Commit Changes

Review the entire final diff before allowing Claude Code to create a git commit.

Type 'git diff' to view the changes, then request 'Create commit with a message clearly describing this bug fix.'

Always read through the diff even if it's short, especially for files related to payment or user data.