Claude Code CLI

​

概述

​

使用前准备

​

获取 EvoLink API Key

• 登录 EvoLink 控制台
• 在控制台中找到 API Keys，点击”创建新Key”按钮，然后复制生成的 Key
• API Key 通常以 sk- 开头，请妥善保存

​

第一步：安装 Claude Code CLI

​

1. 一键安装

• macOS / Linux
• Windows

curl -fsSL https://claude.ai/install.sh | bash

预期结果： 会看到下载和安装信息，最后显示安装成功提示。如果出错： 提示 permission denied 时，在命令前加 sudo。

​

1.1 安装 Node.js 与 npm（已安装可跳过）

首次安装：

1. 访问 Node.js 官方网站 下载并安装（推荐下载 LTS 长期支持版）
2. 如果不熟悉安装流程，可参考 菜鸟教程 - Node.js 安装配置
3. 建议使用 Node.js v20 或更高版本

安装完成后验证：

node -v
npm -v

​

1.2 安装 Claude Code CLI

在 PowerShell 或 CMD 中执行：

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

预期结果： 会看到下载和安装信息，最后显示安装成功提示。如果出错：

• 提示 permission denied 时，需要右键”以管理员身份运行” PowerShell 或 CMD
• 如果提示 npm command not found，说明 Node.js 未正确安装或未添加到环境变量

​

2. 检验安装

claude --version

​

第二步：配置 EvoLink API

• CC Switch
• settings.json
• 永久设置
• 临时设置

CC Switch 是一个桌面 GUI 工具，可以通过图形界面管理 Claude Code 的提供商配置，无需手动编辑配置文件。

​

1. 安装 CC Switch

从 GitHub Releases 下载对应平台的安装包并安装。

​

2. 配置 EvoLink（新建供应商）

推荐新建一个干净的供应商，严格按下面步骤填。 全程只需填三个框，不要去动”高级选项 / 配置 JSON”——这是最不容易出错的方式。

第 1 步： 打开 CC Switch，点击右上角的图标进入配置页面。

第 2 步： 点击”添加新供应商”，只填以下三项（如图红框处）：

• 供应商名称：填 EvoLink.AI
• API Key：填你的 EvoLink API Key（以 sk- 开头）
• 请求地址：填 https://direct.evolink.ai（不要以斜杠 / 结尾）

只需填上面这三项就够了，请不要展开下方的”高级选项 / 配置 JSON”去手动修改。API Key 框下方有一行提示”只需要填这里，下方配置会自动填充”——CC Switch 会根据你填的三项自动生成正确的配置 JSON（API 格式、认证字段、模型映射等，保持默认即可）。如果你手动去改配置 JSON（例如动了 ANTHROPIC_BASE_URL、effortLevel、认证字段或模型映射），这些手改内容会在保存时覆盖自动生成的正确配置，反而导致接入失败。

第 3 步： 点击”添加”。CC Switch 会自动将配置写入 settings.json，无需手动操作。配置成功长什么样： 新供应商出现在列表中、可以切换启用。随后回到终端运行 claude "你是谁" 能得到正常回复，即表示接入成功。

​

之前配置过、现在接不上？

如果你以前配过 EvoLink 或别的服务、现在接不上，多半不是上面三项填错，而是下方”高级选项 → 配置 JSON”里残留了旧内容（例如旧的 ANTHROPIC_BASE_URL 地址、旧的 Key，或手动加过的 effortLevel、skipDangerousModePermissionPrompt 等非默认项）。这些残留会覆盖正确配置。最省心的解法：删掉旧的 EvoLink 供应商，严格按上面步骤新建一个干净的，全程只填三项、不碰高级选项。

想保留旧配置、手动排查？点这里

如果你不想删旧配置，可以打开”编辑供应商” → 展开 “高级选项” → 检查 “配置 JSON”，确认以下几点：

• env.ANTHROPIC_BASE_URL 是 https://direct.evolink.ai（不是旧的地址）
• env.ANTHROPIC_AUTH_TOKEN 是你的 EvoLink API Key（不是旧的 Key）
• 删掉你不确定的手动添加项，让配置回到”只由上方三项自动生成”的状态

改完点”保存”。不过仍然推荐直接删旧重建——那样最不容易漏掉残留项。

CC Switch 还支持系统托盘快捷切换、MCP 服务器管理、云端配置同步等功能。

注意： 如果是第一次使用 Claude Code CLI，建议先使用”临时设置”进行测试，确认配置正确后再使用此方法进行永久配置。

​

1. 打开配置目录

• Windows
• macOS
• Linux

按下 Win + R 键，输入以下内容后回车：

%userprofile%\.claude

如果提示文件夹不存在：需要先手动创建 .claude 文件夹（在 %userprofile% 目录下新建文件夹，命名为 .claude）。

在访达界面按下 Command + Shift + G，输入以下路径后回车：

~/.claude

如果提示文件夹不存在：打开终端执行 mkdir ~/.claude 创建文件夹。

打开文件管理器，进入以下目录：

~/.claude

如果提示文件夹不存在：打开终端执行 mkdir ~/.claude 创建文件夹。

​

2. 编辑 settings.json

在打开的文件夹中，如果没有 settings.json 文件，右键空白处 → 新建 → 文本文档 → 将文件名改为 settings.json（注意删除 .txt 后缀）。然后双击用编辑器打开，添加以下内容：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "你的EvoLink API Key",
    "ANTHROPIC_BASE_URL": "https://direct.evolink.ai",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  },
  "permissions": {
    "allow": [],
    "deny": []
  }
}

重要提示：

• 请完整复制上面内容，不要遗漏任何符号
• 将 "你的EvoLink API Key" 替换为实际的 API Key（保留引号）
• 不要用中文输入法输入标点符号（如中文逗号 ，）

配置项说明：

• ANTHROPIC_AUTH_TOKEN：你的 EvoLink API Key
• ANTHROPIC_BASE_URL：https://direct.evolink.ai （EvoLink API 接口地址）
• CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC：减少非必要网络请求

• Windows
• macOS
• Linux

图形界面设置：

1. 右键「此电脑」→「属性」→「高级系统设置」→「环境变量」
2. 在「用户变量」或「系统变量」中新建：
   • 变量名：ANTHROPIC_BASE_URL
   • 变量值：https://direct.evolink.ai
3. 同样方法添加 ANTHROPIC_AUTH_TOKEN，变量值为你的 API Key
4. 点击「确定」保存

PowerShell 命令设置：

[System.Environment]::SetEnvironmentVariable('ANTHROPIC_BASE_URL', 'https://direct.evolink.ai', 'User')
[System.Environment]::SetEnvironmentVariable('ANTHROPIC_AUTH_TOKEN', '你的EvoLink API Key', 'User')

说明： 重启终端后生效。

编辑 shell 配置文件（根据使用的 shell 选择）：如果是 zsh（macOS 默认）：

echo 'export ANTHROPIC_BASE_URL="https://direct.evolink.ai"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="你的EvoLink API Key"' >> ~/.zshrc

如果是 bash：

echo 'export ANTHROPIC_BASE_URL="https://direct.evolink.ai"' >> ~/.bash_profile
echo 'export ANTHROPIC_AUTH_TOKEN="你的EvoLink API Key"' >> ~/.bash_profile

立即生效：

source ~/.zshrc  # 或 source ~/.bash_profile

编辑 shell 配置文件（根据使用的 shell 选择）：如果是 bash（Linux 常用）：

echo 'export ANTHROPIC_BASE_URL="https://direct.evolink.ai"' >> ~/.bashrc
echo 'export ANTHROPIC_AUTH_TOKEN="你的EvoLink API Key"' >> ~/.bashrc

如果是 zsh：

echo 'export ANTHROPIC_BASE_URL="https://direct.evolink.ai"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="你的EvoLink API Key"' >> ~/.zshrc

立即生效：

source ~/.bashrc  # 或 source ~/.zshrc

注意：将 你的EvoLink API Key 替换为实际的 API Key。

• Windows
• macOS / Linux

在 PowerShell 中执行：

$env:ANTHROPIC_BASE_URL="https://direct.evolink.ai"
$env:ANTHROPIC_AUTH_TOKEN="你的EvoLink API Key"

在 CMD 中执行：

set ANTHROPIC_BASE_URL=https://direct.evolink.ai
set ANTHROPIC_AUTH_TOKEN=你的EvoLink API Key

说明： 关闭终端后配置失效，需要重新设置。

在终端中执行：

export ANTHROPIC_BASE_URL="https://direct.evolink.ai"
export ANTHROPIC_AUTH_TOKEN="你的EvoLink API Key"

说明： 关闭终端后配置失效，需要重新设置。

注意：将 你的EvoLink API Key 替换为实际的 API Key。

​

第三步：开始使用 Claude Code CLI

​

1. 进入安全的工作目录

cd 你的工作目录

​

2. 启动交互模式

claude

​

3. 验证配置

claude "你是谁"

• 看到 AI 的正常回复内容（几行文字），且回复来自 Claude 模型。
• 没有出现 401、403、API Key invalid、弹出官方登录等异常。

​

排错

​

弹出官方登录页 / 提示登录 Anthropic 账号

• 确认 ANTHROPIC_BASE_URL 与 ANTHROPIC_AUTH_TOKEN 已正确设置且在当前终端可读（改完配置后重启终端）。
• 如果你之前登录过官方账号，清除残留：删除或覆盖 ANTHROPIC_AUTH_TOKEN，并检查是否残留了其它会抢占请求的旧变量（见下一条）。

​

明明配了 EvoLink 却还是走了别的服务 / 旧凭证冲突

• ANTHROPIC_API_KEY：如果你只用 ANTHROPIC_AUTH_TOKEN 接 EvoLink，把 ANTHROPIC_API_KEY 置空或删除，避免两个 Key 变量打架。
• 任何指向其它服务的 ANTHROPIC_BASE_URL 旧值：确认当前值就是 https://direct.evolink.ai。
• 检查 ~/.claude/settings.json 的 env 段与 shell 配置文件（.zshrc / .bashrc 等）里是否有相互覆盖的旧配置。

​

返回 401 Unauthorized

​

返回 403 Forbidden

​

返回 model_not_found

​

返回 404 Invalid URL（路径重复）

​

执行后没有任何输出 / Network error

​

常见问题

​

1. Claude Code CLI 是什么？主要用来做什么？

​

2. 第一次使用时，如何确认是否已经安装并配置成功？

• claude --version：确认 Claude Code CLI 已安装
• claude "你是谁"：确认 API 配置正确，能正常返回响应

​

3. 交互模式和单次命令模式有什么区别？

• 交互模式：执行 claude 进入持续对话，可多轮交互，适合复杂任务
• 单次命令模式：执行 claude "问题" 获取单次响应后退出，适合快速查询

​

4. Claude Code CLI 会不会自动读取或上传我本地的文件和代码？

​

5. 如何使用 Claude Code CLI 分析或处理本地文件内容？

• 直接输入文件路径让 Claude 读取
• 拖拽文件到终端窗口
• 复制粘贴文件内容

​

6. Claude Code CLI 是否支持中文输入和中文输出？

​

7. 执行后没有任何输出，可能是什么原因？

• 网络连接问题，无法访问 API 服务器
• API Key 无效或余额不足
• ANTHROPIC_BASE_URL 配置错误
• 防火墙或代理阻止了请求

​

8. 修改了配置文件或环境变量后，为什么没有生效？

• 需要重新启动终端或命令行窗口
• 检查 settings.json 文件格式是否正确（JSON 语法）
• 确认配置文件路径正确：
  • Windows: C:\Users\{用户名}\.claude\settings.json（将 {用户名} 替换为你的 Windows 用户名，如 C:\Users\Zhang\.claude\settings.json）
  • macOS / Linux: ~/.claude/settings.json

​

9. 使用时出现 401/403 错误一般是什么原因？

• 401 错误：ANTHROPIC_AUTH_TOKEN 未设置或 API Key 无效
• 403 错误：API Key 权限不足或已过期
• 请检查 ANTHROPIC_BASE_URL 是否为 https://direct.evolink.ai
• 更多按报错分类的定位方法见 排错 章节。

​

10. Claude Code CLI 适合哪些使用场景？又不适合哪些场景？

• 代码编写、调试和重构
• 命令行环境下的快速问答
• 文件内容分析和处理
• 自动化脚本集成

• 需要图形界面的复杂交互
• 实时协作编辑
• 大规模文件批量处理

​

11. 如何切换模型？

​

12. EvoLink 支持哪些 Claude 模型？

​

13. 怎么上传图片？

• 方法一：直接引用图片路径
• 方法二：拖拽图片进终端
• 方法三：直接粘贴

​

14. 如何打开命令行终端？

​

注意