前言
本文将详细介绍如何安装Claude Code命令行工具,并配置国内智谱AI(ChatGLM)API实现无缝使用。即使你是新手小白,按照本教程也能轻松完成配置。
一、环境检查
1. 检查Node.js安装
打开命令提示符(CMD)或PowerShell,执行:
bash
node --version
如果显示版本号,说明已安装;如果提示"不是内部命令",则需要安装Node.js。
2. 检查npm安装
bash
npm --version
同样,如果未安装会提示错误信息。
3. 一键安装脚本(推荐新手)
如果以上两个命令都未安装,且你是新手小白,可以使用我提供的一键安装脚本:
夸克网盘下载运行文件:
使用方法:
-
下载
install_node.bat和install_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
登录后按以下步骤操作:
-
点击右上角头像,进入个人主页
-
点击左侧菜单的 "API Keys"
-
点击 "添加新的API Key" ,填写名称后生成
-
复制并保存生成的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
-
在根路径下新建一个skills文件夹:
C:\Users\你的用户名\.claude\skills -
添加Skills资源:
-
我已将官方Skills打包上传至网盘,方便一键下载:网盘链接
-
导入方式:
-
将技能文件放入
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的本地化部署与高级玩法!如遇问题,欢迎在评论区交流,我会持续更新解决方案。

