Skip to content

安装和第一次使用 Claude Code

下面是Windows下的安装步骤，其他平台类似

安装Git

版本控制，为Claude Code提供Bash，最新的版本也可以不用，当 Bash 不存在时，Claude Code 使用 PowerShell 作为 shell 工具。

Git官网在这里，考虑到Git是个比较重要的版本管理工具（反悔工具），大家还是装一下比较好，不会用没有关系，Claude Code会用，也能教会你用。

https://git-scm.com/install/windows

但官网里提供的下载地址在github,大家懂的。国内可以在这里下载

https://mirrors.tuna.tsinghua.edu.cn/github-release/git-for-windows/git/LatestRelease/

现在应该基本都是64位系统了吧，就装这个就行：Git-2.54.0-64-bit.exe

安装Claude Code

https://code.claude.com/docs/zh-CN/overview

官方提供了非常详细的中文的使用说明和安装说明，本来不用咱操心写这个。但是你还是懂的，

这个Antropic有点不太喜欢我们，你要按它说的安装，大概率是这样的：

Claude Code 安装

你要在国外无所谓。好在现在直接就是一个单文件，我从安装脚本里提取了下载地址，国内的可以直接从这里下载，然后放到一个可以随时启动的目录里吧：这个是2.1.152版本，其他版本直接改版本号就行

https://storage.googleapis.com/claude-code-dist-86c565f3-f756-42ad-8dfa-d59b1c096819/claude-code-releases/2.1.152/win32-arm64/claude.exe

下载后放到个可以随时启动的目录，我是放到这里：

C:\Users\你的用户名\AppDataLocal\Microsoft\Windows\Apps\claude.exe

在VSCODE下安装Claude Code

vscode下安装就简单了，现在Claude Code直接就是单文件，其实直接在vscode下安装然后把文件复制出来也能在终端里用，直接在插件里搜这个就行了，也没啥好说的。

VS Code 扩展

配置模型

安装完还不行，Claude Code是要吃Token的，所以你得给它配个能消耗Token的KEY。注意Token要是消耗真金白银的，不要随意暴露你的KEY。

因为已知的原因，我们在国内不太方便用Anthropic自家的模型，我们可以使用国内的模型。

建议去买一个Coding Plan来使用，国内可以考虑GLM或千问 Coding Plan。

以下地址我们用deepseek仅限举例，根据你的选的供应商填正确的地址和KEY

快速的启动一次

PS下

$env:ANTHROPIC_BASE_URL = "<https://llm-gateway.example.com>"
$env:ANTHROPIC_AUTH_TOKEN = "sk-gateway-key"
$env:ANTHROPIC_MODEL="deepseek-v4-pro[1m]"

CMD下

set ANTHROPIC_BASE_URL="<https://llm-gateway.example.com>"
set ANTHROPIC_AUTH_TOKEN="sk-gateway-key"
set ANTHROPIC_MODEL="deepseek-v4-pro[1m]"

然后运行claude就可以了，运行成功看到下图：

长期使用

我们一般会通过配置文件的方式方便日常使用。大家知道国内要用原生Claude的模型还是有点复杂的，而且开始用也没必要必须用。

但配置里会有一些Claude的一些模型名称，我们先简单来看一下它们相关的模型名称。
fable 这个是Claude家最牛的模型名字
sonnet 这个是普通的
opus 这个是高级的
haiku 这个是性价比高的

我们要在以下位置入放一个配置文件：

%USERPROFILE%\.claude。这个路径展开就是c:\users\你的用户名\.claude

如果没有你没有找到.claude文件夹，就新建一个就行了。

放入的文件名是settings.json,最小文件内容如下。后面配置其他内容时还会用到这个文件。

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "your-api-key"
    "ANTHROPIC_AUTH_MODEL": "deepseek-v4-pro[1m]"
  }
}

再复杂一点儿的，我们把模型再配置的复杂一点

{
  "env": {
  "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
  "ANTHROPIC_AUTH_TOKEN": "<你的 DeepSeek API Key>",
  "ANTHROPIC_MODEL": "deepseek-v4-pro[1m]",
  "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-v4-pro[1m]",
  "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-v4-pro[1m]",
  "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v4-flash",
  "CLAUDE_CODE_SUBAGENT_MODEL": "deepseek-v4-flash",
  "CLAUDE_CODE_EFFORT_LEVEL": "max"
  }
}

常见问题

问：API KEY哪里来？

答：

  1. 大模型供应商，这里只说国内，GLM，字节，阿里云，小米都提供，而且注册也都有些免费额度。建议用GLM5.1模型或阿里的Qwen模型。但真正用起来不建议用通用API KEY调用哈，可能会有点贵。
  2. 或者简单点先直接配置Deepseek V4 Flash。在平台先充个5块钱儿的应该能用一会儿了。
  3. 重试使用，还是建议Coding Plan或Token Plan，上面说的这些平台应该也都提供。也都有些优惠，这个可以找找。

问：环境变量ANTHROPIC_AUTH_TOKEN和ANTHROPIC_API_KEY有什么区别。

答：每个变量在不同的 HTTP 标头中发送凭证：ANTHROPIC_AUTH_TOKEN 在 Authorization: Bearer 中，ANTHROPIC_API_KEY 在 x-api-key 中，apiKeyHelper 在两者中。错误变量中的凭证到达网关时处于它不读取的标头中，请求失败并返回 401。如果验证请求返回 401，请切换到另一个变量并重试。

更简单的体验方式

如果只想体验使用Coding Agent。也可使用OpenCode。里面有些自带免费模型可以使用，好处是开箱即用。但这又是别外一软件了。这里不详细介绍

https://github.com/anomalyco/opencode

也可以装小米的MIMO Code，也可以开箱即用，有MiMo的免费用量（当前时间2026/7/7）

https://mimo.xiaomi.com/coder