Skip to content

Claude Code 从 0 配置 ​

前言 ​

  • 下面以 Windows 为例,使用自定义模型的 API Key;如果你使用的是 Claude Code 官方模型,则不要参考下面的配置
  • 本文会带你从零开始,完成 Node.js 与 Claude Code 的安装、模型 API 的接入,以及权限的配置

安装 Claude Code ​

安装 NodeJs ​

  • 也有其他方式安装的,但是推荐这种方式,因为后面安装其他扩展时,比较嵌合

  • NodeJs 官网下载 msi 文件

  • 下载完成后,双击安装

  • 安装完成后,使用 windows + r 打开运行框,输入 cmd 打开命令行

  • 输入 node -v 查看版本,输入 npm -v 查看 npm 版本

  • 先全局安装 nrm 用于切换国内镜像源,npm i -g nrm

  • nrm ls 查看所有镜像源

  • nrm use taobao 切换到淘宝镜像源

安装 Claude Code ​

sh
npm i -g @anthropic-ai/claude-code

# 查看版本, 如果显示版本号, 则安装成功
claude -v

打开 Claude Code 配置文件 ​

  • 一般配置可以使用 claude /config 配置,这里直接修改配置文件
  • 一般地址为: C:\Users\Administrator\.claude\settings.json
  • 配置自己的大模型 API Key
json
{
  "env": {
    "ANTHROPIC_BASE_URL": "你的平台 api 地址",
    "ANTHROPIC_AUTH_TOKEN": "你的 api key",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "CLAUDE_CODE_ATTRIBUTION_HEADER": "0",
    "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "你的平台的模型",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "你的平台的模型",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "你的平台的模型"
  },
  "permissions": {
    "defaultMode": "acceptEdits"
  },
  "enabledPlugins": {
    "context7@claude-plugins-official": true,
    "frontend-design@claude-plugins-official": true,
    "superpowers@claude-plugins-official": true,
    "code-simplifier@claude-plugins-official": true,
    "claude-mem@thedotmack": true
  },
  "language": "Chinese",
  "theme": "dark-daltonized",
  "skipDangerousModePermissionPrompt": true
}

配置解释 ​

  • ANTHROPIC_BASE_URL: API 请求的基础地址
  • ANTHROPIC_AUTH_TOKEN: API 认证 Token(部分平台也支持使用 ANTHROPIC_API_KEY 以 x-api-key 方式认证)
  • CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC: 关闭所有非核心上报、后台网络流量
  • CLAUDE_CODE_ATTRIBUTION_HEADER: 移除 API 请求里 x-anthropic-billing-header 计费归属请求头
  • CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS: 清除所有 Anthropic 私有实验 Beta 标识
  • acceptEdits: Claude 生成文件修改代码时,自动应用编辑,不弹窗确认
  • language: 对话语言
  • theme: 主题
  • skipDangerousModePermissionPrompt: 跳过危险模式权限提示(claude --skip-dangerous-mode-permission-prompt)

模型档位映射 ​

  • Claude Code 内部会把模型分成三个档位来调用,使用第三方 API 时,需要把这三个档位分别映射到你平台对应的模型:
    • ANTHROPIC_DEFAULT_OPUS_MODEL: 最强档位,用于复杂推理、代码生成等重任务
    • ANTHROPIC_DEFAULT_SONNET_MODEL: 均衡档位,默认的主力模型
    • ANTHROPIC_DEFAULT_HAIKU_MODEL: 最快档位,用于简单、快速、低成本的任务
  • 如果你的平台只有单一模型,可以把这三个变量都填成同一个模型名

enabledPlugins 插件 ​

  • 这里可以配置你想要使用的插件,上面配置的插件,如果你不需要的话,可以删除
  • context7@claude-plugins-official: 实时拉取第三方库最新官方文档,根治 API 幻觉
  • frontend-design@claude-plugins-official: 生成高质量、工业级 UI 页面,消除廉价 AI 套皮样式
  • superpowers@claude-plugins-official: 给 Claude 完整标准化工程开发工作流,像资深工程师一样规范编码
  • code-simplifier@claude-plugins-official: 无损重构简化代码,清理 AI 生成冗余代码
  • claude-mem@thedotmack: 跨会话持久长期记忆,解决关闭对话就失忆的问题

插件安装方式 ​

sh
claude /plugins

第三方平台配置示例 ​

  • 下面以 DeepSeek 官方 API 为例,其他平台类似,只需要替换 ANTHROPIC_BASE_URL、ANTHROPIC_AUTH_TOKEN 和三个模型名即可
json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "sk-xxxxxxxxxxxxxxxx",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-chat",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-chat",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-reasoner"
  }
}
  • deepseek-chat: 通用对话模型(对应 V3 系列)
  • deepseek-reasoner: 深度推理模型(对应 R1 系列)

配置 Claude Code 权限 ​

  • 配置文件地址: C:\Users\Administrator\.claude\settings.local.json
json
{
  "permissions": {
    "allow": ["Read", "Write", "Edit", "Delete", "Bash(*)"],
    "deny": ["Bash(git *)"]
  }
}
  • 文件全权限:可读、写、改、删项目任意文件
  • Shell 全局放行:绝大多数终端命令都能自动运行
  • 锁死 git(为了防止 AI 清理 git 记录,回退版本):AI 不能自动提交、推送、切换分支等版本库操作,所有 git 操作必须你手动输入
  • 通配符 * 表示匹配任意内容,Bash(*) 表示放行所有 shell 命令,Bash(git *) 表示禁止所有 git 命令
  • 当 allow 与 deny 同时匹配时,deny 优先级更高
  • 以上就是 Claude Code 的权限配置

启动与验证 ​

  • 在任意项目目录下输入 claude 即可启动
sh
# 启动 Claude Code
claude

# 查看当前版本
claude -v

# 查看当前状态(模型、配置等)
claude /status

# 切换模型
claude /model

总结 ​

  • 通过以上步骤,你就完成了 Claude Code 在 Windows 上的从零安装与配置,可以开始使用自定义模型的 API 了
  • 配置的核心在于两点:接入模型 API(ANTHROPIC_BASE_URL + ANTHROPIC_AUTH_TOKEN),以及映射三个模型档位(ANTHROPIC_DEFAULT_*_MODEL)
  • 如果后续遇到问题,可以先检查环境变量是否配置正确,以及模型名是否与平台一致

基于 MIT 许可发布