Claude Code / Claude Desktop 安装与配置

Anthropic 官方 CLI 工具和桌面图形版客户端都可以接入 I Code Easy API 网关。

推荐 MacOS 用户使用 iTerm2 终端,体验更佳。

第一步:安装 Claude Code

MacOS / Linux / WSL

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

Windows PowerShell

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

Windows CMD

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

原生安装会自动在后台更新,保持最新版本。

npm 安装(需先完成「环境准备」)

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

第二步:配置 API

Linux / MacOS 配置

添加到 ~/.bashrc~/.zshrc(默认推荐 kimi-k2.7):

export ANTHROPIC_AUTH_TOKEN="你的API Key"
export ANTHROPIC_BASE_URL="https://api.icodeeasy.cc"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1"
export CLAUDE_CODE_ATTRIBUTION_HEADER="0"

如果 api.icodeeasy.cc 连接慢,可以把 ANTHROPIC_BASE_URL 换成 https://jp.icodeeasy.cchttps://sg.icodeeasy.cc

保存后运行 source ~/.bashrcsource ~/.zshrc 使配置生效。

Windows 配置

在 PowerShell 中运行:

# 设置 API 密钥
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "你的API Key", "User")

# 设置 API 接入地址
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.icodeeasy.cc", "User")

# 禁用非必要流量
[Environment]::SetEnvironmentVariable("CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC", "1", "User")

# 禁用归因头
[Environment]::SetEnvironmentVariable("CLAUDE_CODE_ATTRIBUTION_HEADER", "0", "User")

如果 api.icodeeasy.cc 连接慢,可以把 ANTHROPIC_BASE_URL 换成 https://jp.icodeeasy.cchttps://sg.icodeeasy.cc

设置后需要重新打开 PowerShell 才能生效。

可以在新的 PowerShell 窗口中验证用户级环境变量:

[Environment]::GetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "User")
[Environment]::GetEnvironmentVariable("ANTHROPIC_BASE_URL", "User")
[Environment]::GetEnvironmentVariable("CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC", "User")
[Environment]::GetEnvironmentVariable("CLAUDE_CODE_ATTRIBUTION_HEADER", "User")

SetEnvironmentVariable 写入的是用户级持久环境变量,不会立即更新当前 PowerShell 会话。新开一个 PowerShell 窗口后再用 claude 启动。


第三步:启动 Claude Code

cd your-project-folder
claude

Claude Desktop 图形版配置

Claude 桌面端图形版可以通过开发者模式直接配置第三方 API 网关。

开启开发者模式

在菜单栏依次点击 Help -> Troubleshooting -> Enable Developer mode,然后重启 Claude Desktop。

配置 API 网关

重启后在菜单栏依次点击 Developer -> Configure third-party inference,按下面填写:

配置项填写内容
ConnectionGateway
Base URLhttps://api.icodeeasy.cc
API key你的 API Key

如果 api.icodeeasy.cc 连接慢,可以把 Base URL 换成 https://jp.icodeeasy.cchttps://sg.icodeeasy.cc

设定模型

在模型名称中填入要使用的模型,例如 claude-opus-5claude-sonnet-4-6kimi-k2.7glm-5.2 等,保存后重启 Claude Desktop。Claude 模型可使用 Claude 接入点。

如果要固定使用 Claude Fable 5,请参考 Claude Fable 5 使用指南