Claude Code CLI

Claude Code CLI 是 Anthropic 推出的终端 AI 编程助手，能读取代码库、编辑文件、运行命令。通过 iCreat，你可以在不使用 Anthropic 官方账号的情况下，将 claude 命令的请求路由到 iCreat API。

若使用 Claude Desktop 的 Code 图形界面，请参阅 Claude Code。

开始之前

已在 iCreat 创建 API Key（下文以 <sk-your-token> 占位）
网络可访问 https://api.icreat.ai
Node.js 18+（若使用 npm 安装）

安装

macOS / Linux / WSL

curl -fsSL https://claude.ai/install.sh | bash

或使用 npm：

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

Windows（PowerShell，管理员）

irm https://claude.ai/install.ps1 | iex
# 或
npm install -g @anthropic-ai/claude-code

验证安装：

claude --version

写入配置

CLI 通过 ~/.claude/settings.json（或 shell 环境变量）配置 iCreat 端点。

macOS / Linux — ~/.claude/settings.json：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.icreat.ai/v1/llm",
    "ANTHROPIC_AUTH_TOKEN": "<sk-your-token>",
    "CLAUDE_CODE_ATTRIBUTION_HEADER": "0"
  }
}

Windows — %USERPROFILE%\.claude\settings.json（内容相同）：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.icreat.ai/v1/llm",
    "ANTHROPIC_AUTH_TOKEN": "<sk-your-token>",
    "CLAUDE_CODE_ATTRIBUTION_HEADER": "0"
  }
}

Windows 用户

若 .claude 目录不存在，先在 CMD 或 PowerShell 中执行：

mkdir "%USERPROFILE%\.claude"

启动与验证

在项目目录启动：

cd your-project-folder
claude

首次启动可能依次提示：选择主题 → 确认安全提示 → 信任工作目录。

验证方式：

在对话中输入：使用你的默认模型回复「Claude Code 已成功连接到 iCreat！」
或运行 /status，确认 Anthropic base URL 为 https://api.icreat.ai/v1/llm，且 Auth token 显示 ANTHROPIC_AUTH_TOKEN 已生效

配置参数说明

变量	说明
`ANTHROPIC_BASE_URL`	iCreat API 地址：`https://api.icreat.ai/v1/llm`（Claude Code 会追加 `/v1/messages` 等路径）
`ANTHROPIC_AUTH_TOKEN`	iCreat API Key，以 Bearer Token 发送（第三方网关用此变量，而非 `ANTHROPIC_API_KEY`）
`CLAUDE_CODE_ATTRIBUTION_HEADER`	设为 `"0"` 禁用归因头（CLI 推荐）

与桌面版的区别

桌面版在 Gateway 界面填写 Gateway base URL 与 Gateway API key，等效于上述 ANTHROPIC_BASE_URL + ANTHROPIC_AUTH_TOKEN（Bearer 模式）。桌面版配置见 Claude Code。

可选：CC-Switch

若同时使用 Claude Code、Codex、Gemini CLI 等工具，可用 CC-Switch 图形化切换 iCreat 等供应商配置。详见 CC-Switch 配置。

常见问题

桌面版和 CLI 能否共用同一份配置？

部分设置（权限规则、MCP 等）会共享 ~/.claude/settings.json，但桌面版 API 路由必须在 Developer → Configure Third-Party Inference 中单独配置，不会自动读取 CLI 的 ANTHROPIC_BASE_URL。桌面版接入见 Claude Code。

提示需要登录或 401 无法连接？

确认 API Key 有效，且 Key 分组已包含所需模型
检查 ANTHROPIC_AUTH_TOKEN 拼写与 ~/.claude/settings.json 路径

Gateway was unreachable？

curl -I https://api.icreat.ai
# 应返回 HTTP 200