Claude Code (手动配置)

应用概述

Claude Code 是由 Anthropic 官方推出的一款基于 Claude 系列大模型的代码开发辅助 Agent，支持代码生成、代码补全、代码解释、直接调用终端等功能。

注意

手动配置 Claude Code 需要有一定的命令行操作基础。

1. 软件下载与安装

请前往 Claude Code 官方下载页面了解详情，或直接通过 npm 安装。

手动安装步骤

首先安装 Node.js 环境，请前往 Node.js 官网下载并安装 Node.js（需版本 18 及以上）和 npm。

然后在终端（Terminal 或 PowerShell）中运行以下命令安装 Claude Code:

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

2. 配置 Claude Code

临时配置（当前窗口生效）

在启动 Claude Code 前，需要配置代理地址和密钥。由于平台支持多种模型，我们需要在 Base URL 中指定模型名称。

将"你的 API 密钥"替换为在 Code Plan API 密钥管理获取的真实密钥。

你需先选择三个模型进行配置：

haiku: 轻量/适用于后台任务
sonnet: 默认/一般使用
opus: 大型/强大

Linux / macOS 用户

export ANTHROPIC_BASE_URL="https://code-api.x-aio.com/anthropic"
export ANTHROPIC_API_KEY="你的 API 密钥"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1"
export API_TIMEOUT_MS="3000000"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="<haiku 模型>"
export ANTHROPIC_DEFAULT_SONNET_MODEL="<sonnet 模型>"
export ANTHROPIC_DEFAULT_OPUS_MODEL="<opus 模型>"

Windows PowerShell 用户

$env:ANTHROPIC_BASE_URL="https://code-api.x-aio.com/anthropic"
$env:ANTHROPIC_API_KEY="你的 API 密钥"
$env:CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1"
$env:API_TIMEOUT_MS="3000000"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL="<haiku 模型>"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL="<sonnet 模型>"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL="<opus 模型>"

请将 "你的 API 密钥" 替换为你在 Code Plan API 密钥管理获取的 API 密钥。

持久化配置（推荐）

为了避免每次打开终端都需要重新输入上述命令，建议将环境变量写入系统的配置文件中。

macOS / Linux（使用 zsh 或 bash）

运行以下命令将配置写入 Shell 配置文件（以 zsh 为例）：

# 请先替换下面的 你的 API 密钥
echo 'export ANTHROPIC_BASE_URL="https://code-api.x-aio.com/anthropic"' >> ~/.zshrc
echo 'export ANTHROPIC_API_KEY="你的 API 密钥"' >> ~/.zshrc
echo 'export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1"' >> ~/.zshrc
echo 'export API_TIMEOUT_MS="3000000"' >> ~/.zshrc
echo 'export ANTHROPIC_DEFAULT_HAIKU_MODEL="<haiku 模型>"' >> ~/.zshrc
echo 'export ANTHROPIC_DEFAULT_SONNET_MODEL="<sonnet 模型>"' >> ~/.zshrc
echo 'export ANTHROPIC_DEFAULT_OPUS_MODEL="<opus 模型>"' >> ~/.zshrc
source ~/.zshrc

注意：如果是 bash 用户，请将 ~/.zshrc 替换为 ~/.bashrc。

Windows（PowerShell）

在 PowerShell 中以管理员身份运行以下命令，将环境变量写入当前用户配置：

# 请先替换下面的 你的 API 密钥
[System.Environment]::SetEnvironmentVariable('ANTHROPIC_BASE_URL', 'https://code-api.x-aio.com/anthropic', 'User')
[System.Environment]::SetEnvironmentVariable('ANTHROPIC_API_KEY', '你的 API 密钥', 'User')
[System.Environment]::SetEnvironmentVariable('CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC', '1', 'User')
[System.Environment]::SetEnvironmentVariable('API_TIMEOUT_MS', '3000000', 'User')
[System.Environment]::SetEnvironmentVariable('ANTHROPIC_DEFAULT_HAIKU_MODEL', '<haiku 模型>', 'User')
[System.Environment]::SetEnvironmentVariable('ANTHROPIC_DEFAULT_SONNET_MODEL', '<sonnet 模型>', 'User')
[System.Environment]::SetEnvironmentVariable('ANTHROPIC_DEFAULT_OPUS_MODEL', '<opus 模型>', 'User')

设置完成后，请重启 PowerShell 窗口以生效。

绕过初次启动的网络检查

Claude Code 在初次启动时会尝试连接 Anthropic 官方服务器进行认证。如果你的网络环境无法直接访问外网，可能会导致卡在 Onboarding 界面。可以通过修改配置文件跳过此步骤。

找到或创建配置文件

配置文件位置：

Linux/macOS: ~/.claude.json
Windows: %USERPROFILE%.claude.json (通常在 C:\Users\你的用户名\.claude.json)

修改文件内容

如果文件不存在，请新建并写入以下内容；如果文件已存在，请在花括号内添加 "hasCompletedOnboarding": true。

{
    "hasCompletedOnboarding": true,
    "autoUpdaterStatus": "disabled"
}

注意事项

添加 autoUpdaterStatus 为 disabled 可防止软件尝试自动更新导致连接超时。
如果以前用过 claude 请不要覆盖这个文件，而是直接在文件中添加 "hasCompletedOnboarding": true 这一行。

3. 开始使用 Claude Code

macOS / Linux（使用 zsh 或 bash）

运行以下命令将配置写入 Shell 配置文件（以 zsh 为例）：

# 请先替换下面的 你的 API 密钥
echo 'export ANTHROPIC_BASE_URL="https://code-api.x-aio.com/anthropic"' >> ~/.zshrc
echo 'export ANTHROPIC_API_KEY="你的 API 密钥"' >> ~/.zshrc
echo 'export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1"' >> ~/.zshrc
echo 'export API_TIMEOUT_MS="3000000"' >> ~/.zshrc
echo 'export ANTHROPIC_DEFAULT_HAIKU_MODEL="<haiku 模型>"' >> ~/.zshrc
echo 'export ANTHROPIC_DEFAULT_SONNET_MODEL="<sonnet 模型>"' >> ~/.zshrc
echo 'export ANTHROPIC_DEFAULT_OPUS_MODEL="<opus 模型>"' >> ~/.zshrc
source ~/.zshrc

注意：如果是 bash 用户，请将 ~/.zshrc 替换为 ~/.bashrc。

Windows（PowerShell）

在 PowerShell 中以管理员身份运行以下命令，将环境变量写入当前用户配置：

# 请先替换下面的 你的 API 密钥
[System.Environment]::SetEnvironmentVariable('ANTHROPIC_BASE_URL', 'https://code-api.x-aio.com/anthropic', 'User')
[System.Environment]::SetEnvironmentVariable('ANTHROPIC_API_KEY', '你的 API 密钥', 'User')
[System.Environment]::SetEnvironmentVariable('CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC', '1', 'User')
[System.Environment]::SetEnvironmentVariable('API_TIMEOUT_MS', '3000000', 'User')
[System.Environment]::SetEnvironmentVariable('ANTHROPIC_DEFAULT_HAIKU_MODEL', '<haiku 模型>', 'User')
[System.Environment]::SetEnvironmentVariable('ANTHROPIC_DEFAULT_SONNET_MODEL', '<sonnet 模型>', 'User')
[System.Environment]::SetEnvironmentVariable('ANTHROPIC_DEFAULT_OPUS_MODEL', '<opus 模型>', 'User')

设置完成后，请重启 PowerShell 窗口以生效。

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

找到或创建配置文件

配置文件位置：

Linux/macOS: ~/.claude.json
Windows: %USERPROFILE%.claude.json (通常在 C:\Users\你的用户名\.claude.json)

修改文件内容

如果文件不存在，请新建并写入以下内容；如果文件已存在，请在花括号内添加 "hasCompletedOnboarding": true。

{
    "hasCompletedOnboarding": true,
    "autoUpdaterStatus": "disabled"
}

注意事项

添加 autoUpdaterStatus 为 disabled 可防止软件尝试自动更新导致连接超时。
如果以前用过 claude 请不要覆盖这个文件，而是直接在文件中添加 "hasCompletedOnboarding": true 这一行。

5. 启动 Claude Code

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

claude

启动后，终端可能会提示检测到使用了环境变量中的 API Key，请使用键盘上下键选择 Yes 并回车确认即可。

现在，你就可以愉快地使用 Claude Code 了！

macOS 用户：通过 Homebrew 安装 Node.js

On this page