Skip to main content
Claude Code 是 Anthropic 推出的 AI 编程助手 CLI 工具，能够读取和修改项目文件、审查代码、生成代码并协助调试。通过将 即刻API 配置为后端，您可以在 Claude Code 中使用 Claude Opus、Claude Sonnet 等模型。

​
准备工作

在开始之前，请确保：
  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. 已获取 即刻API API 密钥 — 登录 即刻API 控制台 获取您的 API 密钥（以 sk- 开头）
如果还没有 即刻API 账户，请先在 即刻API 注册并获取 API 密钥。

​
配置方式

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

​
先确认 onboarding 已完成

在用户主目录下的 ~/.claude.json 中设置已完成引导（若文件不存在可创建）： 
{
  "hasCompletedOnboarding": true
}
该文件仅用于 CLI 状态位；API 密钥与 base URL 请写在下面的 settings.json 中。
在 ~/.claude/settings.json（全局）或项目根目录的 .claude/settings.json（项目级）中配置环境变量，无需修改 shell 配置文件：
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-xxxxxxxx",
    "ANTHROPIC_BASE_URL": "https://geekapis.com"
  }
}
全局配置（推荐，对所有项目生效）：
# 创建目录（如不存在）
mkdir -p ~/.claude
# 然后将上述 JSON 写入 ~/.claude/settings.json
项目级配置（仅对当前项目生效）：在项目根目录创建 .claude/settings.json。项目级文件中不要包含 API Key，建议只在全局配置中写 ANTHROPIC_AUTH_TOKEN，项目配置中只写 ANTHROPIC_BASE_URL：
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://geekapis.com"
  }
}
配置项填写内容
ANTHROPIC_AUTH_TOKEN您的 即刻API API 密钥（sk-xxxxxxxxxxxx）
ANTHROPIC_BASE_URLhttps://geekapis.com
hasCompletedOnboarding 放在 ~/.claude.json，env 放在 ~/.claude/settings.json 或 .claude/settings.json，不要混写到同一个文件中。

​
验证配置

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

​
推荐模型

通过 即刻API 您可以使用以下 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

​
使用技巧

​
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 优化代码结构

​
完整配置示例

~/.claude/settings.json 完整示例： 
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-xxxxxxxx",
    "ANTHROPIC_BASE_URL": "https://geekapis.com"
  }
}

​
常见问题

解决方案：
  1. 检查 ANTHROPIC_AUTH_TOKEN 是否正确设置，确认以 sk- 开头
  2. 在 即刻API 控制台 确认密钥未过期
  3. 确认账户余额充足
解决方案：
  1. 确认 ANTHROPIC_BASE_URL 设置为 https://geekapis.com
  2. 检查网络连接，确保能访问 https://geekapis.com
  3. 如在国内，可能需要配置代理
在终端中运行以下命令查看当前配置：
echo $ANTHROPIC_AUTH_TOKEN
echo $ANTHROPIC_BASE_URL
错误信息原因解决方法
401 UnauthorizedAPI 密钥无效或过期重新获取 API 密钥
429 Too Many Requests请求频率超限稍等片刻后重试
500 Internal Server Error服务器临时故障等待几分钟后重试
insufficient_quota账户余额不足前往控制台充值

​
支持与帮助

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