一、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 使用方式
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
