Claude Code安装和使用教程

官网：https://claude.com/product/claude-code

简介

Claude Code是Anthropic公司推出的运行在命令行的AI编程助手，也可通过插件集成到VS Code等IDE。

安装

官方教程：https://code.claude.com/docs/en/setup

安装需要FQ。

官方已废弃了npm安装，推荐使用Native安装。

另外还支持WinGet安装安装。Native按与WinGet安装区别在于：

• WinGet安装不能自动更新，Native安装可以自动更新。
• WinGet安装可以通过WinGet卸载，Native安装要直接删除文件夹来卸载。

Native安装

Windows PowerShell:

安装：

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

卸载：

Remove-Item -Path "$env:USERPROFILE\.local\bin\claude.exe" -Force
Remove-Item -Path "$env:USERPROFILE\.local\share\claude" -Recurse -Force

WinGet安装

安装：

winget install Anthropic.ClaudeCode

更新：

winget upgrade Anthropic.ClaudeCode

卸载：

winget uninstall Anthropic.ClaudeCode

运行

在项目文件夹打开命令行窗口，输入claude命令打开claude，正常运行将如下：

解决地域限制

如果出现以下提示，是因为Claude Code禁止在中国使用。

在C:\Users\[用户名]目录下找到.claude.json文件，用笔记本打开，在最后一个}之前添加一行：

"hasCompletedOnboarding": true

再次运行就可以正常使用了。

使用cc-switch切换模型

Claude Code默认使用Anthropic公司的模型，使用cc-switch可以让Claude Code切换到其他模型，例如国内的免费模型。

cc-switch是一个用于管理和切换Claude Code、Codex、Gemini CLI等AI编程工具后端模型配置的跨平台图形化桌面应用。

官网：https://github.com/farion1231/cc-switch，进入releases页面下载CC-Switch-v3.10.3-Windows-Portable.zip或CC-Switch-v3.10.3-Windows.msi。

添加模型供应商

模型供应商是指提供LLM服务的网站。不只开发LLM的原厂（例如DeepSeek、MINIMAX、Qwen）会提供LLM服务，有些网站会基于开源的LLM提供服务，例如魔搭社区会提供各种开源LLM的服务，并提供每日2000次免费调用额度。

创建API Key

以魔搭社区为例，进入官网：https://modelscope.cn/，进入"访问控制"页面（会要求绑定阿里云账号），创建访问令牌：

配置cc-switch

选择预设供应商将自动填写一些预设信息，需要额外填写部分是API Key和模型名称。

在魔搭社区的模型库页面可以查询需要的模型：

获取模型名称：

填写模型名称：

Claude有多个版本的模型：

模型版本	速度	成本	智力水平	最佳应用场景
Haiku	极快 ⚡️	最低 💰	入门级	客服、翻译、大量简单数据清洗
Sonnet	快 🚀	中等 💰💰	高级 (主流)	编程、日常办公、视觉分析 (性价比之王)
Opus	较慢 🐢	最高 💰💰💰	顶级 🧠	创意写作、复杂策略、深度长文本分析
Opus Thinking	最慢 ⏳	极高 💎	超越极限	数学证明、算法竞赛、硬核逻辑推理

某些模型没有提供多个版本，那么可以都填同一个模型。

魔搭社区提供Qwen模型的最大参数的是：

• 编程模式：Qwen/Qwen3-Coder-480B-A35B-Instruct
• 推理模型：Qwen/Qwen3-235B-A22B-Thinking-2507

验证配置

进入claude，检查模型设置是否成功：

使用教程

初始化项目

在项目文件夹打开claude，输入命令/init，Claude Code会通读整个项目，把产生的知识保存到项目文件夹的CLAUDE.md文件里。后续执行任务时，Claude Code会先读CLAUDE.md文件里的内容，快速了解整个项目。也可以手动修改CLAUDE.md文件，把一些知识补充到文件中。

压缩对话记录

每次跟AI对话时，之前的对话都会作为上下文传递给AI，对话一长就会造成TOKEN的大量消耗。

当前面的对话告一段落时，可以使用/compact命令用来压缩之前所有的对话记录，有效减少TOKEN的消耗。

清除之前的对话记录

当需要AI开始一个新的任务时，最好清理之前的对话记录，保持一个干净的上下文，让AI处理任务时不受之前内容的影响。

输入/clear命令清除对话记录。

切换模式

Alt+m可以在以下三种模式切换：

• 普通模式：AI的所有代码修改都必须经过人工审阅。
• auto accept模式：AI的代码修改不需要经过人工审阅。
• plan mode模式：AI不会进行任何代码修改，只会提出自己的想法，以及对如何修改问题的计划。

使用图片交流

如果使用的模型支持读取图像，可以上传图片跟AI进行交流。将图片文件拖进对话窗口，再输入需求：

连接VS Code

安装Claude Code for VS Code插件：

输入/ide命令：

连接VS Code之后，AI修改的代码将在VS Code弹出页面进行审核。

调整思考强度

在对话时，在前面加上think、think hard、think harder或ultrathink来控制模型思考长度，这四个强度逐级递增。在处理比较困难的推理任务之前可以加上这些提示词，加大AI的思考长度。

临时命令行模式

可以输入一个!临时切换成命令行模式，!后面接命令，这样不用另开一个命令行窗口执行命令，并且执行的命令的结果和过程会假如跟AI对话的上下文。

可视化界面

Claude Code是一个命令行工具，GitHub上有个开源项目提供了Claude Code的可视化界面。该项目之前叫Claudia，后改名为opcode，项目路径是https://github.com/winfunc/opcode。这个项目只提供了macOS和Linux的安装包。https://github.com/who10086/claudia-global项目提供了windows安装包。

参考

• 最火AI编程Claude Code详细攻略，一期视频精通
• 7分钟搞定Claude Code安装和多模型配置