最近更新：2025年11月27日 03:19

Claude Code CLI 完整配置指南

API Key 获取与保存

打开 https://www.i-coding.shop/console/token，进入 令牌管理。
点击 添加令牌，打开创建弹窗。
在弹窗中填写名称、分组（可选），设置过期时间、额度、可用模型等信息。若希望长期使用，可直接选择「永不过期」。
点击提交后系统会生成一组令牌。请 立即复制 并保存到密码管理器中。
该令牌即 ANTHROPIC_API_KEY，可以随时在列表页删除或重新生成。

建议将生成的 Key 保存在 1Password / Bitwarden，并用标签区分环境，避免误用。

环境变量与 Base URL

Base URL：https://www.i-coding.shop

必填环境变量：

ANTHROPIC_API_KEY=<你的令牌>
ANTHROPIC_BASE_URL=https://www.i-coding.shop

可选：ANTHROPIC_API_TIMEOUT（秒）、ANTHROPIC_MAX_TOKENS 等 CLI 原生变量，可按需设置。

CLI 会优先读取环境变量；如果需要在项目内覆盖，可在 ./.claude/settings.json 中写 baseUrl 与 env。

配置方式如何选择？
推荐使用 cc-switch 一键配置；若无法安装 GUI 可使用环境变量方案；需要项目级覆盖再编辑 settings.json。三种方式只需选择其一。

使用 cc-switch 配置

cc-switch（https://github.com/farion1231/cc-switch/releases），顶部 Claude | Codex | MCP，右上角 添加供应商。

安装：在 Releases 下载最新版 — Windows 选 .msi（或 Portable.zip 免安装）；macOS 选 .zip 或 .tar.gz；Linux 选 .AppImage（或 .deb，需赋权运行）。
添加 Claude Code 供应商（与截图一致的新 UI）：
- 右上角 添加供应商，顶部选择 Claude。
- 配置类型：默认 自定义，可选 Claude Official / DeepSeek / Zhipu GLM / Qwen Coder / Kimi k2 / ModelScope / KAT-Coder / Longcat / PackyCode。
- 供应商名称：必填，示例 “i-Coding Gateway”。
- 官网地址：可选。
- API Key：必填，粘贴 https://www.i-coding.shop/console/token 生成的密钥。
- 请求地址：https://www.i-coding.shop。
- 主模型/快速模型：可选，占位 GLM-4.6 / GLM-4.5-Air，留空用默认。
- Claude Code 配置 (JSON)：确认自动生成：
```
{ "env": { "ANTHROPIC_BASE_URL": "https://www.i-coding.shop", "ANTHROPIC_AUTH_TOKEN": "<你的密钥>" } }
```
启用与管理：点击添加返回列表，在卡片上“启用/编辑/删除”；需要 Codex/MCP 时切换顶部标签。

用 cc-switch 写入后，可跳过手工改 .zshrc 或 settings.json。

macOS/Linux 配置流程

Linux 用户可完全套用以下命令，若使用 bash 仅需替换终端配置文件。

安装 Claude Code

方式一：原生脚本（推荐）

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

方式二：Homebrew 安装

brew install --cask claude-code

方式三：npm 全局安装（需要 Node.js 18+）

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

验证安装

claude --version

配置 API Key 与 Base URL

若已通过 cc-switch 配置，可跳过本节。

临时设置（当前终端有效）

# zsh 或 bash
env | grep ANTHROPIC || true
export ANTHROPIC_API_KEY="你的令牌"
export ANTHROPIC_BASE_URL="https://www.i-coding.shop"
claude

关闭终端后变量会消失，适合快速调试。

永久设置（根据 shell 二选一）

先执行 echo $SHELL 判断当前 shell：
/bin/zsh → 编辑 ~/.zshrc；/bin/bash → 编辑 ~/.bash_profile；其他 shell 请写入对应 rc 文件。

zsh

nano ~/.zshrc
# 在文件末尾添加
export ANTHROPIC_API_KEY="你的令牌"
export ANTHROPIC_BASE_URL="https://www.i-coding.shop"
source ~/.zshrc

bash

echo "export ANTHROPIC_API_KEY='你的令牌'" >> ~/.bash_profile
echo "export ANTHROPIC_BASE_URL='https://www.i-coding.shop'" >> ~/.bash_profile
source ~/.bash_profile

验证与诊断

claude --version          # 版本信息
claude                    # 启动 CLI
/status                   # 在 CLI 中检查认证状态

预期输出 包含已登录邮箱、认证方式（API Key）、当前模型和配额统计。

Windows 配置流程

安装 Claude Code

方式一：PowerShell 一键脚本（推荐）

irm https://claude.ai/install.ps1 | iex

方式二：npm 全局安装（需 Node.js 18+）

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

验证安装

claude --version

配置 API Key 与 Base URL

若已使用 cc-switch 写入配置，可跳过本节。PowerShell 与 CMD 命令二选一。

临时设置

$env:ANTHROPIC_API_KEY="你的令牌"
$env:ANTHROPIC_BASE_URL="https://www.i-coding.shop"
claude

set ANTHROPIC_API_KEY=你的令牌
set ANTHROPIC_BASE_URL=https://www.i-coding.shop
claude

永久设置（系统环境变量）

Win + R → 输入 sysdm.cpl → Enter。
点击 “环境变量” → 在 “用户变量” 中选择 “新建”。
新建 ANTHROPIC_API_KEY（填令牌）与 ANTHROPIC_BASE_URL（填 https://www.i-coding.shop）。
保存后关闭所有终端，重新打开 PowerShell/CMD。
运行 echo %ANTHROPIC_API_KEY% 或 $env:ANTHROPIC_API_KEY 确认。

PowerShell 脚本方式

[Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "你的令牌", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://www.i-coding.shop", "User")
$env:ANTHROPIC_API_KEY
$env:ANTHROPIC_BASE_URL

验证与诊断

claude --version
claude
/status

若输出包含 Authenticated 与模型信息，即表明安装与认证成功。

常用命令

claude --version      # 查看版本
claude doctor         # 诊断安装和配置
claude update         # 更新到最新版本
claude                # 启动交互式界面
claude "prompt"       # 直接执行一次性请求
/help                 # 查看内置帮助
/status               # 查看认证状态
/models               # 列出可用模型
/settings             # 显示当前设置
/clear                # 清除上下文
/reset                # 重置会话
/exit                 # 退出程序

配置文件详解

配置文件位置

macOS/Linux：~/.claude/settings.json
Windows：%USERPROFILE%\.claude\settings.json
项目级覆盖：在项目根目录创建 ./.claude/settings.json

配置示例

{
  "model": "claude-sonnet-4-5-20250929",
  "baseUrl": "https://www.i-coding.shop",
  "env": {
    "ANTHROPIC_API_KEY": "<可选，留空则读取环境变量>"
  },
  "permissions": {
    "allow": ["Bash(npm run lint)", "Read(~/.zshrc)"],
    "deny": ["Read(.env)", "Bash(curl:*)"]
  },
  "customApiKeyResponses": {
    "approved": ["最后20个字符"],
    "rejected": []
  }
}

字段说明

字段	作用
`model`	指定默认模型版本
`baseUrl`	i-Coding API 地址
`env`	明确写入需要传递给 CLI 的环境变量
`permissions.*`	控制 Claude Code 可执行/访问的命令与文件
`customApiKeyResponses`	记录已批准的 API Key 尾段，便于审计

优先级：项目级配置 > 全局配置 > 环境变量 > 默认值。

常见问题

Key 创建后找不到复制入口？: 创建弹窗关闭后无法再查看完整 Key；请删除旧令牌重新生成并立即复制。

API Key 泄露怎么办？: 立即登录 i-Coding 控制台删除泄露令牌并重新生成，同时轮换所有环境变量与配置文件。

如何确认当前认证方式？: 在 CLI 中执行 /status，检查是否命中 API Key、当前模型与配额。

API Key 设置后仍提示登录？: 排查顺序：1）echo $ANTHROPIC_API_KEY 是否有值；2）ANTHROPIC_BASE_URL 是否为 https://www.i-coding.shop；3）令牌是否过期或被删除；4）重启终端后重试。

已经用 cc-switch 配置，还需要修改 .zshrc 或 settings.json 吗？: 不需要。cc-switch 会写入勾选的目标位置并备份旧配置；除非想手动调整特定项目，否则保持现状即可。

Claude Code CLI 完整配置指南

目录

API Key 获取与保存

环境变量与 Base URL

使用 cc-switch 配置

macOS/Linux 配置流程

安装 Claude Code

配置 API Key 与 Base URL

临时设置（当前终端有效）

永久设置（根据 shell 二选一）

验证与诊断

Windows 配置流程

安装 Claude Code

配置 API Key 与 Base URL

临时设置

永久设置（系统环境变量）

验证与诊断

常用命令

配置文件详解

配置文件位置

配置示例

常见问题