Skip to content

Commit 097b081

Browse files
committed
docs(harnesses): copy polish on Lili's tweaks
- Fix broken `[H]` link in cloud Claude Code Related pages. - Fix "OpenA credential type" typo in authentication.mdx. - Clean up Anthropic Console URL (drop ?returnTo=/? query string). - Capitalize "OpenAI Platform" to match "Anthropic Console". - Restore --team in CLI examples so the follow-up sentence parses. - Drop word-repeat in harnesses index ("harness from the harness dropdown"). - Switch backtick `Cloud Agent` to bold (UI/tab name per style guide). - Reword dangling preposition in Codex available-models bullet. - Trim trailing whitespace and a double-blank line. Co-Authored-By: Oz <oz-agent@warp.dev>
1 parent f8813d9 commit 097b081

4 files changed

Lines changed: 11 additions & 12 deletions

File tree

src/content/docs/agent-platform/cloud-agents/harnesses/authentication.mdx

Lines changed: 6 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ sidebar:
99

1010
Third-party cloud agents — [Claude Code](#connecting-claude-code-credentials) and [Codex](#connecting-codex-credentials) — call their provider directly, so you need to store credentials as Warp-managed secrets before launching a run. This page walks through the one-time setup for each.
1111

12-
Auth secrets can be scoped to a **team** (available to all teammates' runs) or **personal** (only your own runs), just like normal Warp-managed secrets.
12+
Auth secrets can be scoped to a **team** (available to all teammates' runs) or **personal** (only your own runs), just like any other Warp-managed secret.
1313

1414
:::note
1515
[Bring Your Own Key (BYOK)](/support-and-community/plans-and-billing/bring-your-own-api-key/) configured in the Warp desktop app applies to local agent runs only. Cloud runs of Claude Code and Codex always use Warp-managed secrets.
@@ -21,7 +21,7 @@ Claude Code is Anthropic's coding agent. For more on Claude Code authentication,
2121

2222
### Create an Anthropic API key
2323

24-
1. Go to the [Anthropic Console](https://platform.claude.com/login?returnTo=/?) and sign in (or create an account).
24+
1. Go to the [Anthropic Console](https://console.anthropic.com/) and sign in (or create an account).
2525
2. Navigate to **API keys** and create a new key.
2626
3. Make sure your account has API credits — Claude Code runs are billed against your Anthropic API balance.
2727

@@ -40,7 +40,7 @@ Start a new run, choose **Claude Code** as the harness, and add a new key in the
4040
#### Oz CLI
4141

4242
```bash
43-
oz secret create claude api-key <KEY_NAME>
43+
oz secret create claude api-key --team <KEY_NAME>
4444
```
4545

4646
Add `--description "..."` to record rotation notes or owner info. Replace `--team` with `--personal` to make the secret available only to your own runs.
@@ -57,7 +57,7 @@ A ChatGPT subscription (Plus, Pro, Team) does not include API access. You need a
5757

5858
### Create an OpenAI API key
5959

60-
1. Go to the [OpenAI platform](https://platform.openai.com/home) and sign in (or create an account).
60+
1. Go to the [OpenAI Platform](https://platform.openai.com/) and sign in (or create an account).
6161
2. Navigate to **API keys** and click **Create new secret key**.
6262
3. Make sure your account has API credits — Codex runs are billed against your OpenAI API balance, not a ChatGPT subscription.
6363

@@ -74,13 +74,12 @@ Start a new run, choose **Codex** as the harness, and add a new key in the harne
7474
#### Oz CLI
7575

7676
```bash
77-
oz secret create codex api-key <KEY_NAME>
77+
oz secret create codex api-key --team <KEY_NAME>
7878
```
7979

80-
8180
Add `--description "..."` to record rotation notes or owner info. Replace `--team` with `--personal` to make the secret available only to your own runs.
8281

83-
**Expected outcome.** `oz secret list` shows the new secret with the matching OpenA credential type. The value is never displayed.
82+
**Expected outcome.** `oz secret list` shows the new secret with the matching OpenAI credential type. The value is never displayed.
8483

8584
## Managing harness auth secrets
8685

src/content/docs/agent-platform/cloud-agents/harnesses/claude-code.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -48,7 +48,7 @@ For setup steps, see [Connecting Claude Code credentials](/agent-platform/cloud-
4848

4949
## Related pages
5050

51-
* [H](/agent-platform/cloud-agents/harnesses/) — pick between Warp Agent, Claude Code, and Codex.
51+
* [Harnesses in Oz](/agent-platform/cloud-agents/harnesses/) — pick between Warp Agent, Claude Code, and Codex.
5252
* [Authentication](/agent-platform/cloud-agents/harnesses/authentication/) — store Anthropic credentials as Warp-managed secrets.
5353
* [Warp Agent with Oz](/agent-platform/cloud-agents/harnesses/warp-agent/) — Oz's default harness, the only one that can orchestrate Claude Code subagents.
5454
* [Codex with Oz](/agent-platform/cloud-agents/harnesses/codex/) — Codex as a cloud harness.

src/content/docs/agent-platform/cloud-agents/harnesses/codex.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -24,7 +24,7 @@ This page covers Codex as a **cloud** harness, dispatched and orchestrated by Oz
2424
The Codex harness exposes OpenAI's Codex-tuned and general coding models. Common picks:
2525

2626
* `default` - Lets Codex pick its own recommended model based on your OpenAI account access.
27-
* `gpt-5.5`, `gpt-5.4` - Recent strong coding models from OpenAI, which you can configure the reasoning level for.
27+
* `gpt-5.5`, `gpt-5.4` - Recent strong coding models from OpenAI with a configurable reasoning level.
2828
* `gpt-5.4-mini` - A faster, lower-cost option for lighter coding tasks or subagents.
2929

3030
For the full list — including older Codex-tuned and general models — open the model picker on the Oz web app's new-run pane. For details on each model, see [OpenAI's Codex model docs](https://developers.openai.com/codex/models).

src/content/docs/agent-platform/cloud-agents/harnesses/index.mdx

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -26,15 +26,15 @@ Claude Code and Codex call Anthropic or OpenAI directly using credentials you su
2626

2727
### Warp desktop app
2828

29-
In Cloud Mode, choose a harness from the harness dropdown above the input.
29+
In Cloud Mode, choose a harness from the **Agent harness** dropdown above the input.
3030

3131
:::note
32-
You can enter Cloud Mode by creating a new `Cloud Agent` tab or by using the `/cloud-agent` slash command.
32+
You can enter Cloud Mode by creating a new **Cloud Agent** tab or by using the `/cloud-agent` slash command.
3333
:::
3434

3535
### Oz web app
3636

37-
On the new run or new schedule pane, choose the harness in the **Harness** field.
37+
On the new run or new schedule pane, choose the harness in the **Harness** field.
3838

3939
### API and SDK
4040

0 commit comments

Comments
 (0)