Claude Code 国内API配置完整指南

前言

本文将详细介绍如何安装Claude Code命令行工具,并配置国内智谱AI(ChatGLM)API实现无缝使用。即使你是新手小白,按照本教程也能轻松完成配置。

一、环境检查

1. 检查Node.js安装

打开命令提示符(CMD)或PowerShell,执行:

bash 复制代码
node --version

如果显示版本号,说明已安装;如果提示"不是内部命令",则需要安装Node.js。

2. 检查npm安装

bash 复制代码
npm --version

同样,如果未安装会提示错误信息。

3. 一键安装脚本(推荐新手)

如果以上两个命令都未安装,且你是新手小白,可以使用我提供的一键安装脚本:

夸克网盘下载运行文件:

https://pan.quark.cn/s/186d21931bc8

使用方法:

  • 下载 install_node.batinstall_node.ps1 两个文件

  • 将两个文件放在同一路径下

  • 双击运行 install_node.bat 即可自动完成安装

二、安装Claude Code

1. 全局安装

请以管理员身份运行 PowerShell 或 CMD,然后执行:

bash 复制代码
npm install -g @anthropic-ai/claude-code

2. 验证安装

安装完成后,执行:

bash 复制代码
claude --version

如下图显示版本号,说明安装成功。


三、配置国内智谱AI API

1. 注册智谱AI账号

访问官网注册账号(新用户赠送2000万token): 👉 https://bigmodel.cn/

2. 获取API Key

登录后按以下步骤操作:

  1. 点击右上角头像,进入个人主页

  2. 点击左侧菜单的 "API Keys"

  3. 点击 "添加新的API Key" ,填写名称后生成

  4. 复制并保存生成的API Key


3. 配置Claude Code设置文件

配置文件1:settings.json

打开文件(路径中的"你的用户名"请替换为实际用户名):

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

如果文件夹或文件不存在,请手动创建。

将以下内容复制进去,替换掉其中的API Key

java 复制代码
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "这里填写你的智谱API Key",
    "ANTHROPIC_BASE_URL": "https://open.bigmodel.cn/api/anthropic",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "glm-4.5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-4.7",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-4.6",
    "ANTHROPIC_MODEL": "glm-4.7"
  },
  "includeCoAuthoredBy": false
}
配置文件2:.claude.json

打开或创建文件(注意文件名以点开头):

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

直接复制以下内容(此配置用于跳过官方认证):

java 复制代码
{
  "customApiKeyResponses": {},
  "tipsHistory": {},
  "promptQueueUseCount": 0,
  "cachedGrowthBookFeatures": {
    "tengu_1p_event_batch_config": {},
    "tengu_mcp_tool_search": true,
    "tengu_scratch": false,
    "tengu_disable_bypass_permissions_mode": false,
    "tengu_log_segment_events": false,
    "tengu_log_datadog_events": false,
    "tengu_pid_based_version_locking": false,
    "tengu_event_sampling_config": {},
    "tengu_tool_pear": false,
    "tengu_keybinding_customization": false,
    "tengu_thinkback": false,
    "tengu_sumi": false,
    "tengu_c4w_usage_limit_notifications_enabled": false,
    "tengu-top-of-feed-tip": {
      "tip": "",
      "color": "dim"
    },
    "tengu_react_vulnerability_warning": false,
    "tengu_code_diff_cli": false,
    "tengu_post_compact_survey": false,
    "tengu_claudeai_mcp_connectors": false,
    "enhanced_telemetry_beta": false,
    "tengu_tool_search_unsupported_models": null,
    "tengu_ant_attribution_header_new": false,
    "tengu_streaming_tool_execution2": false,
    "tengu_session_memory": false,
    "tengu_plank_river_frost": "user_intent",
    "tengu_brass_pebble": false,
    "tengu_attribution_header": true,
    "tengu_cache_plum_violet": false
  },
  "userID": "",
  "firstStartTime": "",
  "sonnet45MigrationComplete": true,
  "opus45MigrationComplete": true,
  "opusProMigrationComplete": true,
  "thinkingMigrationComplete": true,
  "cachedChromeExtensionInstalled": false,
  "hasCompletedOnboarding": true,
  "changelogLastFetched": 0,
  "lastReleaseNotesSeen": "",
  "officialMarketplaceAutoInstallAttempted": true,
  "officialMarketplaceAutoInstalled": true,
  "skillUsage": {}
}

四、启动与使用

1. 启动Claude Code

打开命令行窗口,直接输入:

bash 复制代码
claude

2. 常见问题解决

问题1:提示 "invalid API key Please run /login"

  • 这是正常现象,因为我们的配置已经跳过官方认证

  • 检查settings.json中的API Key是否正确

  • 确认两个配置文件路径和名称无误

问题2:橙色提示"anthropic不用npm管理了"

  • 可忽略此提示,不影响使用

  • 我们的方案使用自定义API,不依赖官方npm认证


🎁 彩蛋:使用CC-Switch管理多API配置

为方便在多个API之间快速切换(如智谱、月之暗面、阿里通义等),推荐使用图形化管理工具 CC-Switch

1. 下载与安装

GitHub官方地址https://github.com/farion1231/cc-switch

网盘备用链接点击下载

使用方法

  • 下载后解压,双击 cc-switch.exe 直接运行(无需安装)

  • 工具会自动读取 .claude\settings.json 中已配置的API

  • 点击 "Add" 可添加新的API配置,支持一键切换


2. 高级功能:Skills技能管理

首先说一下什么是Skills?

Skills是Claude Code的扩展技能包,能让AI执行更专业的任务(如代码审查、自动化测试、项目分析等)。

安装Skills
  1. 在根路径下新建一个skills文件夹: C:\Users\你的用户名\.claude\skills

  2. 添加Skills资源:

  3. 导入方式:

    • 将技能文件放入 skills 文件夹

    • 或在项目根目录创建 skills 文件夹,实现项目级技能隔离

    • 重启Claude Code即可自动加载

使用技巧
  • 在对话中输入 /skills 查看已加载的技能列表

  • 输入 /skill 技能名 主动调用特定技能

  • 推荐技能:code-review(AI代码审查专家), git-expert (Git版本控制助手), debug-assistant(调试诊断助手

3. 提示词设置(回答中文)

**描述:**Automatically imported on first launch

**内容:**Always respond in Chinese-simplified


至此,你已完整掌握Claude Code的本地化部署与高级玩法!如遇问题,欢迎在评论区交流,我会持续更新解决方案。

相关推荐
是三好2 小时前
Spring全家桶
java·后端·spring
西门吹雪分身2 小时前
JUC之线程中断
java
Hi202402172 小时前
Windows录制浏览器音视频
windows·音视频
索荣荣2 小时前
Java关键字终极指南:从入门到精通
java·开发语言
砚边数影2 小时前
线性回归实战(一):房价预测数据集入库KingbaseES,表结构设计
java·数据库·人工智能·深度学习·机器学习·线性回归·金仓数据库
czlczl200209252 小时前
工作流 Flowable 全流程
java·spring boot·后端
李少兄2 小时前
IntelliJ IDEA 全局搜索完全指南:从高效使用到快捷键失效排查
java·intellij-idea·策略模式
沉默-_-2 小时前
掌握Maven:高效Java项目构建与管理
java·开发语言·后端·maven
wangbing11252 小时前
从lambda 表达式引用的本地变量必须是最终变量或实际上的最终变量
java·开发语言