跳到主要内容

在命令行使用 Claude Code

Claude Code 是由 Anthropic 官方推出的一款基于 Claude 系列大模型的代码开发辅助 Agent，支持代码生成、代码补全、代码解释、直接调用终端等功能。 使用本软件前需要有一定的命令行操作基础。

1. 软件下载​

请前往 Claude Code 官方下载页面（需要非中国大陆和中国港澳台地区的代理） 下载并安装 Claude Code 应用程序。

手动安装步骤：

  1. 安装 Node.js（版本18及以上）和 npm 打开 这个链接 下载并安装 Node.js（版本18及以上）和 npm。

  2. 下载 Claude Code 在终端中运行以下命令下载 Claude Code：

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

2. 配置 Claude Code​

启动 Claude Code前，请先配置环境变量 ANTHROPIC_BASE_URL 和 ANTHROPIC_API_KEY。

在 Linux/macOS 终端中运行以下命令：

export ANTHROPIC_BASE_URL="https://api.x-aio.com/anthropic/<model>"
export ANTHROPIC_API_KEY="你的API密钥"

在 Windows PowerShell 中运行以下命令：

$env:ANTHROPIC_BASE_URL="https://api.x-aio.com/anthropic/<model>"
$env:ANTHROPIC_API_KEY="你的API密钥"

请将 "你的API密钥" 替换为你在 X-AIO 控制台 获取的 API 密钥。

由于最新版 claude code 的模型选择可能存在问题，请将 <model> 替换为你想使用的模型名称，例如 deepseek-r1。

如需对接 Tensdaq，请将 ANTHROPIC_BASE_URL 替换为 https://tensdaq-api.x-aio.com/anthropic/<model>。

3. 持久化claude code的环境变量配置​

为了避免每次启动 Claude Code 都需要重新设置环境变量，可以将环境变量配置添加到 claude code 的配置文件中。

  1. 找到 Claude Code 的配置文件 ~/.claude/settings.json（Linux/macOS）或 %USERPROFILE%\.claude\settings.json（Windows）。
  2. 打开 settings.json 文件，并添加以下内容：
{
    "env": {
      "ANTHROPIC_BASE_URL": "http://api.x-aio.com/anthropic/<model>",
      "ANTHROPIC_API_KEY": "你的API密钥"
    }
}

请将 "你的API密钥" 替换为你在 X-AIO 控制台 获取的 API 密钥。 请将 <model> 替换为你想使用的模型名称，例如 deepseek-r1。 如需对接 Tensdaq，请将 ANTHROPIC_BASE_URL 替换为 https://tensdaq-api.x-aio.com/anthropic/<model>。 3. 保存并关闭文件。

4. 绕过 Claude Code 初次启动的网络检查​

由于 Claude Code 在初次启动时会进行网络检查，如果你所在的网络环境无法访问外网，可能会导致启动失败。你可以通过以下方法绕过网络检查：

  1. 打开 Claude Code 的配置文件 ~/.claude.json（Linux/macOS）或 %USERPROFILE%\.claude.json（Windows），如果没有请新建一个。

  2. 覆盖这个文件：

{
    "hasCompletedOnboarding": true
}

注意，如果以前用过 claude 请不要覆盖这个文件，而是直接在文件中添加 "hasCompletedOnboarding": true 这一行。

  1. 保存并关闭文件。

5. 启动 Claude Code​

在终端中运行以下命令启动 Claude Code：

claude

启动后会提示使用了环境变量的 API 密钥，请通过上下选择Yes，然后按回车键继续。

然后就可以愉快地使用 Claude Code 了！