Claude Code 配置指南

准备工作

在开始之前，请确保：

1. 已安装 Claude Code

   通过 npm 或 pnpm 安装 Claude Code CLI：

   # npmnpm install -g @anthropic-ai/claude-code # pnpmpnpm install -g @anthropic-ai/claude-code

   或访问 Claude Code 官方文档 获取最新安装方式

2. 已获取 MaiToken API 密钥

   登录 MaiToken 控制台 获取您的 API 密钥（以 sk- 开头）

提示： 如果还没有 MaiToken 账户，请先在 MaiToken 注册并获取 API 密钥。

配置方式

Claude Code 支持多种方式配置自定义 API 端点，您可以将 MaiToken 作为 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://api.maitoken.com"  }}

全局配置（推荐，对所有项目生效）：

# 创建或编辑 ~/.claude/settings.jsonmkdir -p ~/.claude

然后将上述 JSON 写入 ~/.claude/settings.json。

项目级配置（仅对当前项目生效）：

在项目根目录创建 .claude/settings.json。项目级文件中不要包含 API Key，建议只在全局配置中写 ANTHROPIC_AUTH_TOKEN，项目配置中只写 ANTHROPIC_BASE_URL：

{  "env": {    "ANTHROPIC_BASE_URL": "https://api.maitoken.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://maitoken.com"claude

永久配置，将以下内容添加到 ~/.bashrc 或 ~/.zshrc：

export ANTHROPIC_AUTH_TOKEN="sk-xxxxxxxxxxxx"export ANTHROPIC_BASE_URL="https://maitoken.com"

然后执行：

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

Windows

在 PowerShell 中临时设置：

$env:ANTHROPIC_AUTH_TOKEN = "sk-xxxxxxxxxxxx"$env:ANTHROPIC_BASE_URL = "https://maitoken.com"claude

永久配置（系统级）：

[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk-xxxxxxxxxxxx", "User")[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://maitoken.com", "User")

方式三：使用 .env 文件

在您的项目根目录创建 .env 文件：

ANTHROPIC_AUTH_TOKEN=sk-xxxxxxxxxxxxANTHROPIC_BASE_URL=https://api.maitoken.com

注意： 请将 .env 添加到 .gitignore，避免泄露 API 密钥。

配置说明

验证配置

配置完成后，运行以下命令验证连接是否正常：

claude --version

然后启动 Claude Code：

claude

如果配置正确，Claude Code 将通过 MaiToken 连接到 Claude 模型并正常响应。

推荐模型

通过 MaiToken 您可以使用以下 Claude 模型：

切换模型可使用 /model 命令，或在启动时通过 --model 参数指定：

claude --model claude-sonnet-4-6

常见问题

Q1: 出现 Authentication error 或 401 Unauthorized？

解决方案：

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

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

解决方案：

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

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

echo $ANTHROPIC_AUTH_TOKENecho $ANTHROPIC_BASE_URL

Q4: 常见错误码说明

使用技巧

1. 在项目中快速启动

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

cd /your/projectclaude

2. 常用命令

3. 与代码协作

Claude Code 能够读取和修改项目文件，常用场景：

• 代码审查 - 让 Claude Code 审查您的代码并提出改进建议
• 生成代码 - 描述需求，Claude Code 直接生成并写入文件
• 调试错误 - 粘贴错误信息，获取调试建议
• 重构代码 - 让 Claude Code 优化代码结构

支持与帮助

如果您在使用过程中遇到任何问题：

• 📚 MaiToken 文档中心
• 📚 Claude Code 官方文档

开始使用 MaiToken — 立即注册 MaiToken，获取您的 API 密钥，在 Claude Code 中开启高效编程之旅！