Documentation 2025-10-29 21:02 UTC to 2025-10-30 18:02 UTC

13 13 

14## Setup14## Setup

15 15 

16### 1. Enable model access16### 1. Submit use case details

17 17 

18First, ensure you have access to the required Claude models in your AWS account:18First-time users of Anthropic models are required to submit use case details before invoking a model. This is done once per account.

19 19 

201. Navigate to the [Amazon Bedrock console](https://console.aws.amazon.com/bedrock/)201. Ensure you have the right IAM permissions (see more on that below)

212. Go to **Model access** in the left navigation212. Navigate to the [Amazon Bedrock console](https://console.aws.amazon.com/bedrock/)

223. Request access to desired Claude models (e.g., Claude Sonnet 4.5)223. Select **Chat/Text playground**

234. Wait for approval (usually instant for most regions)234. Choose any Anthropic model and you will be prompted to fill out the use case form

24 24 

25### 2. Configure AWS credentials25### 2. Configure AWS credentials

26 26 

164 "Version": "2012-10-17",164 "Version": "2012-10-17",

165 "Statement": [165 "Statement": [

166 {166 {

167 "Sid": "AllowModelAndInferenceProfileAccess",

167 "Effect": "Allow",168 "Effect": "Allow",

168 "Action": [169 "Action": [

169 "bedrock:InvokeModel",170 "bedrock:InvokeModel",

172 ],173 ],

173 "Resource": [174 "Resource": [

174 "arn:aws:bedrock:*:*:inference-profile/*",175 "arn:aws:bedrock:*:*:inference-profile/*",

175 "arn:aws:bedrock:*:*:application-inference-profile/*"176 "arn:aws:bedrock:*:*:application-inference-profile/*",

177 "arn:aws:bedrock:*:*:foundation-model/*"

176 ]178 ]

179 },

180 {

181 "Sid": "AllowMarketplaceSubscription",

182 "Effect": "Allow",

183 "Action": [

184 "aws-marketplace:ViewSubscriptions",

185 "aws-marketplace:Subscribe"

186 ],

187 "Resource": "*",

188 "Condition": {

189 "StringEquals": {

190 "aws:CalledViaLast": "bedrock.amazonaws.com"

191 }

192 }

177 }193 }

178 ]194 ]

179}195}

6 6 

7Prerequisites:7Prerequisites:

8 8 

9* [Node.js 18 or newer](https://nodejs.org/en/download/)

10* A [Claude.ai](https://claude.ai) (recommended) or [Claude Console](https://console.anthropic.com/) account9* A [Claude.ai](https://claude.ai) (recommended) or [Claude Console](https://console.anthropic.com/) account

11 10 

12```bash theme={null}11**Install Claude Code:**

13# Install Claude Code12 

14npm install -g @anthropic-ai/claude-code13<Tabs>

14 <Tab title="macOS/Linux">

15 ```bash theme={null}

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

17 ```

18 </Tab>

19 

20 <Tab title="Homebrew">

21 ```bash theme={null}

22 brew install --cask claude-code

23 ```

24 </Tab>

25 

26 <Tab title="Windows">

27 ```powershell theme={null}

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

29 ```

30 </Tab>

15 31 

16# Navigate to your project32 <Tab title="NPM">

17cd your-awesome-project33 ```bash theme={null}

34 npm install -g @anthropic-ai/claude-code

35 ```

18 36 

19# Start coding with Claude37 Requires [Node.js 18+](https://nodejs.org/en/download/)

38 </Tab>

39</Tabs>

40 

41**Start using Claude Code:**

42 

43```bash theme={null}

44cd your-project

20claude45claude

21# You'll be prompted to log in on first use

22```46```

23 47 

24That's it! You're ready to start coding with Claude. [Continue with Quickstart (5 mins) →](/en/docs/claude-code/quickstart)48You'll be prompted to log in on first use. That's it! [Continue with Quickstart (5 mins) →](/en/docs/claude-code/quickstart)

25 49 

26(Got specific setup needs or hit issues? See [advanced setup](/en/docs/claude-code/setup) or [troubleshooting](/en/docs/claude-code/troubleshooting).)50<Tip>

51 See [advanced setup](/en/docs/claude-code/setup) for installation options or [troubleshooting](/en/docs/claude-code/troubleshooting) if you hit issues.

52</Tip>

27 53 

28<Note>54<Note>

29 **New VS Code Extension (Beta)**: Prefer a graphical interface? Our new [VS Code extension](/en/docs/claude-code/vs-code) provides an easy-to-use native IDE experience without requiring terminal familiarity. Simply install from the marketplace and start coding with Claude directly in your sidebar.55 **New VS Code Extension (Beta)**: Prefer a graphical interface? Our new [VS Code extension](/en/docs/claude-code/vs-code) provides an easy-to-use native IDE experience without requiring terminal familiarity. Simply install from the marketplace and start coding with Claude directly in your sidebar.

6 6 

7* **Operating Systems**: macOS 10.15+, Ubuntu 20.04+/Debian 10+, or Windows 10+ (with WSL 1, WSL 2, or Git for Windows)7* **Operating Systems**: macOS 10.15+, Ubuntu 20.04+/Debian 10+, or Windows 10+ (with WSL 1, WSL 2, or Git for Windows)

8* **Hardware**: 4GB+ RAM8* **Hardware**: 4GB+ RAM

9* **Software**: [Node.js 18+](https://nodejs.org/en/download)9* **Software**: [Node.js 18+](https://nodejs.org/en/download) (only required for NPM installation)

10* **Network**: Internet connection required for authentication and AI processing10* **Network**: Internet connection required for authentication and AI processing

11* **Shell**: Works best in Bash, Zsh or Fish11* **Shell**: Works best in Bash, Zsh or Fish

12* **Location**: [Anthropic supported countries](https://www.anthropic.com/supported-countries)12* **Location**: [Anthropic supported countries](https://www.anthropic.com/supported-countries)

17 17 

18## Standard installation18## Standard installation

19 19 

20To install Claude Code, run the following command:20To install Claude Code, use one of the following methods:

21 21 

22```sh theme={null}22<Tabs>

23npm install -g @anthropic-ai/claude-code23 <Tab title="Native Install (Recommended)">

24```24 **Homebrew (macOS, Linux):**

25 25 

26<Warning>26 ```sh theme={null}

27 Do NOT use `sudo npm install -g` as this can lead to permission issues and security risks.27 brew install --cask claude-code

28 If you encounter permission errors, see [configure Claude Code](/en/docs/claude-code/troubleshooting#linux-permission-issues) for recommended solutions.28 ```

29</Warning>29 

30 **macOS, Linux, WSL:**

31 

32 ```bash theme={null}

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

34 ```

35 

36 **Windows PowerShell:**

37 

38 ```powershell theme={null}

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

40 ```

41 

42 **Windows CMD:**

43 

44 ```batch theme={null}

45 curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

46 ```

47 </Tab>

48 

49 <Tab title="NPM">

50 If you have [Node.js 18 or newer installed](https://nodejs.org/en/download/):

51 

52 ```sh theme={null}

53 npm install -g @anthropic-ai/claude-code

54 ```

55 </Tab>

56</Tabs>

30 57 

31<Note>58<Note>

32 Some users may be automatically migrated to an improved installation method.59 Some users may be automatically migrated to an improved installation method.

33 Run `claude doctor` after installation to check your installation type.

34</Note>60</Note>

35 61 

36After the installation process completes, navigate to your project and start Claude Code:62After the installation process completes, navigate to your project and start Claude Code:

74 Run `claude doctor` after installation to check your installation type and version.100 Run `claude doctor` after installation to check your installation type and version.

75</Tip>101</Tip>

76 102 

77### Global npm installation103### Native installation options

78 104 

79Traditional method shown in the [install steps above](#standard-installation)105The native installation is the recommended method and offers several benefits:

80 106 

81### Native binary installation (Beta)107* One self-contained executable

108* No Node.js dependency

109* Improved auto-updater stability

82 110 

83If you have an existing installation of Claude Code, use `claude install` to start the native binary installation.111If you have an existing installation of Claude Code, use `claude install` to migrate to the native binary installation.

84 112 

85For a fresh install, run one of the following commands:113For advanced installation options with the native installer:

86 

87**Homebrew (macOS, Linux):**

88 

89```sh theme={null}

90brew install --cask claude-code

91```

92 

93<Note>

94 Claude Code installed via Homebrew will auto-update outside of the brew directory unless explicitly disabled with the `DISABLE_AUTOUPDATER` environment variable (see [Auto updates](#auto-updates) section).

95</Note>

96 114 

97**macOS, Linux, WSL:**115**macOS, Linux, WSL:**

98 116 

111 **Alpine Linux and other musl/uClibc-based distributions**: The native build requires you to install `libgcc`, `libstdc++`, and `ripgrep`. Install (Alpine: `apk add libgcc libstdc++ ripgrep`) and set `USE_BUILTIN_RIPGREP=0`.129 **Alpine Linux and other musl/uClibc-based distributions**: The native build requires you to install `libgcc`, `libstdc++`, and `ripgrep`. Install (Alpine: `apk add libgcc libstdc++ ripgrep`) and set `USE_BUILTIN_RIPGREP=0`.

112</Note>130</Note>

113 131 

132<Note>

133 Claude Code installed via Homebrew will auto-update outside of the brew directory unless explicitly disabled with the `DISABLE_AUTOUPDATER` environment variable (see [Auto updates](#auto-updates) section).

134</Note>

135 

114**Windows PowerShell:**136**Windows PowerShell:**

115 137 

116```powershell theme={null}138```powershell theme={null}

137curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd 1.0.58 && del install.cmd159curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd 1.0.58 && del install.cmd

138```160```

139 161 

140The native Claude Code installer is supported on macOS, Linux, and Windows.

141 

142<Tip>162<Tip>

143 Make sure that you remove any outdated aliases or symlinks.163 Make sure that you remove any outdated aliases or symlinks before installing.

144 Once your installation is complete, run `claude doctor` to verify the installation.

145</Tip>164</Tip>

146 165 

166### NPM installation

167 

168For environments where NPM is preferred or required:

169 

170```sh theme={null}

171npm install -g @anthropic-ai/claude-code

172```

173 

174<Warning>

175 Do NOT use `sudo npm install -g` as this can lead to permission issues and security risks.

176 If you encounter permission errors, see [configure Claude Code](/en/docs/claude-code/troubleshooting#linux-permission-issues) for recommended solutions.

177</Warning>

178 

147### Local installation179### Local installation

148 180 

149* After global install via npm, use `claude migrate-installer` to move to local181* After global install via npm, use `claude migrate-installer` to move to local