Claude Code安装&使用

1. 前言

目前AI三巨头（Claude、ChatgGPT、Gemini）都推出相应的编程专用Agent或IDE，分别叫Claude Code、Codex、Antigravity（反重力），而本文的主角Claude Code是公认独断一档的强！

这类东西（Agent）和我们网页的豆包，deepseek，ChatGPT等等之类的有什么区别呢？
Screenshot_2026_0424_104342.png

  • 网页聊天 AI(或app) 是相对来说能进行你问我答和处理一些简单文件的随身顾问
  • Claude Code/Codex/OpenClaw 是 能动手干活的智能体（即Agent），这类Agent的能力包括但不仅限于以下：
    • 直接读和写你的代码、配置、任意文件。
    • 系统权限：运行 Shell/PowerShell、Git、编译、部署、打开软件。
    • 网络权限：自主浏览网页、调用 API、发请求、爬数据。

2. 前置准备

需要准备三样东西：Node.js，Git（MacOS不需要，自带），api

2.1 安装Node.js

Node.js官网：https://nodejs.org/zh-cn/download

这里选择长期支持版本LTS，下载msi安装即可
fc29dfd760d51fa8a64757729249eb1d.png

在终端输入以下命令，能成功输出版本号就可以了

1
2
node --version
npm --version

6e61cf04-6a5b-4899-a34b-2fb9a3cfdbb7.png

2.2 安装Git

官网：https://git-scm.com/install/windows
45912fcc9c549246bfee820e2b28b94d.png
安装包下好之后一路点击Next即可安装，终端输入以下命令，能输出版本号即可

1
git --version

屏幕截图 2026-04-24 112937.png

2.3 准备api

这里推荐质谱、MiniMax、Kimi的api，便宜够用

2.3.1 演示

大部分的api购买思路都是一样的：找到官网–>实名认证–>创建api
这里以MiniMax演示,官网：https://platform.minimaxi.com/user-center/basic-information

进来后先实名注册，充10块钱就够玩很久了（新用户送15块）
43623bff4cb13cc9f2b8a22c9fab3b9b.png

实名成功后请点击获取您的Key或者点击侧边的接口密钥，创建api key，名称随便起，先复制key到记事本备用
e8255705ea75e1e54465643c32eba434.png

2.3.2 其他的api

2.3.3 Q&A

Q：什么是api？
A：api即应用程序接口，可以理解为连接模型厂商和Claude Code之间的“水管”

Q：为什么需要花钱买api？我们平时用的豆包、deepseek网页和手机app都是免费给我们用的呀？
A：豆包、DeepSeek 网页 / APP 免费：是大厂给用户 包了月、限了速、封了权限”的成品聊天工具，只用来打字聊天，成本由平台补贴 + 广告，本质是一种面对to C和to B的商业营运模式，C端靠免费拉取用户量，用户量起来了才是硬道理；B端则是面向企业和部分有需求的用户。个人的拙见：未来豆包感觉可以一家独大，成为像微信、支付宝一样人人都离不开的国民级产品。

Q：api厂商的coding plan计划和直充余额有什么区别？
A：前者相当于是订阅制，可以按月/季/年来订阅，适合经常、高强度使用的人群；后者相当于是按token记量，“用多少扣多少”，适合偶尔使用的人群。

Q：为什么要有Claude Code接国产api这样的骚操作？直接原汁原味用Claude Code自带的模型不行吗？
A：这里涉及到价格、网络、性价比的原因：

  • 价格：贵！有20美金/月的Pro会员和110美金/月的Max会员。
    Claude套餐
  • 网络：对节点的网络质量要求很高。
  • 性价比：顶级的Claude Opus 4.7模型固然好，但国内的质谱也已经很顶尖了，minimax和kimi更是很多人的选择。

这个视频解答了为什么可以接国产api的骚操作,从1分20秒开始

3. 安装&使用

3.1 安装命令

3.1.1 macOS, Linux, WSL

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

3.1.2 Windows PowerShell

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

3.1.3 Windows CMD

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

3.2 使用

安装完成后打开cmd或power shell，执行

1
claude

28ca62d1-196e-4c70-8aa3-66c8faa570f1.png

  • 中框显示的MiniMax-M2.7即目当前使用的模型
  • 读者首次进入会一些选项让你选择，是让你登入Claude账号的，你可以先关掉终端，先按下面的3.3进行

3.3 接入模型

Claude Code默认接的是自家的模型，如何接上国产大模型？有两个方法如下。

3.3.1 修改配置文件

修改.claude里的setting.json文件，路径一般如下：

Windows

1
C:\Users\你的用户名\.claude\settings.json

MacOS/Linux

1
~/.claude/settings.json

f23b5f84b196dc49ab7517f3f1c2751e.png
打开setting.json文件后按照所买厂商的配置文档填入相应的值即可修改模型，各健名的意思如下

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
{
  "env": { // 环境变量配置块，用于设置 API 相关的环境参数
    "ANTHROPIC_BASE_URL": "", // API 请求的基础地址（用于中转/代理）
    "ANTHROPIC_AUTH_TOKEN": "", // API Key填这里
    "API_TIMEOUT_MS": "", // API 请求超时时间（单位：毫秒）
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "", // 是否禁用非必要网络流量（如遥测、更新）
    "ANTHROPIC_MODEL": "", // 默认使用的模型名称
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "", // Sonnet 系列模型的默认映射
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "", // Opus 系列模型的默认映射
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "" // Haiku 系列模型的默认映射
  },
  "effortLevel": "", // 任务执行的努力程度，影响 Claude 的思考深度和资源消耗，low < medium < high < xhigh < max
  "autoUpdatesChannel": "" // 自动更新的渠道，如 latest/beta/stable
}

// Haiku < Sonnet < Opus 原意分别是七行诗、十四行诗、大作。因为是接国产模型的缘故，三个都设成一个模型名称就行了

3.3.2 使用cc switch管理api(推荐)

作用：api就像是车的发动机，Claude Code就像是没有发动机的车子，而cc switch就像是“换发动机的师傅”，其界面如下。

d6349da3-40ff-447c-b154-ef296aedcf47.png

  • 下载链接（win）：cc switch

  • 因为仓库在GitHub，部分读者进不去，我放一份在图床，点这里下载

  • macOS/Linux/WSL可以命令安装

1
2
brew tap farion1231/ccswitch
brew install --cask cc-switch

3.3.3 cc switch的简单配置&使用

  • 首页右上角的➕号👉你买了那个厂商的api你就选哪一个👉粘贴api👉其他的不需要修改，直接点击添加👉回到首页点击启用，回到命令行，输入claude即可
    0a976af112b94868d524548c365cb673.png

  • 首页左上角点击⚙️，把中间两项打开这样你的vscode里的Claudecode插件就能跟着切换以及CLI（命令行）就不会显示让你登入了
    d029ae1fabdb35538edad6a4a4c098fa.png

我这里用cc switch把api切换为deepseek，然后重新查看setting.json文件，发现也同步修改了，上面3.3.1还是MiniMax。这就说明这个cc switch修改的是.claude下的setting.json文件，和3.3.1的效果是一样的，只不过更方便了
35cfde7f65ab5a5c603be059180ad0b7.png

3.3.4 在vscode中安装Claudecode插件

image.png

VS Code 的 Claude Code 插件不是独立工具，它的本质是一个"桥接器"——把 CLI 的终端进程连接到 VS Code 的 UI 功能上。插件无法脱离 CLI 单独运行，所以必须先安装 Claude Code CLI。

在vscode中安装插件比纯命令行有几个小优势：

  • 可以贴图

其实 TUI 界面的 ClaudeCode 也能粘贴图片，但是否能识图要看大模型的能力，目前 deepseek 的模型都是文本模型，暂不支持识图，你粘贴图片他也是个瞎子。6 月份的 v4.1 模型将开放多模态，届时将支持图片理解和音频理解。

  • 一边看代码一边提需求
  • 相比于命令行更易上手
  • 上下文感知更直觉
  • 更适合做个学习的小顾问，就静静地躺在右边

CLI端的优势：

  • 比插件稳定得多
  • 命令全，有部分命令在插件端受限
  • 纯键盘驱动，不依赖鼠标，对熟悉终端的人效率更高
  • 更适合玩 vibe coding ，用它来实现你天马行空的想象和 idea ！

3.3.5 几个简单使用样例

  1. 可以用鼠标选择指定行数提问
    f908c5ced2cb727e922d603e7970f8df.png

  2. 输入框输入 @ 即可添加指定文件，减少幻觉率，但cc是一种按需索取的策略，需要哪个文件会自己去读取
    dbc30509-c8b6-44a1-868d-9972cacb3306.png

  3. 选择模式和Effort等级
    27f81a8a07d8202af7450382218249cf.png

  • Ask before edits：修改前先问你，让你明白他下一步要执行什么操作
  • Edit automatically：直接改代码，但他认为的高危操作还是会征得你的同意
  • Plan mode：先出方案再动手，是一问一答的形式

给它提一个修改意见，一般很快就能完成了。比如我这里给他提一个修改md代码块引用样式的例子
3bdbfdc6-8f30-4974-ab05-0a1e5bd91ac0.png

可以看到mac风格就生效了，前后对比如下两图
66e4b541-5596-4770-815a-28508ad7283e.png
17ba90d4-5263-42de-bcbc-36bb061fe54e.png

常用的命令

1
2
3
4
5
6
7
8
/init #  初始化项目，在目录下生成.claude.md文件，md里有项目结构、配置文件、依赖清单、启动脚本
/ask # 提问
/btw  # by the way，也是提问，但不打断当前任务
/effort # 思考力度
/model # 切换模型
/clear # 清除上下文
/compact # 压缩对话历史，释放上下文 token
/rewind # 回到某个对话，代码改的不理想，就用这个命令回滚

更多命令可以参考官方文档和dy视频

参考&致谢

Claude官方文档：https://code.claude.com/docs/zh-CN/
cc switch：https://github.com/farion1231/cc-switch
dy@AI 杰瑞斯：https://www.iesdouyin.com/share/video/7623718787753200930/
dy@第四种黑猩猩：https://www.iesdouyin.com/share/video/7601484851720380913/
dy@K森动画：https://www.iesdouyin.com/share/video/7631506033382329610/
dy@飞天闪客https://www.iesdouyin.com/share/video/7602667045645225257/