跳转到主要内容
Claude Code 主界面

​
准备工作

Claude Code 是 Anthropic 推出的命令行 AI 编程助手，支持在终端中直接与 AI 对话、生成代码、调试问题等。 通过接入 APIMart，您可以在 Claude Code 中使用包括 GPT、Claude、Gemini 在内的多种模型。 在开始之前，请确保：
  1. 已获取 APIMart API 密钥 登录 APIMart 控制台 获取您的 API 密钥（以 sk- 开头）
提示： 如果还没有 APIMart 账户，请先在 APIMart 注册并获取 API 密钥。

​
第一步：安装 Claude Code

选择以下任一方式安装：
使用官方脚本一键安装：
curl -fsSL https://claude.ai/install.sh | bash
也可以通过 Homebrew 安装：
brew install --cask claude-code
如果遇到权限问题，请在命令前加 sudo。

​
验证安装

安装完成后，运行以下命令确认安装成功： 
claude --version
如果输出版本号（如 1.x.x），说明安装成功。

​
第二步：配置 APIMart API

以下提供三种配置方式，根据您的使用习惯任选其一。

​
方式一：编辑 settings.json（推荐）

这是最稳定的配置方式，配置一次即可长期生效。 1. 找到配置目录：
  • Windows：按 Win + R，输入 %userprofile%\.claude 打开
  • macOS：按 Command + Shift + G，输入 ~/.claude 打开
  • Linux：进入 ~/.claude 目录
如果目录不存在，先在终端运行一次 claude 再按 Ctrl + C 退出，会自动生成该目录。
2. 创建或编辑 settings.json 文件： 
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.apimart.ai",
    "ANTHROPIC_AUTH_TOKEN": "sk-xxxxxxxxxxxx",
    "ANTHROPIC_MODEL": "claude-sonnet-4-6-apimart",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}
参数说明
ANTHROPIC_BASE_URLAPIMart API 地址，固定为 https://api.apimart.ai
ANTHROPIC_AUTH_TOKEN您的 APIMart API 密钥（以 sk- 开头）
ANTHROPIC_MODEL默认使用的模型，可从下方模型列表中选择
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC设为 1 可减少非必要的网络请求
保存文件后，重新启动 Claude Code 即可生效。

​
方式二：永久环境变量

将配置写入系统环境，所有终端窗口都会自动加载。 
echo 'export ANTHROPIC_BASE_URL="https://api.apimart.ai"' >> ~/.zshrc
echo 'export ANTHROPIC_API_KEY="sk-xxxxxxxxxxxx"' >> ~/.zshrc
echo 'export ANTHROPIC_MODEL="claude-sonnet-4-6-apimart"' >> ~/.zshrc
source ~/.zshrc

​
方式三：临时环境变量

适合临时测试或短期使用，关闭终端后配置会失效。 
export ANTHROPIC_API_KEY="sk-xxxxxxxxxxxx"
export ANTHROPIC_MODEL="claude-sonnet-4-6-apimart"
export ANTHROPIC_BASE_URL="https://api.apimart.ai"
claude
临时环境变量仅在当前终端窗口有效，切换窗口或关闭终端后需重新设置。

​
第三步：开始使用

​
验证配置

启动 Claude Code 并发送一条简单消息来确认配置是否正确： 
claude "你好"
如果收到 AI 回复，说明配置成功。如果出现 401、403 等错误，请参考下方常见问题排查。

​
使用方式

Claude Code 提供两种交互模式：
  • 交互模式：运行 claude 进入持续对话，适合复杂任务
  • 单次命令：运行 claude "你的问题" 获取单次回复后退出，适合快速提问

​
支持的模型

APIMart 支持完整的 Claude 模型系列，您可以根据任务需求灵活切换：
模型名称特点推荐场景
claude-opus-4-6最强综合能力复杂架构、疑难调试
claude-sonnet-4-6性能与速度均衡日常编程、代码生成
claude-opus-4-5-20251101高级推理能力复杂代码、深度分析
claude-sonnet-4-5-20250929优秀的代码能力算法设计、代码优化
claude-haiku-4-5-20251001极速响应快速问答、代码片段
以上模型均支持 Thinking（扩展思考）版本，在模型 ID 后加 -thinking 即可启用，如 claude-opus-4-6-thinking。扩展思考模式适合需要深度推理的复杂任务。

​
APIMart 优惠模型

APIMart 提供专属优惠版模型，价格仅为官方的 20%，能力与官方模型一致。只需在模型 ID 后加 -apimart 后缀即可使用：
优惠模型名称特点
claude-opus-4-6-apimart最强综合能力
claude-sonnet-4-6-apimart性能与速度均衡
claude-opus-4-5-20251101-apimart高级推理能力
claude-sonnet-4-5-20250929-apimart优秀的代码能力
claude-haiku-4-5-20251001-apimart极速响应
claude-haiku-4-5-20251001-apimart极速响应
Thinking 版本同样支持，如 claude-opus-4-6-thinking-apimart、claude-sonnet-4-6-thinking-apimart 等。
模型选择建议： - 💰 高性价比： claude-sonnet-4-6-apimart — 日常编程的最佳选择，价格仅为官方 20% - 🚀 高性能： claude-opus-4-6-apimart — 处理最复杂的代码和架构问题
  • ⚡ 快速响应： claude-haiku-4-5-20251001-apimart — 需要即时反馈时使用 - 🧠 深度思考： claude-opus-4-6-thinking-apimart — 需要深度推理时使用
如需切换模型，可以在交互模式中使用 /model 命令，或修改配置中的 ANTHROPIC_MODEL 字段后重启。

​
常用命令

以下是 Claude Code 中常用的命令和快捷操作：
命令说明
claude进入交互模式
claude "问题"单次提问
claude --version查看版本号
/model在交互模式中切换模型
/help查看帮助信息
Ctrl + C退出交互模式

​
常见问题

​
Q1: 配置后仍然弹出登录选择页面？

启动后仍然显示 “Select login method” 说明配置未生效。 排查步骤：
  1. 使用 settings.json 方式：检查文件路径是否正确
    • Windows：C:\Users\<用户名>\.claude\settings.json
    • macOS / Linux：~/.claude/settings.json
  2. 使用环境变量方式：确认在设置变量的同一终端窗口中启动了 Claude Code
  3. 检查 JSON 格式：确保括号、逗号、引号都正确（不要使用中文引号）

​
Q2: 出现 401 / 403 错误？

错误码含义解决方案
401 UnauthorizedAPI 密钥缺失或无效检查密钥是否正确，是否以 sk- 开头
403 Forbidden权限不足或密钥过期前往 控制台 确认密钥状态
同时确保 ANTHROPIC_BASE_URL 设置为 https://api.apimart.ai，而非 Anthropic 官方地址。

​
Q3: 提示 “Unable to connect” 连接失败？

这说明 Claude Code 未能连接到 API 服务。
  1. 检查网络连接是否正常
  2. 确认 ANTHROPIC_BASE_URL 配置正确
  3. 如果使用了代理，确保代理设置允许访问 api.apimart.ai

​
Q4: 提示 “Auth conflict” 认证冲突？

如果启动时出现类似以下提示： 
Auth conflict: Both a token (claude.ai) and an API key (ANTHROPIC_API_KEY) are set.
说明您同时登录了 claude.ai 账号并设置了 API Key，两者产生了冲突。 解决方案： 在 Claude Code 交互模式中执行 /logout 登出 claude.ai 账号，只保留 API Key 配置即可。

​
Q5: 使用非 Claude 模型时报 max_tokens 错误？

如果看到类似以下错误： 
max_tokens is too large: 32000. This model supports at most 16384 completion tokens.
这是因为 Claude Code 默认按 Claude 模型的参数发送请求（32000 tokens），而部分非 Claude 模型（如 gpt-4o）的最大 token 限制较低。 解决方案： 切换为 Claude 系列模型（如 claude-sonnet-4-5-20250929），与 Claude Code 天然兼容，不会出现此问题。

​
Q6: 响应速度慢？

  1. 切换到更快的模型（如 claude-haiku-4-5-20251001 或 claude-sonnet-4-6）
  2. 缩短提问内容，减少上下文长度
  3. 检查本地网络状况

​
Q7: 如何切换模型？

两种方式：
  1. 交互模式中：输入 /model 命令即可切换
  2. 修改配置：更改 settings.json 或环境变量中的 ANTHROPIC_MODEL 字段，重启 Claude Code

​
Q8: Claude Code 会自动读取本地文件吗？

不会。Claude Code 需要您主动引用文件，且在执行敏感操作前会请求确认。建议在专用的项目目录中使用。

​
Q9: 如何让 Claude Code 分析本地文件？

在交互模式中，您可以通过以下方式引用文件：
  • 直接输入文件路径
  • 将文件拖入终端窗口
  • 复制粘贴文件内容

​
Q10: 如何查看使用情况和费用？

登录 APIMart 控制台 查看：
  • API 调用统计
  • Token 消耗明细
  • 费用统计与趋势

​
支持与帮助

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

开始使用 APIMart

立即注册 APIMart，获取您的 API 密钥，在 Claude Code 中体验多模型编程助手！