Claude Code

Claude Code 是 Anthropic 官方推出的 AI 编程助手，能读取代码库、编辑文件、运行命令，并与 Git、MCP 等开发工具集成。通过 iCreat，你可以在不使用 Anthropic 官方账号的情况下，将桌面版 Code 标签页的请求路由到 iCreat API。

若要在终端使用 claude 命令，请参阅 Claude Code CLI。

产品能力

• 读写代码 — 理解项目结构，跨文件修改、补全测试、修复 lint
• 执行命令 — 在本地终端运行构建、测试、Git 等命令
• 工具集成 — 通过 MCP 连接 Jira、Slack、Google Drive 等外部系统
• 多会话协作 — 并行任务、计划模式、可视化 diff 审查

开始之前

• 已在 iCreat 创建 API Key（下文以 <sk-your-token> 占位）
• 网络可访问 https://api.icreat.ai

安装 Claude Desktop

从 claude.com/download 下载并安装（macOS / Windows / Linux beta）。启动后登录 Anthropic 账号以打开应用；接入 iCreat 后，Code 标签页的推理请求将走 iCreat 网关。

打开 Code 标签页

点击应用顶部中央的 Code 标签页。Windows 首次使用需安装 Git for Windows 后重启应用。

启用开发者模式

1. 菜单栏选择 Help → Troubleshooting → Enable Developer Mode
2. 应用重启后，顶部出现 Developer 菜单

注意

若组织已通过 MDM 下发网关配置，本地配置项可能为只读，请以管理员提供的配置为准。

配置 Gateway

桌面应用通过 第三方推理网关（Gateway） 配置 API 地址，不会读取 CLI 配置文件中的 ANTHROPIC_BASE_URL，需在应用内单独设置。

1. 打开 Developer → Configure Third-Party Inference…
2. 在 Connection 区域填写：

3. 保存并重启 Claude Desktop

验证连接

1. 在 Code 标签页新建 Local 会话
2. 发送测试消息，例如：请回复「Claude Code 桌面版已成功连接到 iCreat！」
3. 在 iCreat 控制台「使用日志」中确认有对应调用记录

桌面版限制

• 启用 Gateway 后，Remote Control、SSH 远程会话、Anthropic 托管云会话不可用；远程开发请改用 Claude Code CLI
• 本地环境变量可在输入框 Local → 齿轮图标 中设置，与 Gateway 路由相互独立
• MCP 配置位于 claude_desktop_config.json，与 Code 标签页 Gateway 配置无关

配置说明

在 Gateway 界面填写的 Gateway base URL 与 Gateway API key，等效于 CLI 中的 ANTHROPIC_BASE_URL + ANTHROPIC_AUTH_TOKEN（Bearer 模式）。CLI 侧变量说明见 Claude Code CLI。

可选：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。CLI 接入方式见 Claude Code CLI。

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

• 确认 API Key 有效，且 Key 分组已包含所需模型
• 确认 Gateway auth scheme 为 Bearer，Base URL 为 https://api.icreat.ai/v1/llm

Gateway was unreachable？

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