Claude Code安装及模型配置

Claude Code安装及模型配置

Claude Code简介

Claude Code 是 Anthropic 官方推出的终端 AI 编程助手,可以直接在命令行中完成代码编写、调试、重构、文件操作等任务。它通过读取项目上下文理解你的代码库,支持多文件协同修改,是目前最强的 CLI AI 编程工具之一。
但 Claude Code 默认强制要求 Anthropic 账号登录,且只能使用 Claude 系列模型。本文将介绍如何:

  1. 安装 Claude Code
  2. 去除登录校验
  3. 接入 DeepSeek模型

环境要求

项目 要求
操作系统 Windows 10+、macOS 10.15+、Linux
Node.js >= 18
npm >= 9

官方的安装命令不知道是不是因为网络环境的问题,执行报错,下载脚本查看内容是html。

环境检查

检查node版本

node -v
npm -v

nodejs安装

如果没有安装nodejs,需要安装nodejs,版本参照前边的要求建议安装最新的LTS版本。

nodejs自行安装,可以参考 Windows中使用nvm管理node

安装Claude Code

执行下列命令安装Claude Code

npm install -g @anthropic-ai/claude-code

安装后验证,执行以下命令

claude --version

正确输出版本号即说明安装完成

去除校验

Claude Code必须登录Anthropic账号且购买订阅才能使用,但是订阅价格较贵,接入国产模型使用就不需要登录了,所以需要绕过校验。

当然,如果购买了Claude Code的套餐,就可以跳过了。

没有尝试Claude Code的官方订阅,不确定网络通不通,但是想必是不通的

image-1781751026039.png

终端执行claude,可以看到,此时Claude是不可用的。

打开用户主目录下的.claude.json文件,具体路径C:\Users\your_username.claude.json,添加如下配置

"hasCompletedOnboarding": true,

保存后重新打开终端,claude就可以正常进入了。

image-1781751159166.png

选中信任目录,回车就可以进入Claude Code了

image-1781751188900.png

但是注意,此时Claude Code还是不可用的,因为还没有配置模型。

接入Deepseek模型

上边说到Claude的订阅比较贵,但是Deepseek的价格就很便宜了,所以我们 接入Deepseek的模型使用。

获取API-KEY

登录deepseek开放平台,没有账号注册一个,然后进入API keys页面,点击创建按钮新建一个就行了,名称随意。第一次创建(也可能是充值,记不清楚了)可能需要实名认证。

image-1781748678552.png

配置模型

这个参照Deepseek的文档就行了,在powershell中执行以下命令。然后再打开claude就可以使用了。

注意替换api-key,前后没有 <>

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

持久化配置

上面配置的模型只在当前powershell窗口生效,想要一直生效,需要将模型配置写入claude的配置文件C:\Users\your_username.claude\settings.jaon

{
  "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": "high"
  }
}

思考模式默认是开启的,CLAUDE_CODE_EFFORT_LEVEL只能设置为high和max,官方说明:

出于兼容考虑 lowmedium 会映射为 high, xhigh 会映射为 max

保存配置后重新打开终端,输入claude就可以使用了。

image-1781753194526.png


参考文献:

Deepseek接口文档 - https://api-docs.deepseek.com/zh-cn/quick_start/agent_integrations/claude_code