Claude Code 安装使用教程
适用范围：Claude Code CLI 通过 Anthropic Messages 兼容接口直连；不是 CC Switch 的 Chat Completions 转换方案。
版本与验证：用 claude --version 查看本机版本。本次核对官方安装说明和配置字段，未使用用户密钥执行付费调用。
配置速查
| 配置项 | 填写内容 | 注意事项 |
|---|---|---|
| ANTHROPIC_BASE_URL | https://api.julanjing.com | Messages 兼容服务根地址，不填 /v1/messages。 |
| ANTHROPIC_AUTH_TOKEN | 你的 巨蓝鲸AI API Key | 仅保存于本机用户级配置，勿提交到仓库。 |
| 模型 | 令牌支持的 DeepSeek 和 GLM 模型 ID | 先确认分组和工具调用能力，再设置 /model。 |
还没有 API Key？注册获取免费体验额度 · 已注册：进入控制台创建 API Key
为此工具单独创建令牌，并设置合理额度和模型权限。截图中的模型仅作示例，以账号当前可用模型为准；不要公开密钥或上传含密钥的配置文件。
Claude Code 是 Anthropic 官方命令行工具，通过 巨蓝鲸AI API 接入 Claude 大模型。它直接在本地项目目录里工作：读代码、辅助排查问题、生成实现、解释逻辑，整体更贴近真实开发流程。
Anthropic 官方命令行工具，通过 巨蓝鲸AI API 接入 Claude 大模型。
Windows 安装 Claude Code（npm 方式）
Windows 用户可以直接使用 PowerShell 安装 Claude Code，无需安装 WSL / Ubuntu。安装前请先准备 Git for Windows。
安装 Git for Windows
如果 Git 官网下载较慢，可使用国内镜像下载，选择最新版本，下载 64-bit Git for Windows Setup 结尾的 .exe 安装包。安装时建议勾选 Add Git to PATH。
https://mirrors.tuna.tsinghua.edu.cn/github-release/git-for-windows/git/打开 PowerShell
在开始菜单打开普通 PowerShell。不要仅为安装而默认提升管理员权限。
安装 Claude Code
下面保留 npm 安装方式，先安装 Node.js 18 或以上版本；也可使用开头官方安装指南中的原生安装器。
npm install -g @anthropic-ai/claude-code安装完成后，请关闭当前 PowerShell 窗口，并重新打开新的 PowerShell。
验证安装
claude --version如果能看到版本号，说明 Claude Code 安装成功。
进入项目目录并启动
cd D:\your-projectclaude- 选择喜欢的主题（回车）
- 确认安全须知（回车）
- 使用默认 Terminal 配置（回车）
- 信任工作目录（回车）
- 开始编程
配置 巨蓝鲸AI API
访问 巨蓝鲸AI API 控制台获取你的 API Key，然后在 PowerShell 中执行以下命令。
setx ANTHROPIC_BASE_URL "https://api.julanjing.com"
setx ANTHROPIC_AUTH_TOKEN "你的 巨蓝鲸AI API Key"设置完成后，关闭当前 PowerShell，重新打开新的 PowerShell，再进入项目目录运行 claude。
https://api.julanjing.com，不要加 /v1。
安装 Node.js
使用 Homebrew 安装 Node.js（如果尚未安装 Homebrew，请先安装）。
# 安装 Homebrew（如果尚未安装）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
# 通过 Homebrew 安装 Node.js
brew install node
# 验证安装
node --version安装 Claude Code
在终端中运行官方 Claude Code 安装命令。
npm install -g @anthropic-ai/claude-code
claude --version配置 巨蓝鲸AI API
访问 巨蓝鲸AI API 控制台，点击左侧菜单「令牌管理」-「添加令牌」。
- 令牌名称：随意填写，例如 Claude Code
- 过期时间：建议按需设置较长有效期
- 额度设置：按预算设置上限
- 分组：选择当前支持 Claude Messages 与工具调用的分组
- 其他选项：保持默认设置
然后在 .claude 目录下新建或修改 settings.json 配置文件，写入以下配置信息，推荐使用这种持久化配置方式。
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "sk-你的API令牌",
"ANTHROPIC_BASE_URL": "https://api.julanjing.com",
"API_TIMEOUT_MS": "300000"
}
}https://api.julanjing.com，不要加 /v1。
启动 Claude Code
配置完成后，先进入到你的项目文件夹中。
cd your-project-folder然后运行以下命令启动 Claude Code。
claude- 选择喜欢的主题（回车）
- 确认安全须知（回车）
- 使用默认 Terminal 配置（回车）
- 信任工作目录（回车）
- 开始编程
安装 Node.js
使用以下命令安装 Node.js LTS 版本（Ubuntu / Debian）。
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs
# 验证安装
node --version安装 Claude Code
在终端中运行官方 Claude Code 安装命令。
npm install -g @anthropic-ai/claude-code
claude --version配置 巨蓝鲸AI API
访问 巨蓝鲸AI API 控制台，点击左侧菜单「令牌管理」-「添加令牌」。
- 令牌名称：随意填写，例如 Claude Code
- 过期时间：建议按需设置较长有效期
- 额度设置：按预算设置上限
- 分组：选择当前支持 Claude Messages 与工具调用的分组
- 其他选项：保持默认设置
然后在 .claude 目录下新建或修改 settings.json 配置文件，写入以下配置信息，推荐使用这种持久化配置方式。
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "sk-你的API令牌",
"ANTHROPIC_BASE_URL": "https://api.julanjing.com",
"API_TIMEOUT_MS": "300000"
}
}https://api.julanjing.com，不要加 /v1。
启动 Claude Code
配置完成后，先进入到你的项目文件夹中。
cd your-project-folder然后运行以下命令启动 Claude Code。
claude- 选择喜欢的主题（回车）
- 确认安全须知（回车）
- 使用默认 Terminal 配置（回车）
- 信任工作目录（回车）
- 开始编程
直连与本地路由不要混用
本文设置 ANTHROPIC_BASE_URL，要求 Messages 兼容上游。如果使用 CC Switch 将 Chat Completions 转成 Messages，请改看 CC Switch 配置教程，由路由管理地址，不要再用旧环境变量覆盖。
怎样确认配置已生效
- 执行 claude --version，确认实际运行的安装版本。
- 重新打开终端进入测试目录，启动 claude；不要同时使用不同来源的 Key 和 Base URL。
- 先要求解释一个测试文件，不允许修改；然后对照控制台日志确认模型、时间及请求成功。
接入失败时逐项检查
| 现象 | 检查与处理 |
|---|---|
| Invalid API Key / 401 | 检查是否使用了正确服务的 Key、是否失效，以及进程是否读取到环境变量；不将所有 401 都归因于额度。 |
| 设置了变量仍未生效 | 检查用户级与项目级 settings、shell 环境和 CC Switch 是否同时接管。Windows setx 只影响新进程。 |
| 文本成功但工具报错 | 确认模型支持代理工具调用及 Messages 兼容格式；不要混用 OpenAI Chat 请求地址。 |
资料与下一步
遇到问题时保留软件版本、请求时间、模型 ID、错误码和请求 ID，联系支持时先隐藏 API Key。