One read of Claude Code CLIclaude-code-20260824T183701Z
4 pages moved out of 191 read.
Pages moved
4
significant first
Pages read
191
in this capture
Captured
18:37 UTC
Corpus hash
a9a45eabb8ec
corpus-hash
What this read moved
1-4 of 4agent-sdk/skills Changed · +6 / -2 lines
from line 342
342342## Pre-approve tools for skills
343343
344344<Note>
345 For project and personal skills, the `allowed-tools` frontmatter field applies only when you use the Claude Code CLI directly. In SDK sessions, manage tool approval for these skills through the `allowedTools` option (`allowed_tools` in Python) in your query configuration. Skills [synced from claude.ai](/docs/en/skills#how-claude-code-handles-the-frontmatter-of-a-synced-skill) follow their own frontmatter rules.
345 For project and personal skills, Claude Code applies the [`allowed-tools`](/docs/en/skills#pre-approve-tools-for-a-skill) frontmatter field in SDK sessions. You can also pre-approve tools for these skills through the `allowedTools` option (`allowed_tools` in Python) in your query configuration. Skills [synced from claude.ai](/docs/en/skills#how-claude-code-handles-the-frontmatter-of-a-synced-skill) follow their own frontmatter rules.
346346</Note>
347347
348348Skills run with the session's tools. The example below pre-approves `Read`, `Grep`, and `Glob` with `allowedTools` (`allowed_tools` in Python), so Claude can inspect files while running the [security-check skill](#create-and-dispatch-your-first-skill) without stopping for approval:
from line 483
483483 ```
484484
485485 An empty name reports `Skill names must be non-empty strings.`
486
487 Before TypeScript Agent SDK 0.3.221, the SDK didn't run this check.
486488 </Tab>
487489
488490 <Tab title="Python">
from line 495
493495 ```
494496
495497 An empty name reports `Skill names must be non-empty strings`.
498
499 Before Python Agent SDK 0.2.129, the SDK didn't run this check.
496500 </Tab>
497501</Tabs>
498502
from line 506
502506
503507## Next steps
504508
505The [Claude Code skills guide](/docs/en/skills) covers authoring in depth. Its guidance applies to SDK sessions, with one exception: for project and personal skills, [Pre-approve tools for skills](#pre-approve-tools-for-skills) replaces the `allowed-tools` frontmatter field with the `allowedTools` option. Start with these sections:
509The [Claude Code skills guide](/docs/en/skills) covers authoring in depth. Its guidance applies to SDK sessions. Start with these sections:
506510
507511* [Frontmatter reference](/docs/en/skills#frontmatter-reference): every supported field
508512* [Pass arguments to skills](/docs/en/skills#pass-arguments-to-skills): `$ARGUMENTS`, `$0`, `$1`, and skill stacking. The [full substitution table](/docs/en/skills#available-string-substitutions) adds named arguments and the `${CLAUDE_*}` variables
quickstart Changed · +6 / -6 lines
from line 25
2525 <Tab title="Native Install (Recommended)">
2626 **macOS, Linux, WSL:**
2727
28 ```bash theme={null}
28 ```bash theme={null} theme={null} theme={null} theme={null} theme={null}
2929 curl -fsSL https://claude.ai/install.sh | bash
3030 ```
3131
3232 **Windows PowerShell:**
3333
34 ```powershell theme={null}
34 ```powershell theme={null} theme={null} theme={null} theme={null} theme={null}
3535 irm https://claude.ai/install.ps1 | iex
3636 ```
3737
3838 **Windows CMD:**
3939
40 ```batch theme={null}
40 ```batch theme={null} theme={null} theme={null} theme={null} theme={null}
4141 curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
4242 ```
4343
from line 53
5353 </Tab>
5454
5555 <Tab title="Homebrew">
56 ```bash theme={null}
56 ```bash theme={null} theme={null} theme={null} theme={null} theme={null}
5757 brew install --cask claude-code
5858 ```
5959
from line 65
6565 </Tab>
6666
6767 <Tab title="WinGet">
68 ```powershell theme={null}
68 ```powershell theme={null} theme={null} theme={null} theme={null} theme={null}
6969 winget install Anthropic.ClaudeCode
7070 ```
7171
from line 267
267267| Command | What it does | Example |
268268| ------------------- | ------------------------------------------------------ | ----------------------------------- |
269269| `claude` | Start interactive mode | `claude` |
270| `claude "task"` | Run a one-time task | `claude "fix the build error"` |
270| `claude "task"` | Start interactive mode with an initial prompt | `claude "fix the build error"` |
271271| `claude -p "query"` | Run one-off query, then exit | `claude -p "explain this function"` |
272272| `claude -c` | Continue most recent conversation in current directory | `claude -c` |
273273| `claude -r` | Resume a previous conversation | `claude -r` |
errors Changed · +1 / -1 lines
This page is larger than the 256 KiB this site keeps, so one side of the diff below stops where the stored text does.
from line 1138
11381138
11391139```text theme={null}
11401140Unable to connect to API: SSL certificate verification failed. Check your proxy or corporate SSL certificates
1141Unable to connect to API: Self-signed certificate detected
1141Unable to connect to API: Self-signed certificate detected. Check your proxy or corporate SSL certificates
11421142```
11431143
11441144As of v2.1.199, a certificate validation failure isn't retried, so this error appears on the first attempt instead of after the full [retry budget](#automatic-retries). Earlier versions spent a few minutes retrying before showing it. Transient TLS conditions, such as a handshake timeout, still retry.
from line 2542
25422542Claude Code enforces the 200K limit on its own for every model it recognizes as having a native 1M window, and for model IDs it doesn't recognize it compacts at the window it assumes. The warning appears when other configuration defeats that enforcement:
25432543
25442544* The model ID isn't one Claude Code recognizes, such as an [LLM gateway](/docs/en/llm-gateway) alias, and you set [`CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT=1`](/docs/en/env-vars) or raised the assumed window past 200K with [`CLAUDE_CODE_MAX_CONTEXT_TOKENS`](/docs/en/env-vars). In this case the message also offers `or update to a Claude Code version that recognizes <model>` as a remedy.
2545* A `context-1m` beta requested through [`ANTHROPIC_BETAS`](/docs/en/env-vars) or the [`--betas`](/docs/en/cli-reference#cli-flags) flag still asks the API for the 1M window on a model that accepts that beta, whi
2545* A `context-1m` beta requested through [`ANTHROPIC_BETAS`](/docs/en/env-vars) or the [`--betas`](/docs/en/cli-reference#cli-flags) flag still asks the API for the
permission-modes Changed · +1 / -1 lines
from line 296
296296
297297If Claude Code reports auto mode as unavailable, one of these requirements is unmet; this is not a transient outage. A separate message that names a model and says auto mode "cannot determine the safety" of an action means a classifier request failed; that failure is usually transient, but on Amazon Bedrock it can repeat until your account can invoke the named model. See the [error reference](/docs/en/errors#auto-mode-cannot-determine-the-safety-of-an-action) for the causes and what to do.
298298
299If you set `defaultMode: "auto"` in [settings](/docs/en/settings-reference#all-settings) and a terminal session starts in Manual mode with no error, the setting is likely in `.claude/settings.json` or `.claude/settings.local.json`. In Claude Code v2.1.142 and later, `auto` doesn't take effect from those files. Move it to `~/.claude/settings.json`. For a conversation the VS Code extension started, check the extension's own list in [Switch permission modes](#switch-permission-modes) instead.
299If you set `defaultMode: "auto"` in [settings](/docs/en/settings-reference#all-settings) and a terminal session starts in Manual mode with no error, the setting is likely in `.claude/settings.json` or `.claude/settings.local.json`. `auto` doesn't take effect from those files. Move it to `~/.claude/settings.json`. For a conversation the VS Code extension started, check the extension's own list in [Switch permission modes](#switch-permission-modes) instead.
300300
301301<h3 id="enable-auto-mode-on-bedrock-agent-platform-or-foundry">
302302 Auto mode on Bedrock, Agent Platform, or Foundry