[ClaudeCode]-1-安装配置ClaudeCode
引言
这篇文章介绍ClaudeCode在Windows和Linux下的安装配置方法。
文章目录
0×1.Windows如何安装配置ClaudeCode
1.安装node.js
nodejs官方网站 https://nodejs.org/en/download ，直接下载安装软件安装即可，安装完成后，打开powershell测试：
#出版本号就算成功
node -v && npm -v
2.安装git
Git官方网站 https://git-scm.com/install 下载安装包安装即可
#测试安装成功（需要新开启一个cmd窗口）
git -v
3.安装Claude Code
ClaudeCode官方github https://github.com/anthropics/claude-code 根据页面提示安装
#（注意）每个时间段，官方提供的安装方法可能不同，如果下面的安装命令失效，请参考官方GITHUB
#管理员权限打开powershell执行
irm https://claude.ai/install.ps1 | iex
windows安装完成后，配置环境变量
根据安装提示：
⚠ Setup notes:
• Native installation exists but C:\Users\Administrator\.local\bin is not in your PATH. Add it by opening: System Properties → Environment Variables → Edit User PATH → New → Add the path above. Then restart your terminal.
打开系统属性，搜索环境变量（点击编辑系统环境变量），在打开的窗口中，点击环境变量，双击Path点击新建，填上提示中的完整路径（我这里的提示的路径是 C:\Users\Administrator\.local\bin 你可能和我不一样，看你自己提示里面的路径）
添加上之后，新开一个powershell窗口，就能使用测试命令获得帮助信息了
#测试
claude --help
⚠ 报错（不支持网络区域）解决方法
（全局魔法不用配置，Pac模式需要配置）配置代理：
使用命令行切换到项目目录（项目目录是自定义的，可以自己创建），在项目目录中，创建一个.claude文件夹 ，在文件夹中创建一个settings.json文件，在文件中输入下面的代理信息，前提是开了魔法，并且魔法的本地端口是1080
{
"env": {
"HTTP_PROXY": "http://127.0.0.1:1080",
"HTTPS_PROXY": "http://127.0.0.1:1080"
}
}
设置第三方API和bash路径（安装了cc-switch就不需要配置这个key了，在cc-switch中配置即可）
setx ANTHROPIC_API_KEY "f6d7310021174aa3ae2fa2336a2c2e0e.ue4RgTnVtCLiuk4e"
setx CLAUDE_CODE_GIT_BASH_PATH "C:\Program Files\Git\bin\bash.exe"
安装好后不要先打开，先安装cc-switch
4.安装cc-swtich（用于切换国产模型）
cc-swtich的官方github地址： https://github.com/farion1231/cc-switch/releases/
下载Windows版安装，打开，设置里面，打开“跳过ClaudeCode初次安装验证“，“应用到VSCODE插件”这两个选项
然后添加一个API key，我这里使用的是Zhipu GLM，所以按照提示填写API Key（需要先去Zhipu网站去自己创建API Key），新用户有体验token。
注意，在体验包里面查看自己能够调用的Token的版本号，填写到CC里面，版本号（类似于glm-4.6V）别填错了，否则无法调用。
到这就已经能够通过命令行开启claude了，直接在cmd里面输入claude就能调用
5.安装vscode和插件
VScode官方网站 https://code.visualstudio.com/
在VSCODE的插件里面搜索claude code就能安装上，安装上后右上角会出现Claude的小图表（程序启动按键旁边），点击就能调用
0×2.Linux如何安装配置ClaudeCode
1.Linux的安装会更加的简单，下面以Archlinux为例，首先安装node.js：
#请及时参考node.js的官方网站，获取最新的安装信息，因为下面命令中的版本号24，随着时间推移会改变
987@zyj2.hk987.xyz:~$ curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
987@zyj2.hk987.xyz:~$ \. "$HOME/.nvm/nvm.sh" && nvm install 24
2.安装git：
#这是Arch的安装命令，ubuntu系列请使用apt install git
987@zyj2.hk987.xyz:~$ sudo pacman -S git
测试：
#能看到版本号就算成功
987@zyj2.hk987.xyz:~$ node -v && npm -v
3.安装Claude Code：
#请参考ClaudeCode的官方github，获取最新的安装方法
987@zyj2.hk987.xyz:~$ curl -fsSL https://claude.ai/install.sh | bash
# 根据提示配置环境变量变量（会有一个感叹号提示，下面那句）
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc
测试：
#能看到版本号就算成功
987@zyj2.hk987.xyz:~$ claude --version
3.安装cc-switch：
#Archlinux可以使用yay命令，直接获取AUR软件仓库封装好的cc-switch安装方法
987@zyj2.hk987.xyz:~$ yay cc-switch-bin
测试：
#启动，配置方法同windows
987@zyj2.hk987.xyz:~$ cc-switch
4.安装VScode：
#Archlinux可以使用yay命令，直接获取AUR软件仓库封装好的VScode安装方法
987@zyj2.hk987.xyz:~$ yay visual-studio-code-bin
测试：
#启动，配置方法同windows
987@zyj2.hk987.xyz:~$ code
0×3.ClaudeCode基础管理命令
# 基础命令，在claude命令行下，输入/，下面是最常用的6个claude自带命令
/clear # 清空上下文=重新打开会话
/compact # 压缩会话=继承会话记忆+重开新会话，可以使用ctrl+o打开压缩后的上下文简介查看，压缩能够有效节约Token消耗
/cost # 查看花费（token使用情况）
/logout # 登出
/login # 登入（切换账号操作）
/model # 切换模型
# 模式切换
shift+tab
# 一键自动化模式 开启该模式后，Claude 会自动接收并应用它生成的代码编辑建议，核心是“省掉手动确认步骤”。（用于根据计划生成程序）
accept edits on
# 计划模式 开启该模式后，Claude不会直接生成代码，而是优先为你的编程需求制定清晰的实现计划 / 步骤，核心是 “先规划，再编码”。（用于写方案，做计划）
plan mode on
# Yolo模式（权限完全放开的模式，claude拥有系统完全控制权，启动claude加上参数）
claude --dangerously-skip-permissions
# 输入一个英文感叹号!，就能进入bash模式，能够支持bash命令
# 输入ctrl+g，进入vscode编辑器，在编辑器里面可以长篇大论输入文字，保存关闭编辑器后，所有文字就都会自动输入到claude文本框中
# 使用规范文件（默认配置文件），使用init命令能够自动生成CLAUDE.md，默认是英文，可以让claude转化成中文
/init
CLAUDE.md
# 文件参考格式如下
#环境要求
- windows系统
- 使用bash作为命令行
#bash代码
- xxx
- xxx
#代码风格规范
- xxxx
- xxxx
#工作流程
- xxx
- xxx
# 编辑CLAUDE.md，可以使用/memory命令，能够编辑当前项目或全局CLAUDE.md
/memory
# 让Claude执行某个文件中的任务，例如，下面的文件保存为task.md
#自动化任务列表
执行1+1，输出结果
执行8*8输出结果
介绍一下你自己
# 然后让Claude执行task.md中的任务，每一行是一个任务
#添加命令授权列表，添加授权的命令，不需要执行确认
/permissions
将当前任务放置后台执行：
# 按键盘 ctrl + g 将前台任务放置后台（比如一些网页服务以及运行中的任务），这样就能继续在前台执行其他的指令
# 查看后台任务列表，选中对应的任务，按k就能结束选中的任务，如果不想结束后台任务，可以按Esc返回前台
/tasks
回滚任务：
# 任务回滚，或者按两下Esc键，然后选择回滚到哪一次会话
/rewind
回到对话：
# 如果不小心关闭了claude对话，可以通过下面的命令恢复
/resume
#或者在启动claude的时候加上参数 -c
claude -c
安装使用mcp：
# 1.安装figma官方mcp演示，打开一个shell窗口，输入下面的指令
# --transport http 指定 Claude Code 和这个 MCP 服务器之间的通信方式是 HTTP 协议
# （Figma 官方远程 MCP 仅支持 HTTP）
# 补充：本地 MCP 常用 --transport sse（服务器推送事件），更实时
# --scope user 限定这个 MCP 服务器的生效范围是「当前用户」（而非全局 / 团队）
# figma 给这个 MCP 服务器起的「昵称」
# 后续调用 / 管理时可以直接用这个名字（比如 claude mcp list figma 只查这个服务器）
# 你也可以改成 figma-remote/my-figma 等，只要自己好记
# 最后是figma的MCP服务器地址，Claude Code 会通过这个地址连接到 Figma 云端
claude mcp add --transport http --scope user figma https://mcp.figma.com/mcp
# 2.使用这个mcp
/mcp
# 输入/mcp命令后，选中我们需要的figma，根据提示，进行授权就能使用了
# 然后将所有交给claude,可以直接说，我需要根据figma中设计的UI图片制作前端页面
# 这样claude就会自己去调用figma的MCP来处理这个请求
注释：Figma 是一款基于云端的在线协作式界面设计平台（网站 / 软件），主打UI/UX 设计、原型制作、实时团队协作，是目前全球最主流的设计工具之一。
使用hook在工具使用 前/后/失败时 执行我们自定义的命令：
# 根据提示，创建hooks
/hooks
Write|Edit
# jq 系统 / Claude Code 内置的轻量级 JSON 处理命令，专门用来提取 / 修改 JSON 数据
# -r raw output（原始输出），表示提取的内容不带引号（比如提取 "index.html" 会输出 index.html，而非带双引号的字符串）
# 指定要提取 JSON 数据中 tool_input 字段下的 file_path 字段值
# （比如 JSON 是 {"tool_input":{"file_path":"./index.html"}}，就会提取出 ./index.html）
# 通过 xrags 调度 Prettier 格式化工具（前端通用格式化引擎）
# --wirte 格式化后直接覆盖原文件
jq -r ".tool_input.file_path" | xrags prettier --write