跳转到主要内容

​
准备工作

在开始之前，请确保：
  1. 已安装 Claude Code 通过 npm 或 pnpm 安装 Claude Code CLI： 
    # npm
npm install -g @anthropic-ai/claude-code

# pnpm
pnpm install -g @anthropic-ai/claude-code
    或访问 Claude Code 官方文档 获取最新安装方式
  2. 已获取 ToAPIs API 密钥 登录 ToAPIs 控制台 获取您的 API 密钥（以 sk- 开头）
提示： 如果还没有 ToAPIs 账户，请先在 ToAPIs 注册并获取 API 密钥。

​
配置方式

Claude Code 支持多种方式配置自定义 API 端点，您可以将 ToAPIs 作为 Anthropic API 的替代后端。 Claude Code 使用两个不同的 JSON 文件：onboarding 状态 与 环境变量 需分别写入对应文件才能生效。

​
先确认 onboarding 已完成

在用户主目录下的 ~/.claude.json 中设置已完成引导（若文件不存在可创建）： 
{
  "hasCompletedOnboarding": true
}
该文件仅用于 CLI 状态位；API 密钥与 base URL 请写在下面的 settings.json 中。

​
方式一：通过 settings.json 配置（推荐）

在 ~/.claude/settings.json（全局）或项目根目录的 .claude/settings.json（项目级）中配置环境变量，无需修改 shell 配置文件： 
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-xxxxxxxxxxxx",
    "ANTHROPIC_BASE_URL": "https://toapis.com"
  }
}
全局配置（推荐，对所有项目生效）： 
# 创建或编辑 ~/.claude/settings.json
mkdir -p ~/.claude
然后将上述 JSON 写入 ~/.claude/settings.json。 项目级配置（仅对当前项目生效）： 在项目根目录创建 .claude/settings.json。项目级文件中不要包含 API Key，建议只在全局配置中写 ANTHROPIC_AUTH_TOKEN，项目配置中只写 ANTHROPIC_BASE_URL： 
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://toapis.com"
  }
}
注意： hasCompletedOnboarding 放在 ~/.claude.json，env 放在 ~/.claude/settings.json 或 .claude/settings.json，不要混写到同一个文件中。

​
方式二：通过环境变量配置

适用于临时使用或 CI/CD 环境。

​
macOS / Linux

在终端中临时设置（当前会话有效）： 
export ANTHROPIC_AUTH_TOKEN="sk-xxxxxxxxxxxx"
export ANTHROPIC_BASE_URL="https://toapis.com"
claude
永久配置，将以下内容添加到 ~/.bashrc 或 ~/.zshrc： 
export ANTHROPIC_AUTH_TOKEN="sk-xxxxxxxxxxxx"
export ANTHROPIC_BASE_URL="https://toapis.com"
然后执行： 
source ~/.zshrc  # 或 source ~/.bashrc

​
Windows

在 PowerShell 中临时设置： 
$env:ANTHROPIC_AUTH_TOKEN = "sk-xxxxxxxxxxxx"
$env:ANTHROPIC_BASE_URL = "https://toapis.com"
claude
永久配置（系统级）： 
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk-xxxxxxxxxxxx", "User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://toapis.com", "User")

​
方式三：使用 .env 文件

在您的项目根目录创建 .env 文件： 
ANTHROPIC_AUTH_TOKEN=sk-xxxxxxxxxxxx
ANTHROPIC_BASE_URL=https://toapis.com
注意： 请将 .env 添加到 .gitignore，避免泄露 API 密钥。

​
配置说明

配置项填写内容
ANTHROPIC_AUTH_TOKEN您的 ToAPIs API 密钥（sk-xxxxxxxxxxxx）
ANTHROPIC_BASE_URLhttps://toapis.com

​
验证配置

配置完成后，运行以下命令验证连接是否正常： 
claude --version
然后启动 Claude Code： 
claude
如果配置正确，Claude Code 将通过 ToAPIs 连接到 Claude 模型并正常响应。

​
推荐模型

通过 ToAPIs 您可以使用以下 Claude 模型：
模型名称模型 ID特点
Claude Opus 4.6claude-opus-4-6最强大，适合复杂任务
Claude Sonnet 4.6claude-sonnet-4-6性能与速度平衡，推荐日常使用
Claude Haiku 4.5claude-haiku-4-5-20251001快速响应，适合简单任务
切换模型可使用 /model 命令，或在启动时通过 --model 参数指定： 
claude --model claude-sonnet-4-6

​
常见问题

​
Q1: 出现 Authentication error 或 401 Unauthorized？

解决方案：
  1. 检查 ANTHROPIC_AUTH_TOKEN 是否正确设置，确认以 sk- 开头
  2. 在 ToAPIs 控制台 确认密钥未过期
  3. 确认账户余额充足

​
Q2: 出现 Connection refused 或无法连接？

解决方案：
  1. 确认 ANTHROPIC_BASE_URL 设置为 https://toapis.com
  2. 检查网络连接，确保能访问 https://toapis.com
  3. 如在国内，可能需要配置代理

​
Q3: 如何查看当前环境变量配置？

echo $ANTHROPIC_AUTH_TOKEN
echo $ANTHROPIC_BASE_URL

​
Q4: 常见错误码说明

错误信息原因解决方法
401 UnauthorizedAPI 密钥无效或过期重新获取 API 密钥
429 Too Many Requests请求频率超限稍等片刻后重试
500 Internal Server Error服务器临时故障等待几分钟后重试
insufficient_quota账户余额不足前往控制台充值

​
使用技巧

​
1. 在项目中快速启动

进入项目目录后直接运行 claude，Claude Code 会自动读取项目上下文： 
cd /your/project
claude

​
2. 常用命令

命令说明
/help查看帮助信息
/model切换模型
/clear清空当前对话
/exit 或 Ctrl+C退出 Claude Code

​
3. 与代码协作

Claude Code 能够读取和修改项目文件，常用场景：
  • 代码审查 - 让 Claude Code 审查您的代码并提出改进建议
  • 生成代码 - 描述需求，Claude Code 直接生成并写入文件
  • 调试错误 - 粘贴错误信息，获取调试建议
  • 重构代码 - 让 Claude Code 优化代码结构

​
支持与帮助

如果您在使用过程中遇到任何问题：
[## 开始使用 ToAPIs 立即注册 ToAPIs，获取您的 API 密钥，在 Claude Code 中开启高效编程之旅！](https://toapis.com)