Claude Code CLI 设置

学习如何配置 Claude Code CLI 使用 CiYuanX 的 API。本指南涵盖 Windows、macOS 和 Linux 的安装和配置。

什么是 Claude Code？

Claude Code 是 Anthropic 的官方命令行界面（CLI）工具，将 AI 助手直接带到你的终端和代码编辑器中。通过配置它使用 CiYuanX，你可以通过一个熟悉的界面访问多个 AI 模型。

前置条件

开始之前，请确保你拥有：

• 一个 CiYuanX 账户（在此注册）
• 一个 CiYuanX API 密钥（获取密钥）
• 计算机上的终端 / 命令提示符访问权限

安装

由于网络访问可能不稳定，推荐先安装 Node.js，再通过 npm 全局安装 @anthropic-ai/claude-code。

macOS 和 Linux

1. 安装 Node.js

💡 方案一：使用 nvm（推荐）

这套方案可以从安装到使用都尽量走国内镜像，加速拉取和安装。

首先，从 Gitee 镜像安装 nvm，避免访问 GitHub 时的网络问题：

bash -c "$(curl -fsSL https://gitee.com/RubyMetric/nvm-cn/raw/main/install.sh)"

安装完成后，配置 nvm 使用国内镜像加速 Node.js 下载：

# 设置 Node.js 下载源为阿里云镜像
export NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node/
# 使配置生效
source ~/.bashrc

说明

此安装脚本已内置镜像支持，会自动配置 .bashrc 环境变量，并将 Node.js 下载源设置为阿里云镜像。source ~/.bashrc 用于让当前终端窗口的环境变量立即生效，避免重启终端。如果你使用 Zsh，也可以根据实际情况执行 source ~/.zshrc。

安装最新的 LTS（长期支持）版本：

nvm install --lts

验证 Node.js 和 npm 是否安装成功：

node -v
npm -v

2. 安装 Claude Code

全局安装 Claude Code：

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

如果遇到权限问题，可以使用 sudo：

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

验证安装：

claude --version

如果显示版本号，说明 Claude Code 已经成功安装。

Windows

1. 安装 Node.js

推荐使用 MSI 安装包，整个过程基本按指引进行即可。

1. 下载安装包：从 Node.js 官网 选择系统对应的 Windows 安装包（.msi）。如果官网下载较慢，可以使用国内镜像站，例如 华为云 Node.js 镜像。
2. 运行安装：双击下载的 .msi 文件，按提示点击 Next 继续。
3. 在 Destination Folder 界面，建议将安装目录改到非 C 盘路径，例如 D:\software\nodejs，避免长期占用 C 盘空间。
4. 继续下一步，确保勾选 Add to PATH，让安装程序自动把 node 和 npm 命令添加到系统环境变量。
5. 在 Tools for Native Modules 界面，除非你明确需要编译 C++ 模块，否则建议取消勾选，不安装推荐的工具集，以节省时间。
6. 点击 Install 开始安装，直到完成。

安装完成后，打开命令提示符（cmd）或 PowerShell，验证安装：

node -v
npm -v

如果成功显示版本号，就说明 Node.js 和 npm 已经安装好了。

可选：如果你希望以后全局安装的包和缓存文件也放在刚才指定的目录下，可以依次执行：

npm config set prefix "D:\software\nodejs\node_global"
npm config set cache "D:\software\nodejs\node_cache"

之后，记得在系统环境变量中，将 Path 中的 npm 全局路径调整为 D:\software\nodejs\node_global。

2. 安装 Claude Code

打开 Terminal、命令提示符（cmd）或 PowerShell，运行以下命令全局安装 Claude Code：

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

验证安装：

claude --version

如果显示版本号，恭喜你！Claude Code 已经成功安装。

配置

要在 Claude Code 中使用 CiYuanX，你需要设置两个环境变量：

环境变量	说明
ANTHROPIC_AUTH_TOKEN	你的 CiYuanX API 密钥
ANTHROPIC_BASE_URL	CiYuanX 的 API 端点（https://ciyuanx.io）

选择以下配置方法之一。

方法 1：永久配置（推荐）

此方法可以安全地保存你的 API 密钥并在会话之间保持。

提示

推荐使用此方法，配置一次即可长期生效。

macOS 和 Linux

将这些行添加到你的 shell 配置文件中（Bash 用 ~/.bashrc 或 ~/.bash_profile，Zsh 用 ~/.zshrc）：

export ANTHROPIC_AUTH_TOKEN="sk-your-ciyuanx-api-key"
export ANTHROPIC_BASE_URL="https://ciyuanx.io"

应用更改：

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

Windows

使用 PowerShell（持久性）——以管理员身份打开后运行：

[System.Environment]::SetEnvironmentVariable('ANTHROPIC_AUTH_TOKEN', 'sk-your-ciyuanx-api-key', 'User')
[System.Environment]::SetEnvironmentVariable('ANTHROPIC_BASE_URL', 'https://ciyuanx.io', 'User')

或使用命令提示符（持久性）：

setx ANTHROPIC_AUTH_TOKEN "sk-your-ciyuanx-api-key"
setx ANTHROPIC_BASE_URL "https://ciyuanx.io"

设置后重启终端以应用更改。

方法 2：临时配置（仅当前会话）

macOS / Linux

export ANTHROPIC_AUTH_TOKEN="sk-your-ciyuanx-api-key"
export ANTHROPIC_BASE_URL="https://ciyuanx.io"

Windows PowerShell

$env:ANTHROPIC_AUTH_TOKEN="sk-your-ciyuanx-api-key"
$env:ANTHROPIC_BASE_URL="https://ciyuanx.io"

Windows 命令提示符

set ANTHROPIC_AUTH_TOKEN=sk-your-ciyuanx-api-key
set ANTHROPIC_BASE_URL=https://ciyuanx.io

方法 3：使用 Claude Code 设置

创建或编辑 ~/.claude/settings.json：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-your-ciyuanx-api-key",
    "ANTHROPIC_BASE_URL": "https://ciyuanx.io"
  }
}

方法 4：使用 CC Switch（图形界面）

CC Switch 是一个 Claude Code 供应商切换工具，提供图形化界面来管理多个 API 供应商配置。安装方法请参考仓库说明。

配置 CiYuanX 供应商：

1. 运行 CC Switch 打开配置界面
2. 关闭顶部的 Live 代理开关（该开关会让请求走 CC Switch 自己的代理，没有必要开启）
3. 添加新供应商，填写以下信息：
   • 供应商名称：CiYuanX
   • 备注：CiYuanX
   • 官网链接：https://ciyuanx.io
   • API Key：你的 CiYuanX API 密钥
   • 请求地址：https://ciyuanx.io（不要以斜杠结尾）
   • API 格式：Anthropic Messages（原生）
   • 主模型：claude-opus-4-6
   • 推理模型（Thinking）：claude-opus-4-6-thinking
   • Haiku 默认模型：claude-haiku-4-5-20251001
   • Sonnet 默认模型：claude-sonnet-4-5-20250929
   • Opus 默认模型：claude-opus-4-6
4. 点击“保存”按钮

使用 GPT 模型

除了 Claude 模型，你还可以让 Claude Code 通过 CiYuanX 调用 GPT 系列模型。在前面的基础配置上，额外设置以下环境变量即可：

环境变量	说明
ANTHROPIC_MODEL	主模型，例如 code/gpt-5.5
ANTHROPIC_SMALL_FAST_MODEL	用于轻量任务的小型快速模型，例如 code/gpt-5.4-mini
ANTHROPIC_DEFAULT_SONNET_MODEL	Sonnet 档位映射到的模型，例如 code/gpt-5.5
ANTHROPIC_DEFAULT_OPUS_MODEL	Opus 档位映射到的模型，例如 code/gpt-5.5
ANTHROPIC_DEFAULT_HAIKU_MODEL	Haiku 档位映射到的模型，例如 code/gpt-5.4-mini
ANTHROPIC_API_KEY	留空，避免与 ANTHROPIC_AUTH_TOKEN 冲突
CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY	设为 1，启用网关模型发现
CLAUDE_CODE_ATTRIBUTION_HEADER	设为 0，关闭归属请求头

提示

ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN 与基础配置相同，无需改动。把 ANTHROPIC_API_KEY 显式设为空字符串，可避免它覆盖 ANTHROPIC_AUTH_TOKEN。

macOS 和 Linux

将这些行添加到你的 shell 配置文件中（Bash 用 ~/.bashrc 或 ~/.bash_profile，Zsh 用 ~/.zshrc）：

export ANTHROPIC_BASE_URL="https://ciyuanx.io"
export ANTHROPIC_AUTH_TOKEN="sk-your-ciyuanx-api-key"
export ANTHROPIC_API_KEY=""
export ANTHROPIC_MODEL="code/gpt-5.5"
export ANTHROPIC_SMALL_FAST_MODEL="code/gpt-5.4-mini"
export ANTHROPIC_DEFAULT_SONNET_MODEL="code/gpt-5.5"
export ANTHROPIC_DEFAULT_OPUS_MODEL="code/gpt-5.5"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="code/gpt-5.4-mini"
export CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1
export CLAUDE_CODE_ATTRIBUTION_HEADER=0

应用更改：

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

Windows

使用 PowerShell（持久性）——以管理员身份打开后运行：

[System.Environment]::SetEnvironmentVariable('ANTHROPIC_BASE_URL', 'https://ciyuanx.io', 'User')
[System.Environment]::SetEnvironmentVariable('ANTHROPIC_AUTH_TOKEN', 'sk-your-ciyuanx-api-key', 'User')
[System.Environment]::SetEnvironmentVariable('ANTHROPIC_API_KEY', '', 'User')
[System.Environment]::SetEnvironmentVariable('ANTHROPIC_MODEL', 'code/gpt-5.5', 'User')
[System.Environment]::SetEnvironmentVariable('ANTHROPIC_SMALL_FAST_MODEL', 'code/gpt-5.4-mini', 'User')
[System.Environment]::SetEnvironmentVariable('ANTHROPIC_DEFAULT_SONNET_MODEL', 'code/gpt-5.5', 'User')
[System.Environment]::SetEnvironmentVariable('ANTHROPIC_DEFAULT_OPUS_MODEL', 'code/gpt-5.5', 'User')
[System.Environment]::SetEnvironmentVariable('ANTHROPIC_DEFAULT_HAIKU_MODEL', 'code/gpt-5.4-mini', 'User')
[System.Environment]::SetEnvironmentVariable('CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY', '1', 'User')
[System.Environment]::SetEnvironmentVariable('CLAUDE_CODE_ATTRIBUTION_HEADER', '0', 'User')

或使用命令提示符（持久性）：

setx ANTHROPIC_BASE_URL "https://ciyuanx.io"
setx ANTHROPIC_AUTH_TOKEN "sk-your-ciyuanx-api-key"
setx ANTHROPIC_API_KEY ""
setx ANTHROPIC_MODEL "code/gpt-5.5"
setx ANTHROPIC_SMALL_FAST_MODEL "code/gpt-5.4-mini"
setx ANTHROPIC_DEFAULT_SONNET_MODEL "code/gpt-5.5"
setx ANTHROPIC_DEFAULT_OPUS_MODEL "code/gpt-5.5"
setx ANTHROPIC_DEFAULT_HAIKU_MODEL "code/gpt-5.4-mini"
setx CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY "1"
setx CLAUDE_CODE_ATTRIBUTION_HEADER "0"

设置后重启终端以应用更改。如需只在当前会话临时生效，可在 PowerShell 中用 $env:变量名="值"，或在命令提示符中用 set 变量名=值。

验证配置

启动 Claude Code 后，输入 /status 命令查看配置状态。如果看到以下信息，说明配置成功：

Anthropic base URL: https://ciyuanx.io

也可以发送消息测试：

claude "Hi"

如果配置正确，Claude Code 应该使用 CiYuanX 的 API 进行响应。

检查环境变量：

macOS / Linux

echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_AUTH_TOKEN

Windows PowerShell

echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_AUTH_TOKEN

故障排除

“无效的 API 密钥”错误

• 验证你的 API 密钥是否正确：控制台 → API 令牌
• 确保环境变量中没有额外的空格
• 检查 ANTHROPIC_BASE_URL 是否设置为 https://ciyuanx.io（不带 /v1）

“连接被拒绝”错误

• 验证你的互联网连接
• 检查你是否可以在浏览器中访问 https://ciyuanx.io
• 确保你的防火墙允许出站 HTTPS 连接

找不到 Claude Code

macOS / Linux

# 检查 Claude Code 是否在你的 PATH 中
which claude

# 如果未找到，在 ~/.zshrc 或 ~/.bashrc 中添加到 PATH：
export PATH="$HOME/.claude/bin:$PATH"

Windows

验证 PATH 环境变量是否包含 C:\Users\YourUsername\.claude\bin，添加到 PATH 后重启终端。