指南

Claude Code 配置

配置 Anthropic Claude Code CLI 使用本平台

什么是 Claude Code

Claude Code 是 Anthropic 推出的 AI 编程命令行工具，可在终端中进行代码编写、调试、重构等操作。

系统要求

- Node.js 版本 ≥ 18.0
- 操作系统：macOS、Linux、Windows (WSL)

Windows 用户请确保安装了 WSL，请勿使用 Windows 自带的 cmd。

快速开始

1. 安装 Claude Code

bash

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

2. 获取配置信息

配置项	说明	获取方式
ANTHROPIC_AUTH_TOKEN	API 认证令牌	注册后在「令牌」页面创建（以 `sk-` 开头）
ANTHROPIC_BASE_URL	API 服务地址	使用 `https://tokenhub.local`

3. 配置并启动

bash

# 设置环境变量
export ANTHROPIC_AUTH_TOKEN="sk-your-api-key"
export ANTHROPIC_BASE_URL="https://tokenhub.local"

# 进入项目目录并启动
cd your-project
claude

启动后按照引导完成初始设置（选择主题 → 确认安全须知 → 信任工作目录）。

永久配置（推荐）

为避免每次手动设置环境变量，将配置写入 shell 配置文件：

bash

# 写入配置
echo 'export ANTHROPIC_AUTH_TOKEN="sk-your-api-key"' >> ~/.zshrc
echo 'export ANTHROPIC_BASE_URL="https://tokenhub.local"' >> ~/.zshrc

# 使配置生效
source ~/.zshrc

如果使用 bash，将 ~/.zshrc 替换为 ~/.bashrc。

指定模型

bash

claude --model claude-sonnet-4-20250514

切换回 Anthropic 官方

取消环境变量即可恢复使用官方接口：

bash

unset ANTHROPIC_BASE_URL

常见问题

遇到 "Invalid API Key · Please run /login" 错误？

请检查：

- 是否正确设置了 ANTHROPIC_AUTH_TOKEN 和 ANTHROPIC_BASE_URL
- 令牌是否以 sk- 开头
- 使用永久配置后是否重启了终端

为什么显示 "offline" 状态？

Claude Code 通过连接 Google 来判断网络状态。显示 "offline" 不影响正常使用，仅表示无法连接到 Google。

请求总是显示 "fetch failed"？

可能是网络环境导致的问题，建议：

- 尝试使用代理工具
- 退出 Claude Code（Ctrl+C）后重新运行 claude 命令
- 如果问题持续，请稍后再试

Claude Code 涉及 Anthropic Messages 协议（/v1/messages）；是否可用取决于当前环境是否已完成兼容验证。

Related guides

Codex

Cline