一、Claude Code作用

• 理解上下文：自动读取你的项目文件，掌握整个代码库的结构，还蛮方便的
• 直接执行：能自己运行命令，修改文件，提交 Git
• 自然语言交互：用中文描述需求即可，无需写 prompt 模板
• 支持 MCP 扩展：可以接入各种外部工具和服务

---

二、费用说明

方式	说明	适合人群
Claude Pro / Max 订阅	固定月费，用量较大	长期、高频使用者
Anthropic Console API Key	按量计费，灵活但费用不可控	轻度测试、尝鲜

---

三、Windows 安装

系统要求

• Windows 10 或更高版本
• 4GB+ RAM
• 网络连接（用于认证和 AI 推理）

3.1 选择运行方式

Windows 下有两种方式，二选一：

方式一：原生 Windows

需要先安装 Git for Windows，安装时保持默认选项即可。

方式二：WSL

在 Windows 中运行 Linux 子系统，开发体验更好。以管理员身份打开 PowerShell 执行：

wsl --install -d Ubuntu

安装完成后重启电脑，打开 Ubuntu 终端即可使用。

---

3.2 安装 Claude Code

官方推荐使用原生安装脚本，无需安装 Node.js。

PowerShell：

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

CMD：

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

WSL / Git Bash：

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

安装完成后验证：

claude --version

如果 PowerShell 提示执行策略错误，先运行：

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

如果出现路径问题（claude 命令找不到），直接在 PowerShell 运行这条命令手动添加 PATH：

[Environment]::SetEnvironmentVariable("Path", $env:Path + ";C:\Users\你的用户名\.local\bin", "User")

然后关闭当前 PowerShell，重新打开一个新窗口再试。

---

3.3 Git Bash 路径配置（原生 Windows 专属）

如果启动时提示找不到 Git Bash，手动指定路径。

临时设置（当前会话有效）：

$env:CLAUDE_CODE_GIT_BASH_PATH="C:\Program Files\Git\bin\bash.exe"

永久写入配置文件 ~/.claude/settings.json：

{
  "env": {
    "CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"
  }
}

---

3.4 认证登录

进入你的项目目录，启动 Claude Code：

cd 你的项目路径
claude

首次运行会自动打开浏览器完成 OAuth 认证，根据你的账号类型选择对应方式登录即可

---

四、Linux 安装

系统要求

• Ubuntu 20.04+ 或 Debian 10+（其他主流发行版也支持）
• 4GB+ RAM
• 网络连接

Alpine Linux 用户需额外安装依赖：

apk add libgcc libstdc++ ripgrep

并设置环境变量 USE_BUILTIN_RIPGREP=0

---

4.1 安装 Claude Code

用官方原生安装脚本（无需 Node.js）

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

Homebrew 方式：

brew install --cask claude-code

安装指定版本：

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

验证安装：

claude --version

---

4.2 NPM 安装方式（备选）

如果你的环境必须使用 NPM，需先安装 Node.js 18+，推荐用 nvm 管理：

# 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
source ~/.bashrc

# 安装 Node.js 18
nvm install 18
nvm use 18

# 安装 Claude Code（注意：不要加 sudo）
npm install -g @anthropic-ai/claude-code

遇到权限错误不要用 sudo，改用以下方式配置 npm 全局目录：

mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

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

---

4.3 认证登录

cd ~/your-project
claude

如果使用 API Key 认证，可以写入环境变量持久化：

echo 'export ANTHROPIC_API_KEY=sk-你的key' >> ~/.bashrc
source ~/.bashrc

---

五、安装健康检查

安装完成后，不管是 Windows 还是 Linux，都建议运行：

claude doctor

这条命令会自动检测安装类型、版本号、认证状态，并给出修复建议，遇到问题时先跑这个准没错。

---

六、VSCode 集成

Claude Code 提供官方 VSCode 扩展，可以直接在 IDE 内使用，无需切换到终端。

6.1 安装扩展

直接在 VS Code 扩展市场搜索 Claude Code 安装，或直接访问：

https://marketplace.visualstudio.com/items?itemName=anthropic.claude-code

要求 VSCode 版本 1.98.0 以上

安装好后第一次启动的时候只要你浏览器已经用过Claude pro，会自动进入浏览器进行登录账号操作，你只需要点一个确认就可以了

6.2 主要功能

功能	说明
侧边栏面板	点击 Spark 图标打开 Claude Code 面板
Plan 模式	让 Claude 先描述计划，确认后再执行修改
自动接受模式	Claude 直接修改代码，无需逐步确认
@文件引用	在提问中 @mention 具体文件或代码行
扩展思考	右下角按钮开关，让 Claude 深度推理
对话历史	随时查看和恢复历史会话
多会话	同时开启多个 Claude Code 对话窗口

6.3 使用方式

1. 安装扩展后，点击侧边栏的 Spark 图标 打开面板
2. 像在终端一样向 Claude 提问或下达任务
3. Claude 分析代码后会给出修改建议
4. 拖宽侧边栏可以看到 inline diff，点击展开查看详情

6.4 权限模式切换

点击输入框底部的模式指示器可以切换三种模式：

• Normal 模式：每次操作都需要确认
• Plan 模式：先出计划，批准后再执行
• Auto-accept 模式：自动应用所有修改

6.5 终端与扩展联动

在 VS Code 内置终端中直接运行 claude，即可自动激活 IDE 集成（diff 查看、诊断共享等）。

如果用的是外部终端，在 Claude Code 中运行 /ide 命令手动连接 VS Code。

扩展与 CLI 共享同一份对话历史，在终端运行 claude --resume 可以继续扩展中的会话。

6.6 暂不支持的功能

目前 Beta 版以下功能尚未实现，需要回到终端操作：

• MCP 服务器和插件的图形化配置（可用 /mcp、/plugin 命令替代）
• Checkpoints（会话状态存档）
• # 快捷记忆、! 直接执行 bash
• Tab 补全文件路径

---

七、JetBrains IDE 集成

Claude Code 支持 IntelliJ IDEA、PyCharm、WebStorm、GoLand 等主流 JetBrains IDE。

7.1 支持的 IDE

• IntelliJ IDEA
• PyCharm
• WebStorm
• GoLand
• 其他 JetBrains 系列 IDE

7.2 安装插件

在 JetBrains Marketplace 中搜索 Claude Code 并安装，安装完成后完整重启 IDE。

或直接访问：https://plugins.jetbrains.com/plugin/claude-code

插件依赖已安装的 Claude Code CLI，请确保终端里的 claude 命令可以正常运行再安装插件。

7.3 主要功能

功能	说明
快速启动	Cmd+Esc（Mac）/ Ctrl+Esc（Windows/Linux）直接唤起 Claude Code
Diff 查看	代码修改直接在 IDE 的 diff 视图中展示
选区上下文	当前选中代码 / 打开的文件自动共享给 Claude
文件引用快捷键	Cmd+Option+K（Mac）/ Alt+Ctrl+K（Windows/Linux）插入文件引用
诊断共享	lint 错误、语法错误自动传递给 Claude，无需手动粘贴

7.4 启动方式

方式一：IDE 内置终端

在 IDE 的内置终端中运行 claude，所有集成功能自动激活。

方式二：外部终端连接

在任意外部终端启动 Claude Code 后，运行：

/ide

Claude Code 会自动检测并连接到当前打开的 JetBrains IDE。

7.5 WSL2 + JetBrains 特殊配置

WSL2 如果出现 "No available IDEs detected" 错误，是由于 WSL2 的 NAT 网络模式导致 IDE 检测失败（牢问题，只能说非常经典）

方案一：配置 Windows 防火墙

在 PowerShell（记得管理员）中运行，先查询 WSL2 子网：

wsl hostname -I

然后放行对应网段（根据实际 IP 修改）：

New-NetFirewallRule -DisplayName "Allow WSL2 Internal Traffic" -Direction Inbound -Protocol TCP -Action Allow -RemoteAddress 172.21.0.0/16 -LocalAddress 172.21.0.0/16

重启 IDE 和 Claude Code 后生效。

方案二：切换为镜像网络模式（不推荐，开发麻烦，详细看我提前的帖子）

在 Windows 用户目录下编辑 .wslconfig：

[wsl2]
networkingMode=mirrored

然后在 PowerShell 执行 wsl --shutdown 重启 WSL。

7.6 远程开发注意事项

使用 JetBrains Remote Development 时，插件必须安装在远程主机上，而不是本地客户端：

Settings → Plugins (Host) → 搜索安装 Claude Code

---

八、基本使用

进入项目目录后启动：

cd 你的项目
claude

常用内置命令

命令	说明
/status	查看当前模型和用量状态
/compact	压缩上下文，节省 Token
/permissions	管理文件访问权限
/bug	直接向 Anthropic 提交 Bug
/ide	连接到当前打开的 IDE
claude update	手动更新到最新版本
claude doctor	诊断安装和配置问题

指定模型

claude --model claude-sonnet-4-6
claude --model claude-opus-4-20250514

关闭自动更新

export DISABLE_AUTOUPDATER=1

---

九、参考链接

• 官方文档：https://code.claude.com/docs
• VS Code 扩展文档：https://code.claude.com/docs/en/vs-code
• JetBrains 插件文档：https://code.claude.com/docs/en/jetbrains
• GitHub 仓库：https://github.com/anthropics/claude-code
• Anthropic Console：https://console.anthropic.com
• 支持的国家和地区：https://www.anthropic.com/supported-countries