Documentation 2026-01-12 21:02 UTC to 2026-01-14 06:02 UTC

221 221 

222## Use Plan Mode for safe code analysis222## Use Plan Mode for safe code analysis

223 223 

224Plan Mode instructs Claude to create a plan by analyzing the codebase with read-only operations, perfect for exploring codebases, planning complex changes, or reviewing code safely.224Plan Mode instructs Claude to create a plan by analyzing the codebase with read-only operations, perfect for exploring codebases, planning complex changes, or reviewing code safely. In Plan Mode, Claude uses [`AskUserQuestion`](/en/settings#tools-available-to-claude) to gather requirements and clarify your goals before proposing a plan.

225 225 

226### When to use Plan Mode226### When to use Plan Mode

227 227 

283 283 

284See [settings documentation](/en/settings#available-settings) for more configuration options.284See [settings documentation](/en/settings#available-settings) for more configuration options.

285 285 

286## Let Claude interview you

287 

288For large features, start with a minimal spec and let Claude interview you to fill in the details:

289 

290```

291> Interview me about this feature before you start: user notification system

292```

293 

294```

295> Help me think through the requirements for authentication by asking questions

296```

297 

298```

299> Ask me clarifying questions to build out this spec: payment processing

300```

301 

302Claude uses the [`AskUserQuestion`](/en/settings#tools-available-to-claude) tool to ask you multiple-choice questions for gathering requirements, clarifying ambiguity, and understanding your preferences before writing any code. This collaborative approach produces better specs than trying to anticipate every requirement upfront.

303 

304This behavior is most active in Plan Mode. To encourage it in other modes, add guidance to your `CLAUDE.md` file:

305 

306```markdown theme={null}

307Always ask clarifying questions when there are multiple valid approaches to a task.

308```

309 

310<Note>

311 If you're building applications with the Agent SDK and want to surface clarifying questions to your users programmatically, see [Handle approvals and user input](https://platform.claude.com/docs/en/agent-sdk/user-input#handle-clarifying-questions).

312</Note>

313 

286***314***

287 315 

288## Work with tests316## Work with tests

158| `awsCredentialExport` | Custom script that outputs JSON with AWS credentials (see [advanced credential configuration](/en/amazon-bedrock#advanced-credential-configuration)) | `/bin/generate_aws_grant.sh` |158| `awsCredentialExport` | Custom script that outputs JSON with AWS credentials (see [advanced credential configuration](/en/amazon-bedrock#advanced-credential-configuration)) | `/bin/generate_aws_grant.sh` |

159| `alwaysThinkingEnabled` | Enable [extended thinking](/en/common-workflows#use-extended-thinking) by default for all sessions. Typically configured via the `/config` command rather than editing directly | `true` |159| `alwaysThinkingEnabled` | Enable [extended thinking](/en/common-workflows#use-extended-thinking) by default for all sessions. Typically configured via the `/config` command rather than editing directly | `true` |

160| `language` | Configure Claude's preferred response language (e.g., `"japanese"`, `"spanish"`, `"french"`). Claude will respond in this language by default | `"japanese"` |160| `language` | Configure Claude's preferred response language (e.g., `"japanese"`, `"spanish"`, `"french"`). Claude will respond in this language by default | `"japanese"` |

161| `autoUpdatesChannel` | Release channel to follow for updates. Use `"stable"` for a version that is typically about one week old and skips versions with major regressions, or `"latest"` (default) for the most recent release | `"stable"` |

161 162 

162### Permission settings163### Permission settings

163 164 

741 742 

742| Tool | Description | Permission Required |743| Tool | Description | Permission Required |

743| :------------------ | :------------------------------------------------------------------------------------------------ | :------------------ |744| :------------------ | :------------------------------------------------------------------------------------------------ | :------------------ |

744| **AskUserQuestion** | Asks the user multiple choice questions to gather information or clarify ambiguity | No |745| **AskUserQuestion** | Asks multiple-choice questions to gather requirements or clarify ambiguity | No |

745| **Bash** | Executes shell commands in your environment (see [Bash tool behavior](#bash-tool-behavior) below) | Yes |746| **Bash** | Executes shell commands in your environment (see [Bash tool behavior](#bash-tool-behavior) below) | Yes |

746| **BashOutput** | Retrieves output from a background bash shell | No |747| **BashOutput** | Retrieves output from a background bash shell | No |

747| **Edit** | Makes targeted edits to specific files | Yes |748| **Edit** | Makes targeted edits to specific files | Yes |

85 85 

86### Install a specific version86### Install a specific version

87 87 

88To install a specific version of Claude Code with the native installer:88The native installer accepts either a specific version number or a release channel (`latest` or `stable`). The channel you choose at install time becomes your default for auto-updates. See [Configure release channel](#configure-release-channel) for more information.

89 89 

90**macOS, Linux, WSL:**90To install the latest version (default):

91 91 

92```bash theme={null}92<Tabs>

93# Install stable version (default)93 <Tab title="macOS, Linux, WSL">

94curl -fsSL https://claude.ai/install.sh | bash94 ```bash theme={null}

95 curl -fsSL https://claude.ai/install.sh | bash

96 ```

97 </Tab>

95 98 

96# Install latest version99 <Tab title="Windows PowerShell">

97curl -fsSL https://claude.ai/install.sh | bash -s latest100 ```powershell theme={null}

101 irm https://claude.ai/install.ps1 | iex

102 ```

103 </Tab>

98 104 

99# Install specific version number105 <Tab title="Windows CMD">

100curl -fsSL https://claude.ai/install.sh | bash -s 1.0.58106 ```batch theme={null}

101```107 curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

108 ```

109 </Tab>

110</Tabs>

102 111 

103**Windows PowerShell:**112To install the stable version:

104 113 

105```powershell theme={null}114<Tabs>

106# Install stable version (default)115 <Tab title="macOS, Linux, WSL">

107irm https://claude.ai/install.ps1 | iex116 ```bash theme={null}

117 curl -fsSL https://claude.ai/install.sh | bash -s stable

118 ```

119 </Tab>

108 120 

109# Install latest version121 <Tab title="Windows PowerShell">

110& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) latest122 ```powershell theme={null}

123 & ([scriptblock]::Create((irm https://claude.ai/install.ps1))) stable

124 ```

125 </Tab>

111 126 

112# Install specific version number127 <Tab title="Windows CMD">

113& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) 1.0.58128 ```batch theme={null}

114```129 curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd stable && del install.cmd

130 ```

131 </Tab>

132</Tabs>

115 133 

116**Windows CMD:**134To install a specific version number:

117 135 

118```batch theme={null}136<Tabs>

119REM Install stable version (default)137 <Tab title="macOS, Linux, WSL">

120curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd138 ```bash theme={null}

139 curl -fsSL https://claude.ai/install.sh | bash -s 1.0.58

140 ```

141 </Tab>

121 142 

122REM Install latest version143 <Tab title="Windows PowerShell">

123curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd latest && del install.cmd144 ```powershell theme={null}

145 & ([scriptblock]::Create((irm https://claude.ai/install.ps1))) 1.0.58

146 ```

147 </Tab>

124 148 

125REM Install specific version number149 <Tab title="Windows CMD">

126curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd 1.0.58 && del install.cmd150 ```batch theme={null}

127```151 curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd 1.0.58 && del install.cmd

152 ```

153 </Tab>

154</Tabs>

128 155 

129### Binary integrity and code signing156### Binary integrity and code signing

130 157 

179 **Known issue:** Claude Code may notify you of updates before the new version is available in these package managers. If an upgrade fails, wait and try again later.206 **Known issue:** Claude Code may notify you of updates before the new version is available in these package managers. If an upgrade fails, wait and try again later.

180</Note>207</Note>

181 208 

182**Disable auto-updates:**209### Configure release channel

210 

211Configure which release channel Claude Code follows for both auto-updates and `claude update` with the `autoUpdatesChannel` setting:

212 

213* `"latest"` (default): Receive new features as soon as they're released

214* `"stable"`: Use a version that is typically about one week old, skipping releases with major regressions

215 

216Configure this via `/config` → **Auto-update channel**, or add it to your [settings.json file](/en/settings):

217 

218```json theme={null}

219{

220 "autoUpdatesChannel": "stable"

221}

222```

223 

224For enterprise deployments, you can enforce a consistent release channel across your organization using [managed settings](/en/iam#managed-settings).

225 

226### Disable auto-updates

183 227 

184Set the `DISABLE_AUTOUPDATER` environment variable in your shell or [settings.json file](/en/settings):228Set the `DISABLE_AUTOUPDATER` environment variable in your shell or [settings.json file](/en/settings):

185 229