作为一个初学者的 Claude Code 配置踩坑记录

折腾了两天,踩了三个坑,在 AI 辅助下终于把 Claude Code 跑通了。这篇记录了我的完整配置过程和避坑方法,希望能帮到和我一样的初学者。

一、我为什么折腾这个

我是一名建筑室内设计专业的大专生,对电脑数码很感兴趣。最近在学习用 AI 辅助设计,听说 Claude Code 能让 AI 直接改代码、分析文件,就想试试。虽然全程有 AI 辅助,但中间也踩了不少坑,所以写篇文章记录一下,也希望能够帮到和我一样的人。

二、我的环境

  • Windows 10/11
  • 已安装 Node.js 和 Python
  • API 来源:DeepSeek 官方

三、踩坑记录与避坑方法

坑1:官方安装脚本报错

  • 现象:用官方的 irm ... | iex 命令安装,出现一堆看不懂的报错

  • 原因:国内网络环境导致下载到了错误的内容

  • 解决办法:改用 npm 安装 npm install -g @anthropic-ai/claude-code

坑2:启动后连不上 Anthropic 服务

  • 现象:安装成功,但运行 claude 后提示 ERR_BAD_REQUEST

  • 原因:需要配置第三方 API 中转

  • 解决办法:在 ~/.claude/settings.json 里配置 DeepSeek 的 API 信息

坑3:用 /v1 地址不兼容

  • 现象:模型报错"不存在或没有权限"

  • 原因:/v1 地址只兼容 OpenAI 协议,Claude Code 说的是 Anthropic 语言

  • 解决办法:把地址改成 https://api.deepseek.com/anthropic

四、我的最终配置文件

json 复制代码
{
  "env": {
      "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
      "ANTHROPIC_AUTH_TOKEN": "你的API-Key",
      "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-v4-pro",
      "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-v4-pro",
      "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v4-flash"
  }
}

|注意|:把你的API-Key 替换成你自己的,千万别把真实 Key 发出来!

五、总结与杂谈

大体看下来配置过程其实并不复杂(我在ai的辅助下),主要是地址要写对,之所以用DeepSeek主要有两点,第一价格很便宜,第二我是学生党嘛>嗯....怎么说呢,作为一个非计算机专业的学生,能在 AI 辅助下完成这件事,挺有成就感的,配了两天,在终于跑通的那一刻我才真正体会到ai的强大之处.之前我只是在对话框里对ai进行询问,让他帮我提资料修改的意见等等 后面呢我打算把我是如何在vscode里用claude插件以及用cc来切换其他模型api的实践过程也写篇文章记录下来

(本文同步自 CSDN,首次发布于一个初学者的 Claude Code 配置踩坑记录-CSDN博客


后记:作为初学者,这篇文章有很多不足之处,在后面的写作与实践中我会不断的去学习和改善,也望各位对我进行指导与批评,我写文章的最大出发点是记录,如果有幸能够帮到您,我会非常开心

相关推荐
stormzhangV11 小时前
这个本地模型,让我 token 自由了
人工智能·ai编程·claude
深念Y16 小时前
为什么选 MiniClaude:一个精简开源替代方案的选型过程
ai·开源·开源软件·agent·claude·workflow·claudecode
wulitoud1 天前
把 Claude、Codex、Gemini 的引擎换成本地模型:免费、离线、数据不出本机
人工智能·llama·claude·本地模型
小七-七牛开发者2 天前
dsh 拆解系列 Vol.01:没有特权内核的 Agent 运行时
ai·大模型·agent·claude·token·工作流·skill·claudecode·ai coding
Justin3go2 天前
DeepSeek Harness 对比 Claude Code:架构、插件、MCP
ai编程·claude·deepseek
可乐ea2 天前
Anthropic 的 CI/CD 值班智能体:Claude Tag 当一线响应者的架构拆解与踩坑复盘
ci/cd·架构·claude·devops·ai智能体·mcp
十八画生ovo2 天前
拆开 Claude Code 的源码后发现:它只是一个 while 循环
架构·ai编程·claude
小七-七牛开发者3 天前
Agent 小知识|Agent 环境工程:部分可观测性、状态转移与执行隔离
ai·大模型·agent·claude·token·工作流·skill·claudecode·ai coding