CodeAPICodeAPI
中文English
Claude Code Guide

Claude Code 接入教程

如果你已经在使用 Claude Code，通常不需要改变原有工作习惯。创建 API Key 后，将配置中的 Base URL 和密钥替换为对应值即可开始接入。

进入控制台 查看价格 返回接入总览
Prepare

接入前需要准备什么

准备项尽量少，避免把简单配置写成大而全的长手册。

你需要的内容

  • 一个可登录的 CodeAPI 控制台账号
  • 一个已创建的 API Key
  • 本地已安装 Claude Code

建议顺序

如果你还没有创建密钥，先进入控制台完成创建，再回来继续配置。这样可以避免先改本地文件、后面还要返工替换密钥。

Platform & Tools

支持平台与常见搭配工具

Claude Code 常见开发环境都能直接沿用这套配置。

支持平台

  • Windows：适合本地开发机与项目终端
  • macOS：适合日常开发环境和轻量移动办公
  • Linux：适合远程主机、云服务器和容器化终端

常见搭配工具

  • 终端：直接在项目目录运行 Claude Code
  • VS Code / JetBrains：在内置终端复用同一套配置
  • CC-Switch：适合需要图形界面切换提供方的场景

适合的工作流

更适合需要 Claude 系模型能力的编码、重构、项目问答和终端协作流程。只要客户端遵循 Claude 兼容配置，这套接入方式通常都能复用。

settings.json

推荐的配置方式：编辑 settings.json

对大多数用户来说，这是最直观也最稳定的方式。

配置片段

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.codeapi.work/",
    "ANTHROPIC_AUTH_TOKEN": "sk-your-token"
  }
}

常见路径

  • Windows：C:\Users\<用户名>\.claude\settings.json
  • macOS：/Users/<用户名>/.claude/settings.json
  • Linux：~/.claude/settings.json
Env

也可以通过环境变量配置

如果你更习惯在终端里管理配置，也可以直接设置环境变量。设置完成后，记得重新打开终端窗口。

PowerShell 示例

$env:ANTHROPIC_BASE_URL = "https://api.codeapi.work/"
$env:ANTHROPIC_AUTH_TOKEN = "sk-your-token"
Verify

如何判断配置已经生效

配置写完后不要直接假设成功，先做一次最短验证。

验证动作

重新打开 Claude Code，尝试发起一次简单调用。如果可以正常返回结果，通常说明配置已生效。

优先检查项

  • Base URL 是否正确
  • API Key 是否有效
  • 客户端是否完全重启
Troubleshoot

最常见的问题排查

先排查这几类高频问题，通常很快就能找到原因。

配置后没有生效

通常是旧终端会话或旧配置仍在生效。建议完全关闭客户端，确认没有其他环境变量覆盖当前设置后再重试。

提示 401 或 403

优先检查 API Key 是否失效、过期或复制错误，再确认控制台中的密钥状态是否正常。

提示 404

通常表示 Base URL 配置错误，请确认填写的是正确的接入地址，而不是其它兼容路径。

还在评估是否接入？

如果你还在评估价格和使用阶段，建议先查看价格页，确认是否符合当前预算和使用预期。